// get /v1/domain-search
Domeinzoeken API
Vind alle e-mailadressen, telefoonnummers, bedrijfsgegevens en werknemersprofielen die aan een bedrijfsdomein zijn gekoppeld. Filter op afdeling, senioriteit, land en meer.
1 search credit per 10 results
// api-console
VoorbeeldVoorbeeldantwoord uit de API-naslag
- organization.organization
- Pied Piper
- organization.industries
- computer software
- organization.company_size
- 11-50
- organization.pattern
- {first}
- organization.accept_all
- false
- emails
- 2 items
- emails[0].email
- dinesh@piedpiper.com
- emails[0].position
- Software Engineer
- emails[0].verification.status
- valid
// 01 · verzoek
Domain Search is één HTTPS-verzoek
Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.
GET
/domain-searchdomainpiedpiper.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
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 · antwoord
Wat je terugkrijgt
JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.
GET
/domain-searchdata.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 · kosten en limieten
Wat een aanroep kost
Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.
// kosten
1 per 10search credit
In rekening gebracht als: At least one address is returned. 1 credit per 10 results requested with limit.
Fouten, 429- en 451-antwoorden en hetzelfde verzoek opnieuw binnen je gebruiksvenster kosten niets.
Hoe credits werken// rate limits
Verzoeken per seconde / minuut / dag| 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 opzij voor alle kolommen
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
Elk verzoek retourneert: alle bekende e-mailadressen voor het domein, elk met volledige naam, functietitel, afdeling, senioriteit, land, LinkedIn URL, telefoonnummer, betrouwbaarheidsscore, verificatiestatus, e-mailpatroon, bron-URL's en tijdstempels. Bedrijfsgegevens omvatten branche, grootte, locatie, sociale profielen en technologiestack.
U kunt filteren op afdeling (directie, marketing, HR, IT, verkoop, engineering, financien, enz.), senioriteitsniveau (senior, junior, directie), e-mailtype (persoonlijk of generiek), landcode en verificatiestatus.
Ja. Indien beschikbaar worden telefoonnummers voor elke werknemer geretourneerd, inclusief nummertype (mobiel, vast, gratis), land en opmaak. Telefoongegevens zijn zonder extra credits inbegrepen bij domeinzoekresultaten.
Resultaten zijn gepagineerd met maximaal 10 e-mails per verzoek. Gebruik de page-parameter om te navigeren. Het meta-object bevat het totale aantal en pagineringsdetails. 1 credit = 1 pagina met maximaal 10 resultaten.
Limieten gelden per abonnement en per endpoint, in verzoeken per seconde / minuut / dag: Free 1 / 2 / 5, Basic 3 / 50 / 500, Growth 5 / 80 / 1.000, Pro 8 / 150 / 4.000. Pro Plus en Scale hebben geen limiet, en Enterprise staat 100.000 verzoeken per dag toe zonder limiet per seconde. Elk antwoord bevat rate-limit-headers; zie Rate limits. Gebruik voor grote lijsten Bulk Domain Search: tot 25.000 domeinen per taak.
Elke e-mail bevat een bronnen-array met URL's waar deze is gevonden, extractiedata, laatst gezien data en of de e-mail nog zichtbaar is. Dit helpt bij het verifieren van de versheid en betrouwbaarheid van de gegevens.
Ja. Het antwoord bevat LinkedIn-bedrijfspagina, Twitter-account, Facebook-pagina en andere sociale profielen indien beschikbaar, samen met de bedrijfsbeschrijving en brancheclassificatie.
Ja. Geef een tweeletterige landcode op (bijv. NL, BE, DE) als queryparameter om alleen werknemers in dat land te vinden. Dit is toegevoegd in onze update van juni 2025.