Skip to content
Scrappa Get API key
Contacts API 1 credit/request

Email Search API Documentation

GET https://scrappa.co/api/contacts/emails

Searches the web once for addresses on one email domain and returns the ones that appear in result titles and snippets, each with its source URL. Only published addresses are returned. Nothing is guessed and no mailbox is tested. Yield is low: a result page holds few addresses, often none. Use page 1 to 10 to read deeper result pages. Cost: 1 credit per request. A search that returns no page is free.

Email Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/contacts/emails
Auth header
x-api-key
Cost
1 credit/request
email_domain = example.com
Response preview
200 OK
{
    "meta": {
        "credits": 1,
        "duration_ms": 1700,
        "upstream_calls": 1,
        "results_checked": 10
    },
    "page": 1,
    "query": "contact",
    "emails": [
        {
            "title": "Contact | Example",
            "value": "info@example.com",
            "snippet": "Write to info@example.com for questions.",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

3 optional filters available.

email_domain string Required

Domain of the addresses, for example example.com.

Example value example.com
query string Optional

Optional extra words, for example sales or a person name.

Example value contact
limit integer Optional

Most emails to return, 1 to 100. Defaults to 50.

Example value 10
page integer Optional

Search result page, 1 to 10. Defaults to 1. Page 2 reads the next 10 results.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

meta page query emails success email_domain

Common emails fields

title value snippet source_url
JSON Response
200 OK
{
    "meta": {
        "credits": 1,
        "duration_ms": 1700,
        "upstream_calls": 1,
        "results_checked": 10
    },
    "page": 1,
    "query": "contact",
    "emails": [
        {
            "title": "Contact | Example",
            "value": "info@example.com",
            "snippet": "Write to info@example.com for questions.",
            "source_url": "https://example.com/contact"
        }
    ],
    "success": true,
    "email_domain": "example.com"
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

Validation Error

Returned when a required parameter is missing or a value is out of range. No credits are charged.

Service Unavailable

Returned when no page could be fetched or the search returned no results. Failed requests are not charged. Try again.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.