Lead Database API
Query the B2B lead database via API. Access millions of contacts with emails, phone numbers, titles, and company data. Requires $649/mo plan.
Included with $649/mo plan
GET /api/v1/database/leadsDatabase APIs are included with the $649/mo plan.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | number | Optional | Page number (default: 1)Default: 1Example: 1 |
limit | number | Optional | Results per page (max: 100)Default: 50Example: 100 |
title | string | Optional | Filter by job title (partial match)Example: CTO |
industry | string[] | Optional | Filter by industry (multiple allowed)Example: Technology |
country | string[] | Optional | Filter by full country name, e.g. "United States" (multiple allowed)Example: United States |
state | string[] | Optional | Filter by state (multiple allowed)Example: California |
city | string | Optional | Filter by city (partial match)Example: San Francisco |
companyName | string | Optional | Filter by company name (partial match)Example: Google |
companyDomain | string | Optional | Filter by company domain (partial match)Example: google.com |
companySize | string[] | Optional | Filter by company size rangeExample: 51-200 |
seniority | string[] | Optional | Filter by seniority levelExample: VP |
department | string[] | Optional | Filter by departmentExample: Engineering |
hasEmail | boolean | Optional | Only return leads with email addressesDefault: falseExample: true |
hasPhone | boolean | Optional | Only return leads with phone numbersDefault: falseExample: true |
minEmployees | number | Optional | Minimum company employee countExample: 50 |
maxEmployees | number | Optional | Maximum company employee countExample: 500 |
socialUrl | string | Optional | Match by social profile URLExample: x.com/username |
Examples
Search for CTOs in California tech companies
curl "https://app.scrapercity.com/api/v1/database/leads?title=CTO&country=United%20States&state=California&industry=Technology&hasEmail=true&limit=100" \ -H "Authorization: Bearer YOUR_API_KEY"
Get leads from a specific company
curl "https://app.scrapercity.com/api/v1/database/leads?companyDomain=google.com&limit=50" \ -H "Authorization: Bearer YOUR_API_KEY"
Paginate through VP-level leads
curl "https://app.scrapercity.com/api/v1/database/leads?seniority=VP&hasEmail=true&page=2&limit=100" \ -H "Authorization: Bearer YOUR_API_KEY"
Use Cases
- •Build targeted outreach lists programmatically
- •Enrich your CRM with B2B contact data
- •Power cold email campaigns at scale
- •Feed leads into your sales automation pipeline
Best Practices
- •Use filters to narrow results - avoid pulling the entire database
- •Rate limit: 100 leads per request, 100,000 leads per day
- •Paginate with page and limit parameters for large result sets
- •Combine filters for more targeted results (e.g. title + industry + location)
- •Requires $649/mo plan - upgrade at /dashboard/billing
- •Daily limit resets at midnight UTC
Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.
Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.