# 🔍 Leads Finder (apollo alternative) with Emails Extract up to 30K leads per run with 80% email rate The Scraper is designed to automatically **start from your last scraped page**, ensuring clean, non-redundant data every time. Use our Filter builder to generate your filters https://leadlance.io/filterbuilder
## 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 `30k` 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 Use our Filter builder to generate your filters https://leadlance.io/filterbuilder Purpose: Starts a new Apollo scraping task and **returns the runId** #### Request Body: ``` Javascript { "filters": { "personTitle": [ "CEO" ], "seniority": [ "CEO", "Chairman", "Founder", "President" ], "companyEmployeeSize": [ "0 - 1", "2 - 10", "11 - 50", "5001 - 10000", "51 - 200", "201 - 500", "501 - 1000", "1001 - 5000" ], "personCountry": [ "United States" ], "revenue": [ "< 1M", "1M-10M", "11M-100M", "101M-500M", "501M-1B", "1B+" ] } "totalResults": 30000 } ``` #### Response: ``` Javascript { runId: "userId1234567890", status: "started", message: "🟢 Scraping has commenced. Takes 5 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 | | ----------- | ----------- | ----------- | ----------- | ----------- | | `filters` | string | Your search filters | - | true | | `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` | 50K Leads | | `ULTRA` | 120K Leads | | `MEGA` | 600k leads | - **Timeout**: It takes `5`mins to pull 1k leads.
### Sample Input ```Javascript { "filters": { "personTitle": [ "CEO" ], "seniority": [ "CEO", "Chairman", "Founder", "President" ], "companyEmployeeSize": [ "0 - 1", "2 - 10", "11 - 50", "5001 - 10000", "51 - 200", "201 - 500", "501 - 1000", "1001 - 5000" ], "personCountry": [ "United States" ], "revenue": [ "< 1M", "1M-10M", "11M-100M", "101M-500M", "501M-1B", "1B+" ] }, "totalResults": 30000 } ```
## 📌 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)*