Katalog E-mail Outreach

Świeże kontakty e-mail do prasy pogrupowane według branż.

API FAQ

Pobierz klucz API Kup kredyty

Endpoint:

99.9 % Dostępność

918ms Odpowiedź

20 req/s

0.01 Kredyty / żądanie

List Press Releases


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

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

Przykład

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

Przykład odpowiedzi

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

Kody odpowiedzi

Kod	Opis
200 Success	Żądanie przetworzone OK.
400 Bad Request	Walidacja danych wejściowych nie powiodła się.
401 Unauthorized	Brakujący / nieprawidłowy klucz API.
403 Forbidden	Klucz nieaktywny lub niedozwolony.
429 Rate Limit	Zbyt wiele żądań.
500 Server Error	Nieoczekiwany błąd.

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	Wymagany	Opis
`api_key`	string	tak	Your API key
`mails`	array	tak	Array of email addresses to unlock

Przykład

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

Przykład odpowiedzi

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

Kody odpowiedzi

Kod	Opis
200 Success	Żądanie przetworzone OK.
400 Bad Request	Walidacja danych wejściowych nie powiodła się.
401 Unauthorized	Brakujący / nieprawidłowy klucz API.
403 Forbidden	Klucz nieaktywny lub niedozwolony.
429 Rate Limit	Zbyt wiele żądań.
500 Server Error	Nieoczekiwany błąd.

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	Wymagany	Opis
`api_key`	string	tak	Your API key

Przykład

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

Przykład odpowiedzi

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

Kody odpowiedzi

Kod	Opis
200 Success	Żądanie przetworzone OK.
400 Bad Request	Walidacja danych wejściowych nie powiodła się.
401 Unauthorized	Brakujący / nieprawidłowy klucz API.
403 Forbidden	Klucz nieaktywny lub niedozwolony.
429 Rate Limit	Zbyt wiele żądań.
500 Server Error	Nieoczekiwany błąd.

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	Wymagany	Opis
`api_key`	string	tak	Your API key
`format`	string	opcjonalny	Export format: json or csv (default: json)
`category`	string	opcjonalny	Filter exported contacts by category

Przykład

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

Przykład odpowiedzi

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

Kody odpowiedzi

Kod	Opis
200 Success	Żądanie przetworzone OK.
400 Bad Request	Walidacja danych wejściowych nie powiodła się.
401 Unauthorized	Brakujący / nieprawidłowy klucz API.
403 Forbidden	Klucz nieaktywny lub niedozwolony.
429 Rate Limit	Zbyt wiele żądań.
500 Server Error	Nieoczekiwany błąd.

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

Często zadawane pytania

Każdy kontakt jest wyodrębniany z płatnego komunikatu prasowego lub zamówienia guest-postu w partnerskich serwisach dystrybucji. Firma już zainwestowała w dystrybucję i aktywnie poszukuje relacji medialnych.

Nowe komunikaty prasowe są zbierane codziennie z wielu serwisów dystrybucji. Możesz filtrować według świeżości (1, 7 lub 30 dni), aby uzyskać tylko najnowsze kontakty.

1 kredyt odblokowuje 1 nowy adres e-mail. Już odblokowane e-maile są bezpłatne przy ponownym dostępie. Endpointy listy i kategorii kosztują ułamek kredytu.

Tak. Użyj endpointu eksportu, aby pobrać wszystkie odblokowane kontakty jako JSON lub CSV, opcjonalnie filtrowane według kategorii.

E-maile, których jeszcze nie odblokowałeś, są częściowo zamaskowane (np. j***@example.com). Po odblokowaniu pełny adres jest zwracany we wszystkich kolejnych zapytaniach.

Tak. Każde żądanie, nawet te zakończone błędem, zużywa kredyty. Twoje kredyty są powiązane z liczbą żądań, niezależnie od sukcesu lub niepowodzenia. Jeśli błąd jest wyraźnie spowodowany problemem platformy po naszej stronie, przywrócimy dotknięte kredyty (bez zwrotów gotówkowych).

Skontaktuj się z nami pod adresem [email protected]. Traktujemy opinie poważnie—jeśli Twój raport o błędzie lub prośba o funkcję jest sensowna, możemy szybko naprawić lub ulepszyć API i przyznać Ci 50 darmowych kredytów w podziękowaniu.

Zależy od API, a czasem nawet od endpointu. Niektóre endpointy korzystają z danych ze źródeł zewnętrznych, które mogą mieć surowsze limity. Wprowadzamy też limity, aby zapobiec nadużyciom i utrzymać stabilność platformy. Sprawdź dokumentację, aby poznać konkretny limit dla każdego endpointu.

Działamy w systemie kredytowym. Kredyty to przedpłacone, bezzwrotne jednostki, które wydajesz na wywołania API i narzędzia. Kredyty są zużywane metodą FIFO (najstarsze najpierw) i są ważne przez 12 miesięcy od daty zakupu. Panel wyświetla datę każdego zakupu i jego wygaśnięcia.

Tak. Wszystkie zakupione kredyty (w tym ułamkowe salda) są ważne przez 12 miesięcy od zakupu. Niewykorzystane kredyty automatycznie wygasają i są trwale usuwane na koniec okresu ważności. Wygasłych kredytów nie można przywrócić ani zamienić na gotówkę lub inną wartość. Reguła przejściowa: kredyty zakupione przed 22 wrz. 2025 traktowane są jako zakupione 22 wrz. 2025 i wygasają 22 wrz. 2026 (chyba że przy zakupie podano wcześniejszą datę wygaśnięcia).

Tak—w ramach okresu ważności. Niewykorzystane kredyty pozostają dostępne i są przenoszone z miesiąca na miesiąc, aż wygasną 12 miesięcy po zakupie.

Kredyty są bezzwrotne. Kupuj tylko to, czego potrzebujesz—zawsze możesz doładować później. Jeśli błąd platformy spowoduje nieudane obciążenie, możemy przywrócić dotknięte kredyty po zbadaniu sprawy. Bez zwrotów gotówkowych.

Ceny są ustalane w kredytach, nie w dolarach. Każdy endpoint ma własną cenę—zobacz odznakę „Kredyty / żądanie" powyżej. Zawsze będziesz dokładnie wiedzieć, ile wydajesz.

← Powrót do API

Kup kredyty, aby odblokowa\u0107 premium tre\u015bci i funkcje

Typ klienta

Kraj rozliczeniowy

API / Endpoint

Waluta

Liczba \u017c\u0105da\u0144

Katalog E-mail Outreach

List Press Releases

Przykład

Przykład odpowiedzi

Kody odpowiedzi

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Przykład

Przykład odpowiedzi

Kody odpowiedzi

Unlock Emails

Parameters

Code Samples

Response

List Categories

Przykład

Przykład odpowiedzi

Kody odpowiedzi

List Categories

Parameters

Code Samples

Response

Export Contacts

Przykład

Przykład odpowiedzi

Kody odpowiedzi

Export Contacts

Parameters

Code Samples

Response

Często zadawane pytania

Skąd pochodzą kontakty e-mail?

Jak świeże są kontakty?

Jak działa cennik?

Czy mogę eksportować kontakty?

Dlaczego niektóre e-maile są zamaskowane?

Czy żądania z błędami są liczone i kosztują kredyty?

Znalazłem błąd lub chcę dostosowania w API. Co mam zrobić?

Jaki jest limit żądań?

Jak działa płatność i użytkowanie?

Czy kredyty wygasają?

Czy niewykorzystane kredyty są przenoszone?

Czy oferujecie zwroty?

Ile kosztuje każde wywołanie API?