Documentation & Guides

Find detailed instructions, tips, and official info on how to use every Octolin feature. For questions, visit our FAQs.

About

Welcome to the official documentation for Octolin — the all-in-one LinkedIn data scraper and automation toolkit. Octolin enables recruiters, analysts, and business owners to extract and organize LinkedIn jobs efficiently, leads, and company data — all while navigating LinkedIn's blocking defenses, adhering to plan limits, and maintaining a smooth workflow with an intuitive interface.

Introduction

Octolin is a Windows-based LinkedIn job, company & lead scraper, distributed as a zip folder (octolin.exe file and relevant folders). It automates every step: logging in, scraping job and company data, collecting leads, handling anti-bot systems, and saving everything to Excel-ready CSV files.

Key Features

  • Log in with cookies or encrypted auto-login (save your credentials securely)
  • Scrape LinkedIn job listings & details
  • Collect company data and 'About' info from company profiles
  • Extract leads: emails and phone numbers when available
  • Save all data to CSV (ready for Excel)
  • Manual login via browser + auto-save cookies
  • Pause/Resume scraping anytime
  • Sound notification on completion
  • Automatic login after the session logout pop-up
  • Automatic data autosave (with error prevention)
  • Scrape without login (for public listings)
  • Batch-based plan enforcement (quota per batch, live batch counter)
  • Transparent batch usage: see total and remaining right in the app
  • Randomized scrolling (distance and delay) for stealth
  • Settings for custom XPaths (both listing and detail)
  • Clear built-in instructions and simple GUI
  • Anti-blocking: proxies, user agent rotation, cache clearing
  • Persistent browser profile (udc_profile/) for session stability
  • All settings/config are GUI-editable

Data Scraping - What Data Can Octolin Collect?

Octolin captures detailed LinkedIn job and company data — perfect for recruiters, analysts, and data-driven professionals. Future versions may include even more fields.

Job Listing Data

  • Job Title
  • Company Name
  • Company Logo URL
  • Job URL
  • Company Page URL
  • Job Location
  • Job Posting Age (e.g., “1 day ago”)
  • Job Description (plain text and formatted)
  • Salary/Pay (if available)
  • Employment Type (Full-time, Part-time, etc.)
  • Seniority Level
  • Job Function and Industry
  • Work Mode (Hybrid, Remote, On-site)
  • Recruiter Name and Page (if public)
  • Apply Link (direct or extracted)
  • Job ID

Company/Organization Data

  • About Company (summary section)
  • Company Size
  • Phone and Contact Information
  • Headquarters Location
  • Industry
  • Website
  • Year Founded
  • Specialties

Lead Data

  • Recruiter or Contact Email (if visible)
  • Contact Phone Number (if available)

"All extracted data is saved in clean, import-ready CSV files compatible with Excel and Google Sheets."

Getting Started

  • Download the latest Octolin.exe from your vendor or octolin.com.
  • Extract the zip.
  • Allow the app to run if blocked by Windows security or antivirus programs.
  • Double-click Octolin.exe — no installation required.
  • Activate your license or start in Demo mode.

Installation

Download & Run:

   - Windows 10 or later (64-bit recommended).

   - Download and run Octolin.exe (portable zip or installer version, both available).

   - For zip, extract to any writable folder.

   - Chrome browser (latest) must be installed.

First Launch:

   - Double-click Octolin.exe — the GUI opens instantly.

   - All config/profile files (config.json, udc_profile/) are auto-created.

Updating:

   - Replace the old Octolin.exe with the new version. Your settings and license persist in the config.

Licensing and Plans

Octolin uses license-based plans, enforced server-side (secure, tamper-resistant). Batch and record limits are live-synced and always visible.

See updated prices at https://octolin.com/pricing

  • Demo mode: No license needed. Limit: 10 jobs/batch
  • Batch and quota usage is shown live in the About/Status area. Batch counter resets monthly (or with the billing cycle).
  • Release license option lets you transfer to another device with one click.

