What data does Domain Search return?

Each request returns: all known email addresses for the domain, each with full name, job title, department, seniority, country, LinkedIn URL, phone number, confidence score, verification status, email pattern, source URLs, and timestamps. Company data includes industry, size, location, social profiles, and technology stack.

What filtering options are available?

You can filter by department (executive, marketing, HR, IT, sales, engineering, finance, etc.), seniority level (senior, junior, executive), email type (personal or generic), country code, and verification status.

Are phone numbers included?

Yes. When available, phone numbers are returned for each employee including the number type (mobile, landline, toll-free), country, and formatting. Phone data is included at no extra credit cost for domain search results.

How does pagination work?

Results are paginated with up to 10 emails per request. Use the page parameter to navigate. The meta object includes total count and pagination details. 1 credit = 1 page of up to 10 results.

What is the rate limit?

Limits are per plan and per endpoint, in requests a second / a minute / a day: Free 1 / 2 / 5, Basic 3 / 50 / 500, Growth 5 / 80 / 1,000, Pro 8 / 150 / 4,000. Pro Plus and Scale have no limit, and Enterprise allows 100,000 requests a day with no per-second limit. Every response carries rate-limit headers; see Rate limits . For large lists, use Bulk Domain Search : up to 25,000 domains per job.

How are sources tracked?

Each email includes a sources array with URLs where it was found, extraction dates, last seen dates, and whether the email is still visible. This helps verify data freshness and reliability.

Does it return company social profiles?

Yes. The response includes LinkedIn company page, Twitter handle, Facebook page, and other social profiles when available, along with the company description and industry classification.

Can I filter by country?

Yes. Pass a two-letter country code (e.g., US, FR, DE) as a query parameter to get only employees located in that country. This was added in our June 2025 update.

// get /v1/domain-search

Domain Search API

Find all email addresses, phone numbers, company details, and employee profiles associated with any company domain. Filter by department, seniority, country, and more.

Get free API key API reference

1 search credit per 10 results

// api console

ExampleExample response from the API reference

Zapier

Information Services · 251-1K · San Francisco

automation that moves everyone forward. zapier is on a mission to make automation work for everyone. with zapier, you can integrate apps like salesforce, intuit, google, and dropbox, to move data between them automatically, so you can focus on your most important work. we’re 100% remote with teammates spanning 40 countries around the world. we’re hiring! try for free today: http://ow.ly/lvav50k0kqn

Founded: 2011
Company type: privately held
Revenue: $10M-$50M
Location: San Francisco, California, US
Catch-all domain: Yes
Phone available: Yes
Similar companies: 21
Domain registered: 2011

business web applicationsintegrationsmaking magicapis

681 addresses at this domain

simon.charette@zapier.com
Simon Charette · product engineer
99valid
kaveh@zapier.com
Kaveh M · Head of Customer Acquisition
52
emily.harris@zapier.com
Emily Harris · Software Engineer
99valid
cortney.hickey@zapier.com
Cortney Hickey · Executive Business Partner to the CEO
51
aleks.ozolins@zapier.com
Aleks Ozolins
99valid

// 01 · request

Domain Search is one HTTPS request

Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.

GET/domain-search

domainpiedpiper.com: Company domain (or send company)
limit10: Results per page, from 1 to 5,000 (at most 10 on the Free plan)
departmentengineering: Filter by team
countryUS: Filter by country

GET /domain-search

curl -G https://api.tomba.io/v1/domain-search \
  --data-urlencode "domain=piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const params = new URLSearchParams({
  domain: "piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/domain-search?${params}`, {
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
  }
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.tomba.io/v1/domain-search",
    params={
        "domain": "piedpiper.com",
    },
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// 02 · response

What comes back

JSON, the same in every language. Fields Tomba doesn't know are null, never guessed.

GET/domain-search

