Adresář pro e-mailový outreach

Čerstvé e-mailové kontakty na tiskové oddělení, roztříděné podle odvětví.

API FAQ

Získat API klíč Koupit kredity

Endpoint:

99.9 % Dostupnost

918ms Odpověď

20 req/s

0.01 Kredity / požadavek

List Press Releases


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

Parametr	Typ	Povinný	Popis
`api_key`	string	ano	Your API key
`category`	string	volitelný	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	volitelný	Only show press releases from the last N days (0 = all time)
`page`	integer	volitelný	Page number (default: 1)
`per_page`	integer	volitelný	Results per page, max 100 (default: 20)

Příklad

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

Příklad odpovědi

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

Kódy odpovědí

Kód	Popis
200 Success	Požadavek zpracován OK.
400 Bad Request	Validace vstupu selhala.
401 Unauthorized	Chybějící / nesprávný API klíč.
403 Forbidden	Klíč neaktivní nebo nepovolený.
429 Rate Limit	Příliš mnoho požadavků.
500 Server Error	Neočekávaná chyba.

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

Parametr	Typ	Povinný	Popis
`api_key`	string	ano	Your API key
`mails`	array	ano	Array of email addresses to unlock

Příklad

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

Příklad odpovědi

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

Kódy odpovědí

Kód	Popis
200 Success	Požadavek zpracován OK.
400 Bad Request	Validace vstupu selhala.
401 Unauthorized	Chybějící / nesprávný API klíč.
403 Forbidden	Klíč neaktivní nebo nepovolený.
429 Rate Limit	Příliš mnoho požadavků.
500 Server Error	Neočekávaná chyba.

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

Parametr	Typ	Povinný	Popis
`api_key`	string	ano	Your API key

Příklad

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

Příklad odpovědi

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

Kódy odpovědí

Kód	Popis
200 Success	Požadavek zpracován OK.
400 Bad Request	Validace vstupu selhala.
401 Unauthorized	Chybějící / nesprávný API klíč.
403 Forbidden	Klíč neaktivní nebo nepovolený.
429 Rate Limit	Příliš mnoho požadavků.
500 Server Error	Neočekávaná chyba.

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

Parametr	Typ	Povinný	Popis
`api_key`	string	ano	Your API key
`format`	string	volitelný	Export format: json or csv (default: json)
`category`	string	volitelný	Filter exported contacts by category

Příklad

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

Příklad odpovědi

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

Kódy odpovědí

Kód	Popis
200 Success	Požadavek zpracován OK.
400 Bad Request	Validace vstupu selhala.
401 Unauthorized	Chybějící / nesprávný API klíč.
403 Forbidden	Klíč neaktivní nebo nepovolený.
429 Rate Limit	Příliš mnoho požadavků.
500 Server Error	Neočekávaná chyba.

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

Často kladené otázky

Každý kontakt je extrahován z placené tiskové zprávy nebo objednávky guest-postu u partnerských wire-služeb. Společnost již investovala do distribuce, takže aktivně hledá mediální pokrytí.

Nové tiskové zprávy se sbírají denně z několika wire-služeb. Můžete filtrovat podle čerstvosti (1, 7 nebo 30 dní) a získat jen nejnovější kontakty.

1 kredit odemkne 1 zbrusu novou e-mailovou adresu. Již odemknuté e-maily jsou zdarma k opětovnému přístupu. Endpointy pro seznam a kategorie stojí zlomek kreditu.

Ano. Použijte endpoint pro export ke stažení všech odemknutých kontaktů jako JSON nebo CSV, volitelně filtrovaných podle kategorie.

E-maily, které jste ještě neodemkli, jsou částečně maskované (např. j***@example.com). Po odemknutí se plná adresa vrací ve všech následujících požadavcích.

Ano. Každý požadavek, i ten s chybou, spotřebovává kredity. Vaše kredity jsou vázány na počet požadavků, bez ohledu na úspěch nebo neúspěch. Pokud je chyba jasně způsobena problémem platformy na naší straně, obnovíme dotčené kredity (bez peněžních refundací).

Kontaktujte nás na [email protected]. Zpětnou vazbu bereme vážně—pokud je váš report chyby nebo žádost o funkci smysluplná, můžeme API rychle opravit nebo vylepšit a poskytnout vám 50 bezplatných kreditů jako poděkování.

Závisí na API a někdy i na endpointu. Některé endpointy používají data z externích zdrojů, které mohou mít přísnější limity. Limity také vynucujeme, abychom zabránili zneužití a udrželi stabilitu platformy. Konkrétní limit pro každý endpoint naleznete v dokumentaci.

Fungujeme na kreditovém systému. Kredity jsou předplacené, nevratné jednotky, které utrácíte za API volání a nástroje. Kredity se spotřebovávají FIFO (nejstarší první) a jsou platné 12 měsíců od data nákupu. Dashboard zobrazuje datum každého nákupu a jeho expirace.

Ano. Všechny zakoupené kredity (včetně zlomkových zůstatků) jsou platné 12 měsíců od nákupu. Nevyužité kredity automaticky expirují a jsou trvale smazány na konci období platnosti. Expirované kredity nelze obnovit ani převést na hotovost nebo jinou hodnotu. Přechodné pravidlo: kredity zakoupené před 22. 9. 2025 se považují za zakoupené 22. 9. 2025 a expirují 22. 9. 2026 (pokud nebyla při nákupu uvedena dřívější expirace).

Ano—v rámci období platnosti. Nevyužité kredity zůstávají dostupné a převádějí se z měsíce na měsíc, dokud neexpirují 12 měsíců po nákupu.

Kredity jsou nevratné. Kupujte pouze to, co potřebujete—vždy si můžete dobit později. Pokud chyba na straně platformy způsobí neúspěšné stržení, můžeme po prošetření obnovit dotčené kredity. Žádné peněžní refundace.

Ceny jsou stanoveny v kreditech, ne v dolarech. Každý endpoint má svou vlastní cenu—viz odznak „Kredity / požadavek" výše. Vždy přesně víte, kolik utrácíte.

← Zpět na API

Získejte kredity pro odemknutí prémiového obsahu a funkcí

Typ zákazníka

Fakturační země

API / Endpoint

Měna

Počet požadavků

Adresář pro e-mailový outreach

List Press Releases

Příklad

Příklad odpovědi

Kódy odpovědí

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Příklad

Příklad odpovědi

Kódy odpovědí

Unlock Emails

Parameters

Code Samples

Response

List Categories

Příklad

Příklad odpovědi

Kódy odpovědí

List Categories

Parameters

Code Samples

Response

Export Contacts

Příklad

Příklad odpovědi

Kódy odpovědí

Export Contacts

Parameters

Code Samples

Response

Často kladené otázky

Odkud pocházejí e-mailové kontakty?

Jak čerstvé jsou kontakty?

Jak funguje cenotvorba?

Mohu exportovat kontakty?

Proč jsou některé e-maily maskované?

Počítají se požadavky s chybami a stojí kredity?

Našel jsem chybu nebo chci úpravy v API. Co mám dělat?

Jaký je limit požadavků?

Jak funguje platba a použití?

Expirují kredity?

Převádějí se nevyužité kredity?

Nabízíte refundace?

Kolik stojí každé API volání?