O que a API Combinada retorna?

Uma unica resposta contendo dados da pessoa (nome, localizacao, emprego, perfis sociais, verificacao) e dados da empresa (dados firmograficos, stack tecnologico, WHOIS, SIC/NAICS, metricas, perfis sociais) para o endereco de email.

Isto e uma alternativa ao Clearbit?

Sim. A API Combinada e uma alternativa direta a API de Enriquecimento Combinado do Clearbit. Um email de entrada, dados de pessoa + empresa de saida.

Quantos creditos por consulta?

2 créditos de busca por consulta que retorna uma pessoa, pela pessoa e pela empresa em uma única chamada. Consultas que não encontram ninguém são gratuitas.

E se a empresa nao for encontrada?

O objeto de pessoa e retornado na mesma. O objeto de empresa sera nulo se nenhum dado de empresa estiver disponivel para o dominio do email.

Que perfis sociais estao incluidos?

Pessoa: LinkedIn, Twitter, GitHub, Facebook, Gravatar. Empresa: LinkedIn, Twitter, Facebook.

Que SDKs estao disponiveis?

13 SDKs oficiais: Python, Node.js, PHP, Ruby, Go, Dart, Lua, R e Elixir.

Quao atualizados sao os dados?

Tanto os registos de pessoa como de empresa incluem carimbos indexedAt. Os dados sao continuamente atualizados a partir da nossa indexacao de mais de 2 mil milhoes de paginas web mensalmente.

// get /v1/combined/find

API Combined

Obtenha dados de pessoa e empresa a partir de um unico endereco de email perfis sociais, emprego, dados firmograficos, stack tecnologico e metricas de negocio numa unica chamada de API. Uma alternativa direta a API Combinada do Clearbit.

Obter chave de API grátis Referência da API

2 search credits

// console da api

ExemploExemplo de resposta da referência da API

person.name.fullName: Richard Hendricks
person.employment.title: CEO
person.verification.status: valid
company.name: Pied Piper
company.category.industry: Internet Software & Services
company.geo.city: Palo Alto
company.metrics.employees: 11-50
company.foundedYear: 2014

// 01 · requisição

Person + Company é uma requisição HTTPS

Envie os parâmetros com sua chave e seu secret. Todos os SDKs, a CLI e o servidor MCP fazem esta mesma chamada.

GET/combined/find

emailobrigatório: Work email

GET /combined/find

curl -G https://api.tomba.io/v1/combined/find \
  --data-urlencode "email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const params = new URLSearchParams({
  email: "richard@piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/combined/find?${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/combined/find",
    params={
        "email": "richard@piedpiper.com",
    },
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// 02 · resposta

O que volta

JSON, igual em todas as linguagens. Campos que a Tomba não conhece vêm como null, nunca adivinhados.

GET/combined/find

data.personobject: Name, employment, location, social handles, verification (as in Person Enrichment)
data.person.employmentobject: Company, domain, title, role, seniority
data.companyobject: Name, industry codes, location, metrics, tech (as in Company Enrichment)
data.company.categoryobject: Sector, industry, SIC and NAICS codes
meta.emailstring: The address you sent
errorsobject: When nothing is found the response is still 200, with errors {type, message, code} instead of data

GET /combined/find

200 OK· 2 search credits

{
  "data": {
    "person": {
      "name": {
        "fullName": "Richard Hendricks",
        "givenName": "Richard",
        "familyName": "Hendricks"
      },
      "email": "richard@piedpiper.com",
      "location": "Palo Alto, California, United States",
      "gender": "male",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "city": "Palo Alto",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "bio": "Founder of Pied Piper.",
      "site": "https://piedpiper.com",
      "avatar": null,
      "employment": {
        "domain": "piedpiper.com",
        "name": "Pied Piper",
        "title": "CEO",
        "role": "executive",
        "subRole": null,
        "seniority": "executive"
      },
      "facebook": {
        "handle": null
      },
      "github": {
        "handle": null,
        "id": null,
        "avatar": null,
        "company": null,
        "blog": null,
        "followers": null,
        "following": null
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "statuses": null,
        "favorites": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "linkedin": {
        "handle": "in/richard-hendricks"
      },
      "gravatar": {
        "handle": null,
        "urls": null,
        "avatar": null,
        "avatars": null
      },
      "verification": {
        "date": "2025-01-15T10:32:00+01:00",
        "status": "valid"
      },
      "phone": true,
      "fuzzy": false,
      "emailProvider": "Google",
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "activeAt": "2025-01-15T10:32:00+01:00",
      "inactiveAt": null
    },
    "company": {
      "name": "Pied Piper",
      "legalName": "Pied Piper, Inc.",
      "domain": "piedpiper.com",
      "domainAliases": [],
      "site": {
        "phoneNumbers": [],
        "emailAddresses": [
          "hello@piedpiper.com"
        ]
      },
      "category": {
        "sector": "Information Technology",
        "industryGroup": "Software & Services",
        "industry": "Internet Software & Services",
        "subIndustry": "Internet Software & Services",
        "sicCode": "73",
        "sic4Codes": [
          "7372"
        ],
        "naicsCode": "51",
        "naics6Codes": [
          "511210"
        ],
        "naics6Codes2022": [
          "513210"
        ]
      },
      "tags": [
        "Compression",
        "Decentralized internet"
      ],
      "description": "Middle-out compression for files and video.",
      "foundedYear": "2014",
      "location": "5230 Newell Road, Palo Alto, CA 94303, United States",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "streetNumber": "5230",
        "streetName": "Newell Road",
        "subPremise": null,
        "streetAddress": "5230 Newell Road",
        "city": "Palo Alto",
        "postalCode": "94303",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "logo": "https://logo.tomba.io/piedpiper.com",
      "facebook": {
        "handle": null,
        "likes": null
      },
      "linkedin": {
        "handle": "company/pied-piper"
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "emailProvider": "Google",
      "type": "private",
      "ticker": null,
      "identifiers": {
        "usEIN": null
      },
      "metrics": {
        "alexaUsRank": null,
        "alexaGlobalRank": null,
        "trafficRank": null,
        "employees": "11-50",
        "marketCap": null,
        "raised": null,
        "annualRevenue": null,
        "estimatedAnnualRevenue": null,
        "fiscalYearEnd": null
      },
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "tech": [
        "google_apps",
        "intercom"
      ],
      "techCategories": [
        "email_hosting_service",
        "live_chat"
      ],
      "parent": {
        "domain": null
      },
      "ultimateParent": {
        "domain": null
      }
    }
  },
  "meta": {
    "email": "richard@piedpiper.com"
  }
}

// 03 · custo e limites

Quanto custa uma chamada

Uma chamada só é cobrada na condição abaixo. Os limites de requisições dependem do seu plano.

// custo

2search credit

Cobrado quando: A person is returned.

Erros, respostas 429 e 451, e a mesma requisição repetida dentro da sua janela de uso não custam nada.

Como os créditos funcionam

// limites de requisições

Requisições por segundo / minuto / dia

	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

Role para o lado para ver todas as colunas

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 requisições

// perguntas frequentes

Perguntas sobre a Combined API

Ainda tem dúvidas? Visite a central de ajuda

API Combined

Person + Company é uma requisição HTTPS

O que volta

Quanto custa uma chamada

Endpoints relacionados

Perguntas sobre a Combined API

Veja quem a Tomba encontra em qualquer empresa