Annuaire de Prospection E-mail

Adresses e-mail de contacts presse à jour regroupées par secteur.

API FAQ

Obtenir une clé API Acheter des crédits

Endpoint:

99.9 % Disponibilité

918ms Réponse

20 req/s

0.01 Crédits / requête

List Press Releases


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

Paramètre	Type	Req.	Description
`api_key`	string	oui	Your API key
`category`	string	opt.	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	opt.	Only show press releases from the last N days (0 = all time)
`page`	integer	opt.	Page number (default: 1)
`per_page`	integer	opt.	Results per page, max 100 (default: 20)

Exemple

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

Exemple de réponse

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

Codes de réponse

Code	Description
200 Success	Requête traitée avec succès.
400 Bad Request	Validation d'entrée échouée.
401 Unauthorized	Clé API manquante ou incorrecte.
403 Forbidden	Clé inactive ou non autorisée.
429 Rate Limit	Trop de requêtes.
500 Server Error	Erreur inattendue.

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

Paramètre	Type	Req.	Description
`api_key`	string	oui	Your API key
`mails`	array	oui	Array of email addresses to unlock

Exemple

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

Exemple de réponse

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

Codes de réponse

Code	Description
200 Success	Requête traitée avec succès.
400 Bad Request	Validation d'entrée échouée.
401 Unauthorized	Clé API manquante ou incorrecte.
403 Forbidden	Clé inactive ou non autorisée.
429 Rate Limit	Trop de requêtes.
500 Server Error	Erreur inattendue.

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

Paramètre	Type	Req.	Description
`api_key`	string	oui	Your API key

Exemple

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

Exemple de réponse

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

Codes de réponse

Code	Description
200 Success	Requête traitée avec succès.
400 Bad Request	Validation d'entrée échouée.
401 Unauthorized	Clé API manquante ou incorrecte.
403 Forbidden	Clé inactive ou non autorisée.
429 Rate Limit	Trop de requêtes.
500 Server Error	Erreur inattendue.

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

Paramètre	Type	Req.	Description
`api_key`	string	oui	Your API key
`format`	string	opt.	Export format: json or csv (default: json)
`category`	string	opt.	Filter exported contacts by category

Exemple

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

Exemple de réponse

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

Codes de réponse

Code	Description
200 Success	Requête traitée avec succès.
400 Bad Request	Validation d'entrée échouée.
401 Unauthorized	Clé API manquante ou incorrecte.
403 Forbidden	Clé inactive ou non autorisée.
429 Rate Limit	Trop de requêtes.
500 Server Error	Erreur inattendue.

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

Questions fréquemment posées

Chaque contact est extrait d'un communiqué de presse payant ou d'une commande d'article invité sur des services de diffusion partenaires. L'entreprise a déjà investi dans la distribution et recherche donc activement de la couverture.

De nouveaux communiqués de presse sont collectés quotidiennement à partir de plusieurs services de diffusion. Vous pouvez filtrer par récence (1, 7 ou 30 jours) pour n'obtenir que les contacts les plus récents.

1 crédit débloque 1 nouvelle adresse e-mail. Les e-mails déjà débloqués sont gratuits à consulter de nouveau. Les endpoints de liste et catégories coûtent une fraction de crédit.

Oui. Utilisez l'endpoint d'export pour télécharger tous vos contacts débloqués au format JSON ou CSV, avec filtrage optionnel par catégorie.

Les e-mails que vous n'avez pas encore débloqués sont partiellement masqués (ex. j***@example.com). Une fois débloqués, l'adresse complète est retournée dans toutes les requêtes suivantes.

Oui. Chaque requête, même celles qui entraînent des erreurs, consomme des crédits. Vos crédits sont liés au nombre de requêtes, indépendamment du succès ou de l'échec. Si l'erreur est clairement due à un problème de plateforme de notre côté, nous restaurerons les crédits affectés (pas de remboursement en espèces).

Contactez-nous à [email protected]. Nous prenons les retours au sérieux—si votre rapport de bug ou demande de fonctionnalité est pertinent, nous pouvons corriger ou améliorer l'API rapidement et vous accorder 50 crédits gratuits en guise de remerciement.

Cela dépend de l'API et parfois même du endpoint. Certains endpoints utilisent des données de sources externes, qui peuvent avoir des limites plus strictes. Nous imposons également des limites pour prévenir les abus et maintenir la stabilité de notre plateforme. Consultez la documentation pour la limite spécifique de chaque endpoint.

Nous fonctionnons avec un système de crédits. Les crédits sont des unités prépayées et non remboursables que vous dépensez pour les appels API et les outils. Les crédits sont consommés en FIFO (les plus anciens en premier) et sont valables 12 mois à compter de la date d'achat. Le tableau de bord affiche chaque date d'achat et son expiration.

Oui. Tous les crédits achetés (y compris les soldes fractionnaires) sont valables 12 mois à compter de l'achat. Les crédits inutilisés expirent automatiquement et sont définitivement supprimés à la fin de la période de validité. Les crédits expirés ne peuvent être restaurés ni convertis en espèces ou autre valeur. Règle transitoire : les crédits achetés avant le 22 sept. 2025 sont traités comme achetés le 22 sept. 2025 et expirent le 22 sept. 2026 (sauf si une expiration antérieure a été indiquée lors de l'achat).

Oui—dans leur période de validité. Les crédits inutilisés restent disponibles et sont reportés de mois en mois jusqu'à leur expiration 12 mois après l'achat.

Les crédits sont non remboursables. N'achetez que ce dont vous avez besoin—vous pouvez toujours recharger plus tard. Si une erreur de plateforme cause un échec de facturation, nous pouvons restaurer les crédits affectés après enquête. Pas de remboursement en espèces.

Les prix sont fixés en crédits, pas en dollars. Chaque endpoint a son propre coût—voir le badge « Crédits / requête » ci-dessus. Vous saurez toujours exactement ce que vous dépensez.

← Retour aux APIs

Obtiens des crédits pour débloquer le contenu et les fonctionnalités premium

Type de client

Pays de facturation

API / Endpoint

Devise

Nombre de requêtes

Annuaire de Prospection E-mail

List Press Releases

Exemple

Exemple de réponse

Codes de réponse

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Exemple

Exemple de réponse

Codes de réponse

Unlock Emails

Parameters

Code Samples

Response

List Categories

Exemple

Exemple de réponse

Codes de réponse

List Categories

Parameters

Code Samples

Response

Export Contacts

Exemple

Exemple de réponse

Codes de réponse

Export Contacts

Parameters

Code Samples

Response

Questions fréquemment posées

D'où proviennent les contacts e-mail ?

Quelle est la fraîcheur des contacts ?

Comment fonctionne la tarification ?

Puis-je exporter les contacts ?

Pourquoi certains e-mails sont-ils masqués ?

Les requêtes avec erreurs comptent-elles et coûtent-elles des crédits ?

J'ai trouvé un bug ou je veux des personnalisations dans les APIs. Que faire ?

Quelle est la limite de requêtes ?

Comment fonctionnent le paiement et l'utilisation ?

Les crédits expirent-ils ?

Les crédits inutilisés sont-ils reportés ?

Proposez-vous des remboursements ?

Combien coûte chaque appel API ?