// post /v1/reveal/search
API de Revelación de Empresas
Revela inteligencia completa de empresas desde cualquier dominio industria, ingresos, número de empleados, stack tecnológico, perfiles sociales y contactos verificados de tomadores de decisiones en una sola llamada a la API.
// consola de la api
- companies
- 1 item
- companies[0].name
- Pied Piper
- companies[0].website_url
- piedpiper.com
- companies[0].industry
- computer software
- companies[0].company_size
- 11-50
- companies[0].city
- Palo Alto
- companies[0].founded
- 2014
- companies[0].total_emails
- 48
// 01 · solicitud
Company Search 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.
/reveal/searchqueryobligatorio- What you are looking for, in plain language
page1- Result page
curl -X POST https://api.tomba.io/v1/reveal/search \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Compression startups in California","page":1}'const res = await fetch("https://api.tomba.io/v1/reveal/search", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({"query":"Compression startups in California","page":1})
});
const { data } = await res.json();import os, requests
res = requests.post(
"https://api.tomba.io/v1/reveal/search",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={"query":"Compression startups in California","page":1},
)
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.
/reveal/searchdata.companies[]array | null- Name, website, description, industry, size, type, founded, revenue, location, social links
data.companies[].total_emailsinteger- Addresses Tomba holds for the company
data.companies[].total_similarinteger- Similar companies Tomba knows
meta.total, meta.pagesinteger- Companies that match, and pages
meta.page, meta.limitinteger- This page and its size
meta.filtersobject- The filters Tomba read from your query
{
"success": true,
"data": {
"companies": [
{
"name": "Pied Piper",
"description": "Middle-out compression for files and video.",
"country": "US",
"state": "California",
"city": "Palo Alto",
"street_address": "5230 Newell Road",
"postal_code": "94303",
"industry": "computer software",
"company_size": "11-50",
"type": "privately held",
"founded": "2014",
"website_url": "piedpiper.com",
"total_emails": 48,
"revenue": "",
"phone_number": false,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"facebook_url": "",
"twitter_url": "",
"total_similar": 2
}
]
},
"meta": {
"total": 64,
"page": 1,
"limit": 10,
"pages": 7,
"filters": {
"location_state": {
"include": [
"California"
]
},
"industry": {
"include": [
"computer software"
]
}
}
}
}// 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: At least one 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 Reveal API
¿Tiene más preguntas? Visite el centro de ayuda