Directorio de Contactos por E-mail

Correos electrónicos de contacto de prensa actualizados agrupados por industria.

API FAQ

Obtener clave API Comprar créditos

Endpoint:

99.9 % Disponibilidad

918ms Respuesta

20 req/s

0.01 Créditos / solicitud

List Press Releases


POST https://api.yeb.to/v1/outreach/list

Parámetro	Tipo	Req.	Descripción
`api_key`	string	sí	Your API key
`category`	string	opc.	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	opc.	Only show press releases from the last N days (0 = all time)
`page`	integer	opc.	Page number (default: 1)
`per_page`	integer	opc.	Results per page, max 100 (default: 20)

Ejemplo

curl -X POST https://api.yeb.to/v1/outreach/list \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "category": "Technology",
  "days": 7,
  "page": 1,
  "per_page": 20
}'

Ejemplo de respuesta

{
  "data": [
    {
      "id": 42581,
      "summary": "TechCorp announces new AI platform for enterprise automation",
      "category": "Technology",
      "added_at": "2026-03-11T08:30:00+00:00",
      "mails": [
        { "mail": "[email protected]", "unlocked": true },
        { "mail": "j***@reuters.com", "unlocked": false }
      ]
    }
  ],
  "total": 1842,
  "page": 1,
  "per_page": 20,
  "last_page": 93
}

{"error":"Invalid API key","code":401}

Códigos de respuesta

Código	Descripción
200 Success	Solicitud procesada correctamente.
400 Bad Request	Validación de entrada fallida.
401 Unauthorized	Clave API faltante o incorrecta.
403 Forbidden	Clave inactiva o no permitida.
429 Rate Limit	Demasiadas solicitudes.
500 Server Error	Error inesperado.

List Press Releases

outreach/list 0.0100 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Code Samples

Response

Status: —

Headers

Body

Unlock Emails


POST https://api.yeb.to/v1/outreach/unlock

Parámetro	Tipo	Req.	Descripción
`api_key`	string	sí	Your API key
`mails`	array	sí	Array of email addresses to unlock

Ejemplo

curl -X POST https://api.yeb.to/v1/outreach/unlock \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "mails": ["[email protected]", "[email protected]"]
}'

Ejemplo de respuesta

{
  "emails": ["[email protected]", "[email protected]"],
  "new_unlocked": 2,
  "already_unlocked": 0,
  "credits_charged": 2.0
}

{"error":"Insufficient credits. Need 2, have 0.5","code":402}

Códigos de respuesta

Código	Descripción
200 Success	Solicitud procesada correctamente.
400 Bad Request	Validación de entrada fallida.
401 Unauthorized	Clave API faltante o incorrecta.
403 Forbidden	Clave inactiva o no permitida.
429 Rate Limit	Demasiadas solicitudes.
500 Server Error	Error inesperado.

Unlock Emails

outreach/unlock 1.0000 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Emails

body · string · required

Code Samples

Response

Status: —

Headers

Body

List Categories


POST https://api.yeb.to/v1/outreach/categories

Parámetro	Tipo	Req.	Descripción
`api_key`	string	sí	Your API key

Ejemplo

curl -X POST https://api.yeb.to/v1/outreach/categories \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY"
}'

Ejemplo de respuesta

{
  "categories": [
    { "name": "Business & Finance", "count": 4521 },
    { "name": "Technology", "count": 3892 },
    { "name": "Healthcare & Pharma", "count": 2104 },
    { "name": "Entertainment & Media", "count": 1847 }
  ],
  "total": 15
}

{"error":"Invalid API key","code":401}

Códigos de respuesta

Código	Descripción
200 Success	Solicitud procesada correctamente.
400 Bad Request	Validación de entrada fallida.
401 Unauthorized	Clave API faltante o incorrecta.
403 Forbidden	Clave inactiva o no permitida.
429 Rate Limit	Demasiadas solicitudes.
500 Server Error	Error inesperado.

List Categories

outreach/categories 0.0010 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Code Samples

Response

Status: —

Headers

Body

Export Contacts


POST https://api.yeb.to/v1/outreach/export

Parámetro	Tipo	Req.	Descripción
`api_key`	string	sí	Your API key
`format`	string	opc.	Export format: json or csv (default: json)
`category`	string	opc.	Filter exported contacts by category

Ejemplo

curl -X POST https://api.yeb.to/v1/outreach/export \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "format": "json",
  "category": "Technology"
}'

Ejemplo de respuesta

{
  "data": [
    {
      "email": "[email protected]",
      "category": "Technology",
      "summary": "TechCorp announces new AI platform",
      "added_at": "2026-03-11 08:30:00"
    },
    {
      "email": "[email protected]",
      "category": "Technology",
      "summary": "Reuters covers enterprise automation trend",
      "added_at": "2026-03-10 14:15:00"
    }
  ],
  "total": 2,
  "format": "json"
}

{"error":"Authentication required","code":401}

Códigos de respuesta

