# 🔍 Lead Scraper [Apollo] (with Emails) - WORKS NOW Extract up to 15K leads per run with one URL with high-volume email scraping The Scraper is designed to automatically **start from your last scraped page**, ensuring clean, non-redundant data every time. Get cookies using EditThisCookie Extension
## Usage Flow: - **POST /start** → Starts scraping and returns runId - **GET /status/runId** → check scraping progress - **GET /download/runId** → Download all leads scraped in **JSON format** - **POST /cancel/runId** → Abort a particular run
## 📈 Performance - Up to `15k` leads including email per run - 🔥 Scraper tracks your progress across all runs and **starts from last scraped page**, skipping leads already fetched.
## 🚀 HOW TO START THE SCRAPER #### Endpoint 1: /start Purpose: Starts a new Apollo scraping task and **returns the runId** #### Request Body: ``` Javascript { "url": "https://...", "cookies": []. "totalResults": 20000, "includeEmails": true } ``` #### Response: ``` Javascript { runId: "userId1234567890", status: "started", message: "🟢 Scraping has commenced. Takes 20-25 mins to extract 1k leads" } ``` #### Endpoint 2: /status/runId Purpose: Check the status and progress of a run. Replace the runId with the actual runId generated from the first endpoint e.g **/status/userId1234567890** #### Response: ``` Javascript { runId: "userId1234567890", status: "running", downloadUrl: null, data: { collectedSoFar: 221, totalDuplicates: 0 } } ``` #### Endpoint 3: /download/runId Purpose: Instant download of the scraped leads in **CSV** format. Replace the runId with the actual runId generated from the first endpoint e.g **/download/userId1234567890** #### Response: ```Javascript { "id": "5fbec894239a5f0001e8e8d5", "first_name": "Navdeep", "last_name": "Bains", "name": "Navdeep Bains", "linkedin_url": "http://www.linkedin.com/in/navdeepbains", "title": "Chief Corporate Affairs Officer", "email_status": "verified", ... } ``` #### Endpoint 4: /cancel/runId Purpose: Abort a run in progress. Replace the runId with the actual runId generated from the first endpoint e.g **/cancel/userId1234567890**
## 👀 Progress Tracking By default, the Scraper automatically keeps track of your progress **for each URL you provide**. So, if you give it the same URL again or resurrect run, it **doesn’t start all over from first page**, instead, it picks up right where you left off and continues scraping from the last page it reached. This behavior remains consistent, even if you're running the Scraper multiple times. The progress tracking is stored for 30 days, after which it resets automatically.
## ⚙️ Configuration ### Input Parameters | Parameter | Type | Description | Default | Required | | ----------- | ----------- | ----------- | ----------- | ----------- | | `url` | string | Your search URL to extract leads from | - | true | | `cookies` | array | Get cookies using EditThisCookie extension | true | false | | `includeEmails` | array | Enrich your leads with verified email (no credits required) | true | false | | `totalResults` | integer | Total number of leads to extract | 10000 | false |
## Run Policy: **Trial Limit**: Free trial users can extract up to `100` leads including email within the trial period. **Rental Limit**: | Plan | Limit | | ----------- | ----------- | | `BASIC` | 100 Leads | | `PRO` | 30K Leads | | `ULTRA` | 55K Leads | | `MEGA` | 200k leads | - **Timeout**: It takes `5`mins to pull 1k leads.
### Sample Input ```Javascript { "url": "https://...", "cookies": [{...}, {...}], "totalResults": 10000, "includeEmails": true } ```
## 📌 Best Practices - Use responsibly and in compliance with platform terms of service. - Scraper limits scraping to 15k per run
## ⚠️ Disclaimer While the Scraper does its best to retrieve email addresses for each lead, some leads may not include an email due to data availability.
## 🤝 Support Need help? Message us directly or open a discussion. > We Available to create custom scrapers tailored to your needs. Contact us today --- *Made with ❤️ by Peaky Dev (Anonymous minds in the shadows of code)*