Lead Enrichment Tool API

Match a list of contacts against the B2B database and append email, phone, title, and company data. Match keys (priority order): email, social profile URL, mobile, company domain. Returns the highest-seniority person at a domain when matching by domain alone. Requires $649/mo plan.

Included with $649/mo planGET /api/v1/enrich

Database APIs are included with the $649/mo plan.

Parameters

Name	Type	Required	Description
`rows`	object[]	Required	Array of input rows. Each row needs at least one of: email, social, mobile, domain. Up to 1,000 rows per request.Example: [{"email":"[email protected]"},{"domain":"tesla.com"},{"social":"<profile_url>"}]
`preview`	boolean	Optional	If true, returns match count + sample without counting toward your daily allowance.Default: falseExample: false

Examples

Enrich a list of email addresses

curl -X POST "https://app.scrapercity.com/api/v1/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"email":"[email protected]"},{"email":"[email protected]"}]}'

Enrich a mixed list (email + domain + social)

curl -X POST "https://app.scrapercity.com/api/v1/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"email":"[email protected]"},{"domain":"tesla.com"},{"social":"<profile_url>"}]}'

Preview match count without consuming daily allowance

curl -X POST "https://app.scrapercity.com/api/v1/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"email":"[email protected]"}],"preview":true}'

Use Cases

•Enrich incoming leads in real time as they sign up
•Append firmographic data to a CRM export before importing
•Find decision-makers at a list of target companies (domain match)
•Reverse-look-up phone numbers or social profile URLs to get full profiles

Best Practices

•Provide multiple match keys per row when you have them - email + social gives the best chance of a hit
•Use preview mode (preview: true) to estimate match rate before processing large lists
•Rate limit: 1,000 rows per request, 100,000 matches per day
•Daily limit resets at midnight UTC
•Domain-only rows return the highest-seniority person at that company (CEO > C-suite > VP > Director > else)
•Mobile match is country-code-agnostic - we compare on the last 10 digits
•Requires $649/mo plan

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.

Lead Enrichment Tool API API Documentation