Ir al contenido

// get /v1/email-count

API de Conteo de Emails

Obtén el número total de direcciones de email encontradas para cualquier dominio, desglosado por personales vs genéricos, departamento y nivel de antigüedad.

1 email count credit

// consola de la api

GETapi.tomba.io/v1/email-count
Respuesta de ejemplo de la referencia de la API
total
48
personal_emails
41
generic_emails
7
department.engineering
12
department.finance
2
department.hr
1
department.it
3
department.marketing
4
department.operations
2

// 01 · solicitud

Email Count 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/email-countParámetro
domainobligatorio
Company domain
curl "https://api.tomba.io/v1/email-count?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/email-countCampo
data.totalinteger
All addresses
data.personal_emails, data.generic_emailsinteger
Addresses of people, and role addresses such as sales@
data.departmentobject
Addresses per team: engineering, sales, marketing, executive and 18 more
data.seniorityobject
Addresses per level: junior, senior, executive
website_idinteger
Tomba's ID for the company record; 0 when it has none
GET /email-count
200 OK· 1 email count credit
{
  "data": {
    "total": 48,
    "personal_emails": 41,
    "generic_emails": 7,
    "department": {
      "engineering": 12,
      "finance": 2,
      "hr": 1,
      "it": 3,
      "marketing": 4,
      "operations": 2,
      "management": 3,
      "sales": 5,
      "legal": 1,
      "support": 2,
      "communication": 1,
      "executive": 4,
      "accounting": 0,
      "administrative": 1,
      "diversity": 0,
      "facilities": 0,
      "pr": 0,
      "security": 0,
      "software": 0,
      "warehouse": 0,
      "healthcare": 0,
      "education": 0
    },
    "seniority": {
      "junior": 12,
      "senior": 22,
      "executive": 7
    }
  },
  "website_id": 128734
}

// 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

1email count credit

Se cobra cuando: Every call.

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 Conteo de Emails

¿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": []
  }
}