// post /v1/bulk/similar
API similar de dominio masivo
Descubra empresas similares y dominios de la competencia para miles de cuentas en un trabajo masivo asincrónico.
Domains or company namesHasta 5,000 filas
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
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({
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · solicitud
Similar Domains masivo 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.
- type
- similar
- list | data | file
- Domains or company names
- launch
- true inicia el trabajo de inmediato
- webhook_url
- Recibe un evento firmado cuando termina el trabajo
- rows
- Hasta 5,000 por trabajo
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
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({
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 02 · respuesta
Lo que recibes
JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.
GET
/similardata[].website_urlstring- Each similar company's domain
data[].name, data[].industriesstring | null- Its name and industry
meta.total, meta.total_pagesinteger- Similar companies found, and pages
meta.current, meta.pageSizeinteger- This page and its size
meta.paramsobject- The parameters the search ran with
POST /bulk/similar
201 Created
{
"data": {
"id": 1042
}
}Cada fila, tal como la devuelve GET /similar
200 OK
{
"data": [
{
"website_url": "hooli.com",
"name": "Hooli",
"industries": "internet"
},
{
"website_url": "endframe.com",
"name": "Endframe",
"industries": "computer software"
}
],
"meta": {
"total": 2,
"pageSize": 10,
"current": 1,
"total_pages": 1,
"params": {
"domain": "piedpiper.com",
"page": 1,
"limit": 10
}
}
}// 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
1 search credit per domain with at least one similar company.
Charged once, at the first download; later downloads are free
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
Cree una operación masiva cargando los dominios de la empresa y luego inicie la operación. La API busca empresas similares para cada dominio de forma asincrónica según la industria, el tamaño y el modelo de negocio.
Puede procesar hasta 1000 dominios por operación masiva. Cada dominio devuelve una lista de empresas similares.
La API analiza múltiples factores, incluida la clasificación de la industria, el tamaño de la empresa, el modelo de negocio, la pila de tecnología y el posicionamiento en el mercado para identificar empresas similares.
Cada dominio devuelve una lista de dominios de empresas similares con sus nombres. Los resultados se clasifican por relevancia y puntuación de similitud.
Los casos de uso comunes incluyen análisis competitivo, investigación de mercado, expansión de TAM, búsqueda de empresas similares para prospección de ventas y creación de listas de cuentas específicas.
El tiempo de procesamiento depende del tamaño de la lista y de las búsquedas que requiera. Consulte el estado del trabajo o configure un webhook para saber cuándo termina.
Sí, configure una URL de webhook para recibir una notificación cuando su operación masiva de dominio similar se complete con resultados listos para descargar.
Una vez que se complete el procesamiento, use el punto final de descarga para obtener todos los dominios similares en formato CSV o JSON para cada dominio de entrada.
Sí. Un flujo de trabajo común es comenzar con clientes conocidos, encontrar empresas similares de forma masiva y luego enviar esos dominios a Domain Search o Email Finder para descubrir contactos.
Utilice dominios corporativos oficiales en lugar de micrositios de productos o redirecciones de países. Los dominios canónicos limpios producen una mejor puntuación de similitud y menos duplicados.