Ir al contenido

// get /v1/similar

API de Dominios Similares

Encuentra empresas similares y dominios de competidores basándose en cualquier dominio de sitio web a través de nuestra API RESTful.

1 per 10 search credits

// consola de la api

GETapi.tomba.io/v1/similar
Respuesta de ejemplo de la referencia de la API
[0].website_url
hooli.com
[0].name
Hooli
[0].industries
internet

// 01 · solicitud

Similar Domains 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/similarParámetro
domainpiedpiper.com
Company domain (or send company)
limit10
Results per page
curl "https://api.tomba.io/v1/similar?domain=piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · respuesta

Lo que recibes

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

GET/similarCampo
data[].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
GET /similar
200 OK· 1 per 10 search credits
{
  "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 per 10search credit

Se cobra cuando: Results are returned. 1 credit per 10 results requested with limit.

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
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 100 / 4,000

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

// faq

Preguntas sobre la API de Dominios Similares

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

// inicio rápido

Haz tu primera llamada en un minuto

Cuenta gratis, clave API real, los mismos endpoints que usan los clientes Enterprise.

  1. 1Crea una cuenta gratis25 búsquedas al mes. Sin tarjeta.
  2. 2Copia tu clave y tu secretoDesde Claves API en el panel.
  3. 3Llama a la APIPega la solicitud; la respuesta es JSON.
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Respuesta
200 OK· 1 search credit
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "sources": [
      {
        "uri": "https://piedpiper.com/blog/engineering",
        "website_url": "piedpiper.com",
        "extracted_on": "2024-06-01T09:14:07+01:00",
        "last_seen_on": "2025-01-10T17:02:44+01:00",
        "still_on_page": true
      }
    ],
    "phone_data": []
  }
}