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!