Diretório de Contactos por E-mail

E-mails de contactos de imprensa atualizados agrupados por indústria.

API FAQ

Obter chave API Comprar créditos

Endpoint:

99.9 % Disponibilidade

918ms Resposta

20 req/s

0.01 Créditos / requisição

List Press Releases


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

Parâmetro	Tipo	Obrig.	Descrição
`api_key`	string	sim	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)

Exemplo

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
}'

Exemplo de resposta

{
  "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 resposta

Código	Descrição
200 Success	Requisição processada OK.
400 Bad Request	Validação de entrada falhou.
401 Unauthorized	Chave API em falta ou incorreta.
403 Forbidden	Chave inativa ou não permitida.
429 Rate Limit	Demasiadas requisições.
500 Server Error	Erro 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	Obrig.	Descrição
`api_key`	string	sim	Your API key
`mails`	array	sim	Array of email addresses to unlock

Exemplo

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]"]
}'

Exemplo de resposta

{
  "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 resposta

Código	Descrição
200 Success	Requisição processada OK.
400 Bad Request	Validação de entrada falhou.
401 Unauthorized	Chave API em falta ou incorreta.
403 Forbidden	Chave inativa ou não permitida.
429 Rate Limit	Demasiadas requisições.
500 Server Error	Erro 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	Obrig.	Descrição
`api_key`	string	sim	Your API key

Exemplo

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

Exemplo de resposta

{
  "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 resposta

Código	Descrição
200 Success	Requisição processada OK.
400 Bad Request	Validação de entrada falhou.
401 Unauthorized	Chave API em falta ou incorreta.
403 Forbidden	Chave inativa ou não permitida.
429 Rate Limit	Demasiadas requisições.
500 Server Error	Erro 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	Obrig.	Descrição
`api_key`	string	sim	Your API key
`format`	string	opc.	Export format: json or csv (default: json)
`category`	string	opc.	Filter exported contacts by category

Exemplo

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

Exemplo de resposta

{
  "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 resposta

Código	Descrição
200 Success	Requisição processada OK.
400 Bad Request	Validação de entrada falhou.
401 Unauthorized	Chave API em falta ou incorreta.
403 Forbidden	Chave inativa ou não permitida.
429 Rate Limit	Demasiadas requisições.
500 Server Error	Erro 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

Perguntas Frequentes

Cada contacto é extraído de um comunicado de imprensa pago ou encomenda de guest-post em serviços de distribuição parceiros. A empresa já investiu na distribuição, pelo que procura ativamente cobertura mediática.

Novos comunicados de imprensa são recolhidos diariamente de múltiplos serviços de distribuição. Pode filtrar por atualidade (1, 7 ou 30 dias) para obter apenas os contactos mais recentes.

1 crédito desbloqueia 1 endereço de e-mail novo. E-mails já desbloqueados são gratuitos para aceder novamente. Os endpoints de lista e categorias custam uma fração de crédito.

Sim. Use o endpoint de exportação para descarregar todos os seus contactos desbloqueados como JSON ou CSV, opcionalmente filtrados por categoria.

Os e-mails que ainda não desbloqueou estão parcialmente mascarados (ex: j***@example.com). Após o desbloqueio, o endereço completo é devolvido em todos os pedidos subsequentes.

Sim. Cada requisição, mesmo as que resultam em erros, consome créditos. Seus créditos estão vinculados ao número de requisições, independentemente de sucesso ou falha. Se o erro for claramente devido a um problema da plataforma do nosso lado, restauraremos os créditos afetados (sem reembolsos em dinheiro).

Contacte-nos em [email protected]. Levamos o feedback a sério—se o seu relatório de bug ou pedido de funcionalidade for significativo, podemos corrigir ou melhorar a API rapidamente e conceder-lhe 50 créditos gratuitos como agradecimento.

Depende da API e às vezes até do endpoint. Alguns endpoints usam dados de fontes externas, que podem ter limites mais rigorosos. Também aplicamos limites para prevenir abusos e manter a nossa plataforma estável. Consulte a documentação para o limite específico de cada endpoint.

Operamos com um sistema de créditos. Créditos são unidades pré-pagas e não reembolsáveis que gasta em chamadas API e ferramentas. Os créditos são consumidos por FIFO (os mais antigos primeiro) e são válidos por 12 meses a partir da data de compra. O painel mostra cada data de compra e a sua expiração.

Sim. Todos os créditos comprados (incluindo saldos fracionários) são válidos por 12 meses a partir da compra. Créditos não utilizados expiram automaticamente e são permanentemente eliminados no final do período de validade. Créditos expirados não podem ser restaurados ou convertidos em dinheiro ou outro valor. Regra de transição: créditos comprados antes de 22 de set. de 2025 são tratados como comprados em 22 de set. de 2025 e expiram em 22 de set. de 2026 (salvo indicação de expiração anterior na compra).

Sim—dentro do período de validade. Os créditos não utilizados permanecem disponíveis e são transferidos de mês para mês até expirarem 12 meses após a compra.

Os créditos são não reembolsáveis. Compre apenas o que precisa—pode sempre recarregar depois. Se um erro da plataforma causar uma cobrança falhada, podemos restaurar os créditos afetados após investigação. Sem reembolsos em dinheiro.

Os preços são definidos em créditos, não em dólares. Cada endpoint tem o seu próprio custo—veja o selo "Créditos / requisição" acima. Saberá sempre exatamente quanto está a gastar.

← Voltar às APIs

Obtém créditos para desbloquear conteúdo e funcionalidades premium

Tipo de cliente

País de faturação

API / Endpoint

Moeda

N.º de pedidos

Diretório de Contactos por E-mail

List Press Releases

Exemplo

Exemplo de resposta

Códigos de resposta

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Exemplo

Exemplo de resposta

Códigos de resposta

Unlock Emails

Parameters

Code Samples

Response

List Categories

Exemplo

Exemplo de resposta

Códigos de resposta

List Categories

Parameters

Code Samples

Response

Export Contacts

Exemplo

Exemplo de resposta

Códigos de resposta

Export Contacts

Parameters

Code Samples

Response

Perguntas Frequentes

De onde vêm os contactos de e-mail?

Quão atualizados são os contactos?

Como funciona a tarificação?

Posso exportar contactos?

Por que alguns e-mails estão mascarados?

Requisições com erros contam e custam créditos?

Encontrei um bug ou quero personalizações nas APIs. O que faço?

Qual é o limite de requisições?

Como funcionam o pagamento e o uso?

Os créditos expiram?

Os créditos não utilizados são transferidos?

Oferecem reembolsos?

Quanto custa cada chamada API?