Código	Descripción
200 Success	Solicitud procesada correctamente.
400 Bad Request	Validación de entrada fallida.
401 Unauthorized	Clave API faltante o incorrecta.
403 Forbidden	Clave inactiva o no permitida.
429 Rate Limit	Demasiadas solicitudes.
500 Server Error	Error inesperado.

Export Contacts

outreach/export 0.0500 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Format

body · string

Code Samples

Response

Status: —

Headers

Body

Preguntas frecuentes

Cada contacto se extrae de una nota de prensa de pago o un pedido de artículo invitado en servicios de distribución asociados. La empresa ya ha invertido en distribución, por lo que busca cobertura activamente.

Nuevas notas de prensa se recopilan a diario de múltiples servicios de distribución. Puedes filtrar por recencia (1, 7 o 30 días) para obtener solo los contactos más recientes.

1 crédito desbloquea 1 dirección de e-mail nueva. Los e-mails ya desbloqueados son gratuitos para acceder de nuevo. Los endpoints de lista y categorías cuestan una fracción de crédito.

Sí. Usa el endpoint de exportación para descargar todos tus contactos desbloqueados como JSON o CSV, opcionalmente filtrados por categoría.

Los e-mails que aún no has desbloqueado están parcialmente enmascarados (ej. j***@example.com). Una vez desbloqueados, la dirección completa se devuelve en todas las solicitudes posteriores.

Sí. Cada solicitud, incluso las que resultan en errores, consume créditos. Tus créditos están vinculados al número de solicitudes, independientemente del éxito o fracaso. Si el error se debe claramente a un problema de la plataforma de nuestro lado, restauraremos los créditos afectados (sin reembolsos en efectivo).

Contáctanos en [email protected]. Tomamos los comentarios en serio—si tu reporte de error o solicitud de función es significativo, podemos corregir o mejorar la API rápidamente y otorgarte 50 créditos gratuitos como agradecimiento.

Depende de la API y a veces incluso del endpoint. Algunos endpoints usan datos de fuentes externas, que pueden tener límites más estrictos. También imponemos límites para prevenir abusos y mantener nuestra plataforma estable. Consulta la documentación para el límite específico de cada endpoint.

Operamos con un sistema de créditos. Los créditos son unidades prepagadas y no reembolsables que gastas en llamadas API y herramientas. Los créditos se consumen FIFO (los más antiguos primero) y son válidos por 12 meses desde la fecha de compra. El panel muestra cada fecha de compra y su vencimiento.

Sí. Todos los créditos comprados (incluidos saldos fraccionarios) son válidos por 12 meses desde la compra. Los créditos no utilizados expiran automáticamente y se eliminan permanentemente al final del período de validez. Los créditos expirados no pueden restaurarse ni convertirse en efectivo u otro valor. Regla transitoria: los créditos comprados antes del 22 de sep. de 2025 se tratan como comprados el 22 de sep. de 2025 y expiran el 22 de sep. de 2026 (a menos que se indicara un vencimiento anterior en la compra).

Sí—dentro de su período de validez. Los créditos no utilizados permanecen disponibles y se transfieren de mes a mes hasta que expiran 12 meses después de la compra.

Los créditos son no reembolsables. Compra solo lo que necesites—siempre puedes recargar después. Si un error de la plataforma causa un cargo fallido, podemos restaurar los créditos afectados tras investigación. Sin reembolsos en efectivo.

Los precios se establecen en créditos, no en dólares. Cada endpoint tiene su propio costo—consulta la insignia "Créditos / solicitud" arriba. Siempre sabrás exactamente cuánto gastas.

← Volver a las APIs

Obtén créditos para desbloquear contenido y funciones premium

Tipo de cliente

País de facturación

API / Endpoint

Moneda

N.º de solicitudes

Directorio de Contactos por E-mail

List Press Releases

Ejemplo

Ejemplo de respuesta

Códigos de respuesta

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Ejemplo

Ejemplo de respuesta

Códigos de respuesta

Unlock Emails

Parameters

Code Samples

Response

List Categories

Ejemplo

Ejemplo de respuesta

Códigos de respuesta

List Categories

Parameters

Code Samples

Response

Export Contacts

Ejemplo

Ejemplo de respuesta

Códigos de respuesta

Export Contacts

Parameters

Code Samples

Response

Preguntas frecuentes

¿De dónde provienen los contactos de e-mail?

¿Qué tan frescos son los contactos?

¿Cómo funciona la tarificación?

¿Puedo exportar contactos?

¿Por qué algunos e-mails están enmascarados?

¿Las solicitudes con errores cuentan y cuestan créditos?

Encontré un error o quiero personalizaciones en las APIs. ¿Qué hago?

¿Cuál es el límite de solicitudes?

¿Cómo funcionan el pago y el uso?

¿Los créditos expiran?

¿Se transfieren los créditos no utilizados?

¿Ofrecen reembolsos?

¿Cuánto cuesta cada llamada API?