// get /v1/companies/find
API de Enriquecimiento de Empresas
Obtén perfiles completos de empresas desde cualquier dominio industria, tamaño, stack tecnológico, perfiles sociales y datos de empleados a través de la API.
1 search credit
// consola de la api
EjemploRespuesta de ejemplo de la referencia de la API
- name
- Pied Piper
- domain
- piedpiper.com
- description
- Middle-out compression for files and video.
- category.industry
- Internet Software & Services
- foundedYear
- 2014
- geo.city
- Palo Alto
- geo.country
- United States
- metrics.employees
- 11-50
- emailProvider
// 01 · solicitud
Company Enrichment 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
/companies/finddomainobligatorio- Company domain
curl -G https://api.tomba.io/v1/companies/find \
--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/companies/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/companies/find",
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 · respuesta
Lo que recibes
JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.
GET
/companies/finddata.name, data.legalName, data.domainstring | null- Who the company is
data.description, data.foundedYear, data.typestring | null- What it does, when it was founded, its ownership
data.categoryobject- Sector, industry, SIC and NAICS codes
data.geoobject- Street address, city, state, country, coordinates
data.metricsobject- Employees, traffic rank, revenue, funding
data.linkedin, data.twitter, data.facebookobject- Social handles
data.tech[], data.techCategories[]array | null- Technologies the website runs
meta.domainstring | null- The domain you sent
errorsobject- When nothing is found the response is still 200, with errors {type, message, code} instead of data
GET /companies/find
200 OK· 1 search credit
{
"data": {
"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": {
"domain": "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
1search credit
Se cobra cuando: A company 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 Company Enrichment API
¿Tiene más preguntas? Visite el centro de ayuda
Nombre de empresa, industria, número de empleados, ingresos, año de fundación, dirección de sede central, oficinas, stack tecnológico, perfiles sociales, códigos SIC/NAICS, teléfono, metadatos del sitio web y emails de empleados.
Sí. Devuelve todas las tecnologías detectadas incluyendo CRM, marketing, analítica, frameworks y hosting.
Sí. El teléfono principal de la empresa se devuelve cuando está disponible sin costo adicional de créditos.
Sí. La API de Enriquecimiento Masivo de Empresas procesa miles de dominios mediante CSV o API.
Los perfiles se actualizan continuamente a partir de nuestro rastreo de más de 2.000 millones de páginas web al mes. Cada registro incluye una marca de tiempo de la última actualización para que sepas lo recientes que son los datos.
1 crédito por cada enriquecimiento de empresa. Las consultas fallidas de dominios desconocidos no se cobran.
13 SDK oficiales: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby y Rust.
Sí. Devuelve todas las tecnologías detectadas que usa la empresa, incluidos CRM, automatización de marketing, analítica, frameworks, CDN y proveedores de hosting.