¿Qué devuelve la API Combinada?

Una sola respuesta que contiene datos de persona (nombre, ubicación, empleo, perfiles sociales, verificación) y datos de empresa (datos firmográficos, stack tecnológico, WHOIS, SIC/NAICS, métricas, perfiles sociales) para la dirección de email.

¿Es un reemplazo de Clearbit?

Sí. La API Combinada es un reemplazo directo de la API de Enriquecimiento Combinado de Clearbit. Un email de entrada, datos de persona + empresa de salida.

¿Cuántos créditos por búsqueda?

2 créditos de búsqueda por cada búsqueda que devuelve una persona, por la persona y la empresa en una sola llamada. Las búsquedas que no encuentran a nadie son gratuitas.

¿Qué pasa si no se encuentra la empresa?

El objeto de persona se devuelve igualmente. El objeto de empresa será nulo si no hay datos de empresa disponibles para el dominio del email.

¿Qué perfiles sociales se incluyen?

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

¿Qué SDKs están disponibles?

13 SDKs oficiales: Python, Node.js, PHP, Ruby, Go, Dart, Lua, R y Elixir.

¿Qué tan actualizados están los datos?

Tanto los registros de persona como de empresa incluyen marcas de tiempo indexedAt. Los datos se actualizan continuamente a partir de nuestro rastreo de más de 2B de páginas web mensuales.

// get /v1/combined/find

API Combinada

Obtén datos de persona y empresa desde una sola dirección de email perfiles sociales, empleo, datos firmográficos, stack tecnológico y métricas de negocio en una llamada a la API. Un reemplazo directo de la API Combinada de Clearbit.

Obtén tu clave API gratis Referencia de la API

2 search credits

// consola de la api

EjemploRespuesta de ejemplo de la referencia de la 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 · solicitud

Person + Company es una solicitud HTTPS

Envía los parámetros con tu clave y tu secreto. Cada SDK, la CLI y el servidor MCP hacen esta misma llamada.

GET/combined/find

emailobligatorio: 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 · respuesta

Lo que recibes

JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.

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 · coste y límites

Lo que cuesta una llamada

Una llamada solo se cobra en la condición indicada abajo. Los límites de solicitudes dependen de tu plan.

// coste

2search credit

Se cobra cuando: A person is returned.

Los errores, las respuestas 429 y 451, y la misma solicitud repetida dentro de tu ventana de uso no cuestan nada.

Cómo funcionan los créditos

// límites de solicitudes

Solicitudes por segundo / minuto / día

	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

Desplázate en horizontal para ver todas las columnas

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. Límites de solicitudes

// preguntas frecuentes

Preguntas sobre la Combined API

¿Tiene más preguntas? Visite el centro de ayuda

API Combinada

Person + Company es una solicitud HTTPS

Lo que recibes

Lo que cuesta una llamada

Endpoints relacionados

Preguntas sobre la Combined API

Descubre a quién encuentra Tomba en cualquier empresa