ScraperCity logo

Email Validator API Documentation

Email Validator

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

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

Parameters

NameTypeRequiredDescription
emailsstring[]RequiredArray of email addresses to validateExample: ["test@example.com", "info@company.com"]

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": ["test@example.com"]
  }'

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

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": [
      "john@example.com",
      "jane@company.com",
      "info@business.org",
      "support@website.com"
    ]
  }'

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.