Quelles données la Recherche de Domaine retourne-t-elle ?

Chaque requête retourne : toutes les adresses email connues pour le domaine, chacune avec le nom complet, le titre de poste, le département, l'ancienneté, le pays, l'URL LinkedIn, le numéro de téléphone, le score de confiance, le statut de vérification, le modèle d'email, les URL sources et les horodatages. Les données d'entreprise incluent le secteur, la taille, la localisation, les profils sociaux et le stack technologique.

Quelles options de filtrage sont disponibles ?

Vous pouvez filtrer par département (direction, marketing, RH, IT, ventes, ingénierie, finance, etc.), niveau d'ancienneté (senior, junior, dirigeant), type d'email (personnel ou générique), code pays et statut de vérification.

Les numéros de téléphone sont-ils inclus ?

Oui. Lorsque disponibles, les numéros de téléphone sont retournés pour chaque employé, y compris le type de numéro (mobile, fixe, gratuit), le pays et le formatage. Les données téléphoniques sont incluses sans coût de crédit supplémentaire pour les résultats de recherche de domaine.

Comment fonctionne la pagination ?

Les résultats sont paginés avec jusqu'à 10 emails par requête. Utilisez le paramètre page pour naviguer. L'objet meta inclut le nombre total et les détails de pagination. 1 crédit = 1 page de jusqu'à 10 résultats.

Quelle est la limite de requêtes ?

Les limites dépendent du plan et de l'endpoint, en requêtes par seconde / par minute / par jour : Free 1 / 2 / 5, Basic 3 / 50 / 500, Growth 5 / 80 / 1 000, Pro 8 / 150 / 4 000. Pro Plus et Scale n'ont aucune limite, et Enterprise autorise 100 000 requêtes par jour sans limite par seconde. Chaque réponse inclut des en-têtes de limite de débit ; consultez Limites de débit . Pour les grandes listes, utilisez la Recherche de Domaine en Masse : jusqu'à 25 000 domaines par tâche.

Comment les sources sont-elles suivies ?

Chaque email inclut un tableau de sources avec les URL où il a été trouvé, les dates d'extraction, les dates de dernière consultation et si l'email est toujours visible. Cela aide à vérifier la fraîcheur et la fiabilité des données.

Retourne-t-elle les profils sociaux de l'entreprise ?

Oui. La réponse inclut la page LinkedIn de l'entreprise, le compte Twitter, la page Facebook et d'autres profils sociaux lorsque disponibles, ainsi que la description de l'entreprise et la classification sectorielle.

Puis-je filtrer par pays ?

Oui. Passez un code pays à deux lettres (ex. US, FR, DE) comme paramètre de requête pour obtenir uniquement les employés situés dans ce pays. Cette fonctionnalité a été ajoutée dans notre mise à jour de juin 2025.

// get /v1/domain-search

API Recherche de Domaine

Trouvez toutes les adresses email, numéros de téléphone, détails d'entreprise et profils d'employés associés à n'importe quel domaine d'entreprise. Filtrez par département, ancienneté, pays et plus encore.

Obtenir une clé API gratuite Référence de l'API

1 per 10 search credits

// console api

Exemple de réponse tiré de la référence de l'API

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 · requête

Domain Search tient en une requête HTTPS

Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.

GET/domain-searchParamètre

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 "https://api.tomba.io/v1/domain-search?domain=piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const res = await fetch("https://api.tomba.io/v1/domain-search?domain=piedpiper.com", {
  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?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 · réponse

Ce qui est renvoyé

Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.

GET/domain-searchChamp

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 per 10 search credits

{
  "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": "Pied Piper builds middle-out compression for files, video and a decentralized internet.",
      "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 · coût et limites

Ce que coûte un appel

Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.

// coût

1 per 10search credit

Facturé quand: At least one address is returned. 1 credit per 10 results requested with limit.

Les erreurs, les réponses 429 et 451, ainsi que la même requête répétée dans votre fenêtre d'utilisation ne coûtent rien.

Comment fonctionnent les crédits

// limites de débit

Requêtes par seconde / minute / jour

	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

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. Limites de débit

// faq

Questions sur l'API Recherche de Domaine

D'autres questions ? Consultez le centre d'aide

API Recherche de Domaine

Domain Search tient en une requête HTTPS

Ce qui est renvoyé

Ce que coûte un appel

Endpoints associés

Questions sur l'API Recherche de Domaine

Votre premier appel en une minute