ScraperCity logo

Email Finder API Documentation

Email Finder

Find verified work email addresses from a person's name and company domain. Every email found is automatically validated for deliverability.

$0.05 per email found (FREE if not found)POST /api/v1/scrape/email-finder

Parameters

NameTypeRequiredDescription
contactsobject[]RequiredArray of contact objects to look upExample: [{"first_name": "John", "last_name": "Doe", "domain": "company.com"}]
contacts[].first_namestringOptionalPerson's first name (required if full_name not provided)Example: John
contacts[].last_namestringOptionalPerson's last nameExample: Doe
contacts[].full_namestringOptionalFull name (alternative to first_name + last_name)Example: John Doe
contacts[].domainstringOptionalCompany domain (preferred over company_name)Example: company.com
contacts[].company_namestringOptionalCompany name (use if domain not available)Example: Acme Corp

Examples

Find a single email

curl -X POST https://app.scrapercity.com/api/v1/scrape/email-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {"first_name": "John", "last_name": "Doe", "domain": "company.com"}
    ]
  }'

Bulk email lookup

curl -X POST https://app.scrapercity.com/api/v1/scrape/email-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {"first_name": "John", "last_name": "Doe", "domain": "stripe.com"},
      {"first_name": "Jane", "last_name": "Smith", "domain": "shopify.com"},
      {"full_name": "Bob Johnson", "company_name": "Acme Corp"}
    ]
  }'

Check status

curl -X GET https://app.scrapercity.com/api/v1/scrape/status/{runId} \
  -H "Authorization: Bearer YOUR_API_KEY"

Use Cases

  • Find decision-maker emails for sales outreach
  • Enrich partial lead records with verified work emails
  • Build contact lists for ABM campaigns
  • Reach passive candidates with verified work emails

Best Practices

  • Use domain over company_name for more accurate results
  • Each contact needs at least a name (first_name or full_name) AND a company (domain or company_name)
  • You only pay for found emails - no-result lookups are free
  • Found emails are automatically validated for deliverability
  • CSV upload supported in the dashboard for bulk lookups
  • Download results within 48 hours before expiration

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.