ScraperCity logo

Email Validator API Documentation

Email Validator

Verify email addresses for validity, deliverability, and quality scoring with company enrichment data

$0.0036 per emailPOST /api/v1/scrape/email-validator

Parameters

NameTypeRequiredDescription
emailsstring[]RequiredArray of email addresses to validateExample: ["[email protected]", "[email protected]"]

Examples

Validate single email

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

# Response
{
  "runId": "abc123-...",
  "message": "Email validation started for 1 emails",
  "emailCount": 1,
  "estimatedCost": 0.0036
}

Bulk email validation

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

Check validation status

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

# Response
{
  "status": "RUNNING",
  "statusMessage": "Validating emails...",
  "handled": 50,
  "requested": 100,
  "runTimeSecs": null,
  "outputUrl": null
}

Download results when complete

curl -X GET https://app.scrapercity.com/api/downloads/{runId} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.csv

Use Cases

  • Clean email lists before marketing campaigns
  • Verify collected leads from other scrapers
  • Reduce bounce rates in email outreach
  • Validate user registrations and sign-ups
  • Check email deliverability and catch-all detection
  • Identify disposable and temporary email addresses
  • Get company enrichment data (industry, size, location)

Best Practices

  • Automatically deduplicates emails
  • Returns validation status: valid, invalid, catch-all, unknown
  • Includes MX record validation and provider detection
  • CSV includes company enrichment: industry, size, founded, location
  • Also includes company social links: LinkedIn, Facebook, Twitter
  • Can process emails from any source or scraper output
  • Validates inline from Apollo runs via "Validate Emails" button
  • Processing time: ~1-2 seconds per email

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.