Scraping with Octolin

- Creating UDC Profile (One-Time Setup)

  • Click Settings — Enter LinkedIn Email & Password and Save Settings.
  • Click Login to Save Cookies — Chrome browser will open to complete the auto login process. You may also enter credentials manually here if you prefer.
  • Once logged in successfully, the browser window will close.

 

- Listing & Detail Scraping

  • Visit the LinkedIn website and search for your desired job keyword, apply filters, and copy the main page URL
  • Click Listing Scraper — Inside Octolin, paste your LinkedIn job search URLs into the input page of Listing Scraper.
  • Click Start — Octolin extracts job URLs up to your plan’s batch quota.
  • Each batch is counted only when a new group is scraped. Unused quota does not roll over.
  • Data is saved to a uniquely named CSV (e.g., Linkedin-Jobs-Listing (1).csv).
  • Click Detail Scraper - Inside Octolin, Upload/paste this scarped data file containing job URLs to extract full details (job description, recruiter info, contact, etc.).
  • Quota and batch limits apply to detail scraping (as per your plan/demo).
  • Data auto-saves to the same/fresh CSV.

 

- Batch Limits

  • Server-enforced for security.
  • Monthly batch limit: scraping is paused when exhausted, and auto-resumes on the next cycle.

 

- Demo Mode

  • No license required.
  • Scrape up to 10 jobs per batch.
  • App UI switches to "Limited Mode" (yellow badge) in demo/quota-exceeded mode.

Anti-Blocking & Stealth Features

Octolin’s advanced anti-blocking and automation stack keeps you scraping, even under LinkedIn’s defenses:

 

  • Login with Cookies: Save/load LinkedIn session via browser cookies for frictionless login.
  • Encrypted Passwords: Store your LinkedIn password (optionally) in encrypted form for one-click auto-login.
  • Manual & Auto Login: Use browser for manual login or enable credential-based automation.
  • Auto login on logout popup: Regain session automatically when LinkedIn logs you out.
  • Proxy Support & Rotation:
  • io proxy integration for automatic rotation
  • PAC file support
  • User-Agent Rotation:
  • Use a pool of browser user agents (rotated randomly)
  • JS spoofing for maximum stealth
  • Periodic Cache Cleaning:
  • Automatic browser cache and cookie clearing between jobs (threaded)
  • Keeps LinkedIn tracking at bay
  • Scrolling Stealth:
  • Randomized delays and scroll distances to mimic real user activity
  • GUI-linked config saving: Change all XPaths, delays, proxies, and settings from the GUI — no file editing required
  • Persistent Profiles: All Chrome/LinkedIn session data is stored in udc_profile/ for stable, resume-able scraping
  • Auto-save data: Autosave runs in a background thread (safe: never crashes if file is closed)
  • Sound Notification: Audio alerts on scrape complete
  • Pause/Resume: Safely pause or resume scraping jobs
  • Lead Collection: Automatically extracts emails/phones from job and recruiter fields when available

Troubleshooting & Error Handling

  • Quota/Limit Warnings:
  • Yellow badge/“quota reached” means wait until next batch, or upgrade your plan.

 

  • Login Issues:
  • Use “Login and Save Cookies” in the GUI, or set credentials for auto-login.
  • Check proxy/anti-block settings if login fails or stalls.

 

  • Server Not Reachable:
  • Ensure firewall/AV allows Octolin, and internet connection is stable.

 

  • Browser Won’t Start:
  • Confirm Chrome is installed and updated.
  • Undetected_chromedriver must match your Chrome version.
  • If browser is left open from previous batch run, close it manually.

 

  • Clear Log Prints:
  • All debug log prints can be toggled off for production/clean output.

Support & Contact

For additional help or to request new features, email:

Support: support@octolin.com

Sales: sales@octolin.com

Feedback & Feature Requests: support@octolin.com

Thank you for choosing Octolin — LinkedIn scraping made simple, secure, and powerful!