E-Mail-Outreach-Verzeichnis

Frische Presse-Kontakt-E-Mails, nach Branche gruppiert.

API FAQ

API-Schlüssel erhalten Credits kaufen

Endpoint:

99.9 % Verfügbarkeit

918ms Antwort

20 req/s

0.01 Credits / Anfrage

List Press Releases


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

Parameter	Typ	Erf.	Beschreibung
`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)

Beispiel

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

Antwortbeispiel

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

Antwortcodes

Code	Beschreibung
200 Success	Anfrage erfolgreich verarbeitet.
400 Bad Request	Eingabevalidierung fehlgeschlagen.
401 Unauthorized	Fehlender / falscher API-Schlüssel.
403 Forbidden	Schlüssel inaktiv oder nicht erlaubt.
429 Rate Limit	Zu viele Anfragen.
500 Server Error	Unerwarteter Fehler.

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	Typ	Erf.	Beschreibung
`api_key`	string	ja	Your API key
`mails`	array	ja	Array of email addresses to unlock

Beispiel

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

Antwortbeispiel

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

Antwortcodes

Code	Beschreibung
200 Success	Anfrage erfolgreich verarbeitet.
400 Bad Request	Eingabevalidierung fehlgeschlagen.
401 Unauthorized	Fehlender / falscher API-Schlüssel.
403 Forbidden	Schlüssel inaktiv oder nicht erlaubt.
429 Rate Limit	Zu viele Anfragen.
500 Server Error	Unerwarteter Fehler.

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	Typ	Erf.	Beschreibung
`api_key`	string	ja	Your API key

Beispiel

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

Antwortbeispiel

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

Antwortcodes

Code	Beschreibung
200 Success	Anfrage erfolgreich verarbeitet.
400 Bad Request	Eingabevalidierung fehlgeschlagen.
401 Unauthorized	Fehlender / falscher API-Schlüssel.
403 Forbidden	Schlüssel inaktiv oder nicht erlaubt.
429 Rate Limit	Zu viele Anfragen.
500 Server Error	Unerwarteter Fehler.

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	Typ	Erf.	Beschreibung
`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

Beispiel

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

Antwortbeispiel

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

Antwortcodes

Code	Beschreibung
200 Success	Anfrage erfolgreich verarbeitet.
400 Bad Request	Eingabevalidierung fehlgeschlagen.
401 Unauthorized	Fehlender / falscher API-Schlüssel.
403 Forbidden	Schlüssel inaktiv oder nicht erlaubt.
429 Rate Limit	Zu viele Anfragen.
500 Server Error	Unerwarteter Fehler.

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

Häufig gestellte Fragen

Jeder Kontakt wird aus einer bezahlten Pressemitteilung oder Gastbeitrags-Bestellung bei Partner-Wire-Services extrahiert. Das Unternehmen hat bereits in Distribution investiert und sucht daher aktiv nach Berichterstattung.

Neue Pressemitteilungen werden täglich von mehreren Nachrichtendiensten erfasst. Sie können nach Aktualität filtern (1, 7 oder 30 Tage), um nur die neuesten Kontakte zu erhalten.

1 Credit schaltet 1 brandneue E-Mail-Adresse frei. Bereits freigeschaltete E-Mails sind kostenlos erneut abrufbar. Die Listen- und Kategorie-Endpunkte kosten einen Bruchteil eines Credits.

Ja. Verwenden Sie den Export-Endpunkt, um alle freigeschalteten Kontakte als JSON oder CSV herunterzuladen, optional nach Kategorie gefiltert.

E-Mails, die Sie noch nicht freigeschaltet haben, sind teilweise maskiert (z. B. j***@example.com). Nach der Freischaltung wird die vollständige Adresse in allen folgenden Anfragen zurückgegeben.

Ja. Jede Anfrage, auch solche mit Fehlern, verbraucht Credits. Ihre Credits sind an die Anzahl der Anfragen gebunden, unabhängig von Erfolg oder Misserfolg. Wenn der Fehler eindeutig auf ein Plattformproblem unsererseits zurückzuführen ist, stellen wir die betroffenen Credits wieder her (keine Barerstattung).

