// get /v1/domain-search
Domain-Suche API
Finden Sie alle E-Mail-Adressen, Telefonnummern, Firmendetails und Mitarbeiterprofile, die mit einer Unternehmens-Domain verknüpft sind. Filtern nach Abteilung, Seniorität, Land und mehr.
1 search credit per 10 results
// api-konsole
BeispielBeispielantwort aus der API-Referenz
- 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 · anfrage
Domain Search ist eine HTTPS-Anfrage
Senden Sie die Parameter mit Ihrem Schlüssel und Secret. Jedes SDK, die CLI und der MCP-Server stellen genau diesen Aufruf.
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 · antwort
Was zurückkommt
JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.
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 und limits
Was ein Aufruf kostet
Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.
// kosten
1 per 10search credit
Berechnet, wenn: At least one address is returned. 1 credit per 10 results requested with limit.
Fehler, 429- und 451-Antworten sowie dieselbe Anfrage erneut innerhalb Ihres Nutzungsfensters kosten nichts.
So funktionieren Credits// rate limits
Anfragen pro Sekunde / Minute / Tag| 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 |
Seitlich scrollen, um alle Spalten zu sehen
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
Jede Anfrage gibt zurück: alle bekannten E-Mail-Adressen für die Domain, jeweils mit vollständigem Namen, Jobtitel, Abteilung, Seniorität, Land, LinkedIn-URL, Telefonnummer, Konfidenzwert, Verifizierungsstatus, E-Mail-Muster, Quell-URLs und Zeitstempel. Firmendaten umfassen Branche, Größe, Standort, soziale Profile und Technologie-Stack.
Sie können nach Abteilung (Geschäftsleitung, Marketing, HR, IT, Vertrieb, Technik, Finanzen usw.), Senioritätsstufe (Senior, Junior, Führungsebene), E-Mail-Typ (persönlich oder generisch), Ländercode und Verifizierungsstatus filtern.
Ja. Wenn verfügbar, werden Telefonnummern für jeden Mitarbeiter zurückgegeben, einschließlich Nummerntyp (Mobil, Festnetz, gebührenfrei), Land und Formatierung. Telefondaten sind ohne zusätzliche Credit-Kosten in den Domain-Suchergebnissen enthalten.
Ergebnisse werden mit bis zu 10 E-Mails pro Anfrage paginiert. Verwenden Sie den Seitenparameter zur Navigation. Das Meta-Objekt enthält Gesamtanzahl und Paginierungsdetails. 1 Credit = 1 Seite mit bis zu 10 Ergebnissen.
Die Limits gelten pro Tarif und pro Endpunkt, in Anfragen pro Sekunde / Minute / Tag: Free 1 / 2 / 5, Basic 3 / 50 / 500, Growth 5 / 80 / 1.000, Pro 8 / 150 / 4.000. Pro Plus und Scale haben kein Limit, und Enterprise erlaubt 100.000 Anfragen pro Tag ohne Limit pro Sekunde. Jede Antwort enthält Rate-Limit-Header; siehe Rate-Limits. Für große Listen nutzen Sie die Massen-Domain-Suche: bis zu 25.000 Domains pro Job.
Jede E-Mail enthält ein Quellen-Array mit URLs, Extraktionsdaten, Zuletzt-gesehen-Daten und ob die E-Mail noch sichtbar ist. Dies hilft, die Datenfrische und Zuverlässigkeit zu überprüfen.
Ja. Die Antwort enthält die LinkedIn-Unternehmensseite, den Twitter-Handle, die Facebook-Seite und andere soziale Profile, wenn verfügbar, zusammen mit der Unternehmensbeschreibung und Branchenklassifizierung.
Ja. Übergeben Sie einen zweistelligen Ländercode (z.B. US, FR, DE) als Abfrageparameter, um nur Mitarbeiter in diesem Land zu erhalten. Dies wurde in unserem Update vom Juni 2025 hinzugefügt.