Quali dati restituisce la Ricerca Dominio?

Ogni richiesta restituisce: tutti gli indirizzi email conosciuti per il dominio, ciascuno con nome completo, titolo lavorativo, reparto, anzianita, paese, URL LinkedIn, numero di telefono, punteggio di affidabilita, stato di verifica, pattern email, URL delle fonti e timestamp. I dati aziendali includono settore, dimensioni, sede, profili social e stack tecnologico.

Quali opzioni di filtro sono disponibili?

Puoi filtrare per reparto (dirigenza, marketing, HR, IT, vendite, ingegneria, finanza, ecc.), livello di anzianita (senior, junior, dirigente), tipo di email (personale o generica), codice paese e stato di verifica.

Sono inclusi i numeri di telefono?

Si. Quando disponibili, vengono restituiti i numeri di telefono per ogni dipendente, inclusi tipo di numero (cellulare, fisso, numero verde), paese e formattazione. I dati telefonici sono inclusi senza costi di credito aggiuntivi nei risultati della ricerca dominio.

Come funziona la paginazione?

I risultati sono paginati con fino a 10 email per richiesta. Usa il parametro page per navigare. L'oggetto meta include il conteggio totale e i dettagli di paginazione. 1 credito = 1 pagina di massimo 10 risultati.

Qual e il limite di frequenza?

I limiti dipendono dal piano e dall'endpoint, in richieste al secondo / al minuto / al giorno: Free 1 / 2 / 5, Basic 3 / 50 / 500, Growth 5 / 80 / 1.000, Pro 8 / 150 / 4.000. Pro Plus e Scale non hanno limiti, ed Enterprise consente 100.000 richieste al giorno senza limite al secondo. Ogni risposta include gli header dei limiti di frequenza; vedi Limiti di frequenza . Per liste di grandi dimensioni, usa Bulk Domain Search : fino a 25.000 domini per job.

Come vengono tracciate le fonti?

Ogni email include un array di fonti con URL dove e stata trovata, date di estrazione, date dell'ultimo avvistamento e se l'email e ancora visibile. Questo aiuta a verificare la freschezza e l'affidabilita dei dati.

Restituisce i profili social aziendali?

Si. La risposta include la pagina LinkedIn aziendale, il profilo Twitter, la pagina Facebook e altri profili social quando disponibili, insieme alla descrizione aziendale e alla classificazione del settore.

Posso filtrare per paese?

Si. Passa un codice paese a due lettere (es. US, FR, DE) come parametro di query per ottenere solo i dipendenti situati in quel paese. Questa funzionalita e stata aggiunta nel nostro aggiornamento di giugno 2025.

// get /v1/domain-search

API Domain Search

Trova tutti gli indirizzi email, numeri di telefono, dettagli aziendali e profili dei dipendenti associati a qualsiasi dominio aziendale. Filtra per reparto, anzianita, paese e altro.

Ottieni una chiave API gratuita Riferimento API

1 search credit per 10 results

// console api

EsempioEsempio di risposta dal riferimento 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 · richiesta

Domain Search è una sola richiesta HTTPS

Invia i parametri con la tua chiave e il tuo secret. Ogni SDK, la CLI e il server MCP fanno questa stessa chiamata.

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 · risposta

Cosa ricevi

JSON, uguale in ogni linguaggio. I campi che Tomba non conosce sono null, mai indovinati.

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 · costi e limiti

Quanto costa una chiamata

Una chiamata viene addebitata solo alla condizione indicata sotto. I limiti di frequenza dipendono dal tuo piano.

// costo

1 per 10search credit

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

Errori, risposte 429 e 451 e la stessa richiesta ripetuta entro la tua finestra di utilizzo non costano nulla.

Come funzionano i crediti

// limiti di frequenza

Richieste al secondo / minuto / giorno

	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

Scorri in orizzontale per vedere tutte le colonne

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. Limiti di frequenza

// faq

Domande sull'API Domain Search

Ha altre domande? Visita il centro assistenza

API Domain Search

Domain Search è una sola richiesta HTTPS

Cosa ricevi

Quanto costa una chiamata

Endpoint correlati

Domande sull'API Domain Search

Scopri chi trova Tomba in qualsiasi azienda