data.organizationobject: Company name, location, social links, industry, size, revenue, description, pattern
data.organization.accept_allboolean: The domain accepts mail for any address (catch-all)
data.emails[].emailstring: Each address found
data.emails[].full_name, data.emails[].position, data.emails[].departmentstring | null: Name, job title and team
data.emails[].senioritystring | null: junior, senior or executive
data.emails[].scoreinteger: Confidence from 0 to 100
data.emails[].verification.statusstring | null: valid, accept_all, invalid or unknown, with verification.date
data.emails[].sources[]array: Where each address was found
meta.total, meta.total_pagesinteger: Addresses that match, and pages at this pageSize
meta.current, meta.pageSizeinteger: This page and its size
meta.paramsobject: The parameters the search ran with

GET /domain-search

200 OK· 1 search credit per 10 results

{
  "data": {
    "organization": {
      "website_url": "piedpiper.com",
      "organization": "Pied Piper",
      "location": {
        "country": "US",
        "city": "Palo Alto",
        "state": "CA",
        "street_address": "5230 Newell Road",
        "postal_code": "94303"
      },
      "social_links": {
        "twitter_url": null,
        "facebook_url": null,
        "instagram_url": null,
        "linkedin_url": "https://www.linkedin.com/company/pied-piper",
        "github_url": null,
        "youtube_url": null,
        "pinterest_url": null,
        "tiktok_url": null
      },
      "disposable": false,
      "webmail": false,
      "phone_number": false,
      "industries": "computer software",
      "founded": "2014",
      "company_size": "11-50",
      "company_type": "privately held",
      "revenue": null,
      "accept_all": false,
      "description": "Middle-out compression for files and video.",
      "pattern": "{first}",
      "total_similar": 2,
      "keywords": [
        "compression",
        "middle-out",
        "decentralized internet"
      ],
      "ranking": null,
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "last_updated": "2025-01-15T10:32:00+01:00"
    },
    "emails": [
      {
        "email": "dinesh@piedpiper.com",
        "first_name": "Dinesh",
        "last_name": "Chugtai",
        "full_name": "Dinesh Chugtai",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Software Engineer",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 99,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "sources": [
          {
            "uri": "https://piedpiper.com/blog/engineering",
            "website_url": "piedpiper.com",
            "extracted_on": "2024-06-01T09:14:07+01:00",
            "last_seen_on": "2025-01-10T17:02:44+01:00",
            "still_on_page": true
          }
        ]
      },
      {
        "email": "gilfoyle@piedpiper.com",
        "first_name": "Bertram",
        "last_name": "Gilfoyle",
        "full_name": "Bertram Gilfoyle",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Systems Architect",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 97,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "sources": [
          {
            "uri": "https://piedpiper.com/blog/engineering",
            "website_url": "piedpiper.com",
            "extracted_on": "2024-06-01T09:14:07+01:00",
            "last_seen_on": "2025-01-10T17:02:44+01:00",
            "still_on_page": true
          }
        ]
      }
    ]
  },
  "meta": {
    "total": 12,
    "pageSize": 10,
    "current": 1,
    "total_pages": 2,
    "params": {
      "domain": "piedpiper.com",
      "company": "",
      "page": 1,
      "limit": 10,
      "department": "engineering",
      "country": null,
      "type": "all",
      "live": false,
      "enrich_mobile": false,
      "webhook_url": null
    }
  }
}

// 03 · cost and limits

What a call costs

A call is charged only under the condition below. Rate limits depend on your plan.

// cost

1 per 10search credit

Charged when: At least one address is returned. 1 credit per 10 results requested with limit.

Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.

How credits work

// rate limits

Requests per second / minute / day

	Free	Basic	Growth	Pro
Search, finder, similar, technology	1 / 2 / 5	3 / 50 / 500	5 / 80 / 1,000	8 / 150 / 4,000
Email verifier	1 / 2 / 10	2 / 40 / 500	3 / 60 / 1,000	5 / 100 / 4,000

Scroll sideways for every column

Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Rate limits

// faq