E-mail Outreach-gids

Verse pers-e-mailadressen gegroepeerd per branche.

API FAQ

API-sleutel ophalen Credits kopen

Endpoint:

99.9 % Beschikbaarheid

918ms Antwoord

20 req/s

0.01 Credits / verzoek

List Press Releases


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

Parameter	Type	Verpl.	Beschrijving
`api_key`	string	ja	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)

Voorbeeld

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

Antwoordvoorbeeld

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

Antwoordcodes

Code	Beschrijving
200 Success	Verzoek succesvol verwerkt.
400 Bad Request	Invoervalidatie mislukt.
401 Unauthorized	Ontbrekende / onjuiste API-sleutel.
403 Forbidden	Sleutel inactief of niet toegestaan.
429 Rate Limit	Te veel verzoeken.
500 Server Error	Onverwachte fout.

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

Parameter	Type	Verpl.	Beschrijving
`api_key`	string	ja	Your API key
`mails`	array	ja	Array of email addresses to unlock

Voorbeeld

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

Antwoordvoorbeeld

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

Antwoordcodes

Code	Beschrijving
200 Success	Verzoek succesvol verwerkt.
400 Bad Request	Invoervalidatie mislukt.
401 Unauthorized	Ontbrekende / onjuiste API-sleutel.
403 Forbidden	Sleutel inactief of niet toegestaan.
429 Rate Limit	Te veel verzoeken.
500 Server Error	Onverwachte fout.

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

Parameter	Type	Verpl.	Beschrijving
`api_key`	string	ja	Your API key

Voorbeeld

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

Antwoordvoorbeeld

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

Antwoordcodes

Code	Beschrijving
200 Success	Verzoek succesvol verwerkt.
400 Bad Request	Invoervalidatie mislukt.
401 Unauthorized	Ontbrekende / onjuiste API-sleutel.
403 Forbidden	Sleutel inactief of niet toegestaan.
429 Rate Limit	Te veel verzoeken.
500 Server Error	Onverwachte fout.

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

Parameter	Type	Verpl.	Beschrijving
`api_key`	string	ja	Your API key
`format`	string	opt.	Export format: json or csv (default: json)
`category`	string	opt.	Filter exported contacts by category

Voorbeeld

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

Antwoordvoorbeeld

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

Antwoordcodes

Code	Beschrijving
200 Success	Verzoek succesvol verwerkt.
400 Bad Request	Invoervalidatie mislukt.
401 Unauthorized	Ontbrekende / onjuiste API-sleutel.
403 Forbidden	Sleutel inactief of niet toegestaan.
429 Rate Limit	Te veel verzoeken.
500 Server Error	Onverwachte fout.

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

Veelgestelde vragen

Elk contact komt uit een betaald persbericht of guest-post-bestelling bij partner-wireservices. Het bedrijf heeft al in distributie geïnvesteerd en zoekt dus actief naar publiciteit.

Nieuwe persberichten worden dagelijks verzameld van meerdere wireservices. Je kunt filteren op recentheid (1, 7 of 30 dagen) om alleen de nieuwste contacten te krijgen.

1 credit ontgrendelt 1 gloednieuw e-mailadres. Reeds ontgrendelde e-mails zijn gratis opnieuw te raadplegen. De lijst- en categorie-endpoints kosten een fractie van een credit.

Ja. Gebruik het export-endpoint om al je ontgrendelde contacten als JSON of CSV te downloaden, optioneel gefilterd op categorie.

E-mails die je nog niet hebt ontgrendeld zijn gedeeltelijk gemaskeerd (bijv. j***@example.com). Na ontgrendeling wordt het volledige adres bij alle volgende verzoeken geretourneerd.

Ja. Elk verzoek, zelfs die met fouten, verbruikt credits. Uw credits zijn gekoppeld aan het aantal verzoeken, ongeacht succes of falen. Als de fout duidelijk te wijten is aan een platformprobleem aan onze kant, herstellen we de getroffen credits (geen geldteruggave).

Neem contact met ons op via [email protected]. We nemen feedback serieus—als uw bugrapport of functieverzoek zinvol is, kunnen we de API snel repareren of verbeteren en u 50 gratis credits geven als dank.

Het hangt af van de API en soms zelfs van het endpoint. Sommige endpoints gebruiken gegevens van externe bronnen, die strengere limieten kunnen hebben. We handhaven ook limieten om misbruik te voorkomen en ons platform stabiel te houden. Raadpleeg de documentatie voor de specifieke limiet van elk endpoint.

We werken met een creditsysteem. Credits zijn vooruitbetaalde, niet-restitueerbare eenheden die u besteedt aan API-aanroepen en tools. Credits worden verbruikt volgens FIFO (oudste eerst) en zijn geldig voor 12 maanden vanaf de aankoopdatum. Het dashboard toont elke aankoopdatum en de vervaldatum.

Ja. Alle gekochte credits (inclusief fractionele saldi) zijn geldig voor 12 maanden na aankoop. Ongebruikte credits verlopen automatisch en worden permanent verwijderd aan het einde van de geldigheidsperiode. Verlopen credits kunnen niet worden hersteld of omgezet in contant geld of andere waarde. Overgangsregel: credits gekocht vóór 22 sep. 2025 worden behandeld als gekocht op 22 sep. 2025 en verlopen op 22 sep. 2026 (tenzij een eerdere vervaldatum werd vermeld bij aankoop).

Ja—binnen hun geldigheidsperiode. Ongebruikte credits blijven beschikbaar en worden van maand tot maand overgedragen totdat ze 12 maanden na aankoop verlopen.

Credits zijn niet-restitueerbaar. Koop alleen wat u nodig heeft—u kunt altijd later bijvullen. Als een platformfout een mislukte afschrijving veroorzaakt, kunnen we de getroffen credits herstellen na onderzoek. Geen geldteruggave.

Prijzen worden vastgesteld in credits, niet in dollars. Elk endpoint heeft zijn eigen kosten—zie de badge "Credits / verzoek" hierboven. U weet altijd precies wat u uitgeeft.

← Terug naar API's

Verkrijg credits om premium inhoud en functies te ontgrendelen

Klanttype

Factureringsland

API / Eindpunt

Valuta

Aantal verzoeken

E-mail Outreach-gids

List Press Releases

Voorbeeld

Antwoordvoorbeeld

Antwoordcodes

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Voorbeeld

Antwoordvoorbeeld

Antwoordcodes

Unlock Emails

Parameters

Code Samples

Response

List Categories

Voorbeeld

Antwoordvoorbeeld

Antwoordcodes

List Categories

Parameters

Code Samples

Response

Export Contacts

Voorbeeld

Antwoordvoorbeeld

Antwoordcodes

Export Contacts

Parameters

Code Samples

Response

Veelgestelde vragen

Waar komen de e-mailcontacten vandaan?

Hoe vers zijn de contacten?

Hoe werkt de prijsstelling?

Kan ik contacten exporteren?

Waarom zijn sommige e-mails gemaskeerd?

Tellen verzoeken met fouten mee en kosten ze credits?

Ik heb een bug gevonden of wil aanpassingen in de API's. Wat moet ik doen?

Wat is de snelheidslimiet?

Hoe werken betaling en gebruik?

Verlopen credits?

Worden ongebruikte credits overgedragen?

Bieden jullie restituties aan?

Hoeveel kost elke API-aanroep?