Kontaktieren Sie uns unter [email protected]. Wir nehmen Feedback ernst—wenn Ihr Fehlerbericht oder Ihre Funktionsanfrage sinnvoll ist, können wir die API schnell korrigieren oder verbessern und Ihnen 50 kostenlose Credits als Dankeschön gewähren.

Es hängt von der API und manchmal sogar vom Endpoint ab. Einige Endpoints nutzen Daten aus externen Quellen, die strengere Limits haben können. Wir setzen auch Limits durch, um Missbrauch zu verhindern und unsere Plattform stabil zu halten. Prüfen Sie die Dokumentation für das spezifische Limit jedes Endpoints.

Wir arbeiten mit einem Creditsystem. Credits sind vorausbezahlte, nicht erstattungsfähige Einheiten, die Sie für API-Aufrufe und Tools ausgeben. Credits werden nach dem FIFO-Prinzip (älteste zuerst) verbraucht und sind 12 Monate ab Kaufdatum gültig. Das Dashboard zeigt jedes Kaufdatum und dessen Ablauf an.

Ja. Alle gekauften Credits (einschließlich Teilguthaben) sind 12 Monate ab Kauf gültig. Ungenutzte Credits verfallen automatisch und werden am Ende der Gültigkeitsdauer dauerhaft gelöscht. Verfallene Credits können nicht wiederhergestellt oder in Bargeld oder anderen Wert umgewandelt werden. Übergangsregel: Vor dem 22. Sep. 2025 gekaufte Credits gelten als am 22. Sep. 2025 gekauft und verfallen am 22. Sep. 2026 (sofern beim Kauf kein früherer Ablauf angegeben wurde).

Ja—innerhalb ihrer Gültigkeitsdauer. Ungenutzte Credits bleiben verfügbar und werden von Monat zu Monat übertragen, bis sie 12 Monate nach dem Kauf verfallen.

Credits sind nicht erstattungsfähig. Kaufen Sie nur, was Sie brauchen—Sie können jederzeit nachladen. Wenn ein plattformseitiger Fehler eine fehlgeschlagene Abbuchung verursacht, können wir die betroffenen Credits nach Prüfung wiederherstellen. Keine Barerstattung.

Preise werden in Credits angegeben, nicht in Dollar. Jeder Endpoint hat seine eigenen Kosten—siehe das Abzeichen „Credits / Anfrage" oben. Sie wissen immer genau, was Sie ausgeben.

← Zurück zu den APIs

Erwerben Sie Guthaben, um Premium-Inhalte und -Funktionen freizuschalten

Kundentyp

Rechnungsland

API / Endpunkt

Währung

Anzahl der Anfragen

E-Mail-Outreach-Verzeichnis

List Press Releases

Beispiel

Antwortbeispiel

Antwortcodes

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Beispiel

Antwortbeispiel

Antwortcodes

Unlock Emails

Parameters

Code Samples

Response

List Categories

Beispiel

Antwortbeispiel

Antwortcodes

List Categories

Parameters

Code Samples

Response

Export Contacts

Beispiel

Antwortbeispiel

Antwortcodes

Export Contacts

Parameters

Code Samples

Response

Häufig gestellte Fragen

Woher stammen die E-Mail-Kontakte?

Wie aktuell sind die Kontakte?

Wie funktioniert die Preisgestaltung?

Kann ich Kontakte exportieren?

Warum sind einige E-Mails maskiert?

Zählen fehlerhafte Anfragen und kosten sie Credits?

Ich habe einen Fehler gefunden oder möchte Anpassungen an den APIs. Was soll ich tun?

Was ist das Anfragelimit?

Wie funktioniert Bezahlung und Nutzung?

Verfallen Credits?

Werden ungenutzte Credits übertragen?

Bieten Sie Erstattungen an?

Wie viel kostet jeder API-Aufruf?