API Reference

Email Addresses

Extract email addresses from a web page with optional CSS selector narrowing. Each result reports the address as written on the page, whether its syntax is valid, its normalized and ASCII forms, and whether DNS says the domain accepts mail.

Use this to collect the email addresses a page shows. Each one comes back as written on the page, with a syntax check, its normalized and ASCII forms, and a DNS check on whether the domain accepts mail. Useful for contact discovery and lead enrichment.

1 credit per request. Add render_js=true for pages that build their content with JavaScript (+4 credits).

Quick example

curl -G "https://api.webscraperapi.ai/v1/email_addresses" \
  -H "Authorization: Bearer $WEBSCRAPERAPI_API_KEY" \
  --data-urlencode "url=https://example.com/contact" \
  --data-urlencode "output=json"

is_email_address_deliverable is null when the DNS lookup does not settle the question. It checks the domain only. To check a single mailbox, use Verify Email Address.

Full API reference

GET
/v1/email_addresses

Query Parameters

url*string

The URL to extract email addresses from.

Formaturi
Length1 <= length <= 2083
css_selector?|

Optional CSS selector to narrow content.

render_js?|

Whether to render JavaScript.

Defaultfalse
output?|

Output format. Falls back to Accept header when not provided.

timeout_ms?|

Request timeout in milliseconds.

Response Body

application/json

application/json

curl -X GET "https://api.webscraperapi.ai/v1/email_addresses?url=http%3A%2F%2Fexample.com"
null
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}