Director de Contacte E-mail

Adrese de e-mail proaspete pentru contacte de presă, grupate pe industrie.

API FAQ

Obțineți cheia API Cumpărați credite

Endpoint:

99.9 % Disponibilitate

918ms Răspuns

20 req/s

0.01 Credite / cerere

List Press Releases


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

Parametru	Tip	Oblig.	Descriere
`api_key`	string	da	Your API key
`category`	string	opțional	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	opțional	Only show press releases from the last N days (0 = all time)
`page`	integer	opțional	Page number (default: 1)
`per_page`	integer	opțional	Results per page, max 100 (default: 20)

Exemplu

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

Exemplu de răspuns

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

Coduri de răspuns

Cod	Descriere
200 Success	Cerere procesată OK.
400 Bad Request	Validarea intrării a eșuat.
401 Unauthorized	Cheie API lipsă sau incorectă.
403 Forbidden	Cheie inactivă sau nepermisă.
429 Rate Limit	Prea multe cereri.
500 Server Error	Eroare neașteptată.

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

Parametru	Tip	Oblig.	Descriere
`api_key`	string	da	Your API key
`mails`	array	da	Array of email addresses to unlock

Exemplu

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

Exemplu de răspuns

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

Coduri de răspuns

Cod	Descriere
200 Success	Cerere procesată OK.
400 Bad Request	Validarea intrării a eșuat.
401 Unauthorized	Cheie API lipsă sau incorectă.
403 Forbidden	Cheie inactivă sau nepermisă.
429 Rate Limit	Prea multe cereri.
500 Server Error	Eroare neașteptată.

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

Parametru	Tip	Oblig.	Descriere
`api_key`	string	da	Your API key

Exemplu

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

Exemplu de răspuns

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

Coduri de răspuns

Cod	Descriere
200 Success	Cerere procesată OK.
400 Bad Request	Validarea intrării a eșuat.
401 Unauthorized	Cheie API lipsă sau incorectă.
403 Forbidden	Cheie inactivă sau nepermisă.
429 Rate Limit	Prea multe cereri.
500 Server Error	Eroare neașteptată.

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

Parametru	Tip	Oblig.	Descriere
`api_key`	string	da	Your API key
`format`	string	opțional	Export format: json or csv (default: json)
`category`	string	opțional	Filter exported contacts by category

Exemplu

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

Exemplu de răspuns

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

Coduri de răspuns

Cod	Descriere
200 Success	Cerere procesată OK.
400 Bad Request	Validarea intrării a eșuat.
401 Unauthorized	Cheie API lipsă sau incorectă.
403 Forbidden	Cheie inactivă sau nepermisă.
429 Rate Limit	Prea multe cereri.
500 Server Error	Eroare neașteptată.

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

Întrebări frecvente

Fiecare contact este extras dintr-un comunicat de presă plătit sau comandă de articol invitat pe servicii de distribuție partenere. Compania a investit deja în distribuție și caută activ acoperire mediatică.

Comunicate de presă noi sunt colectate zilnic din mai multe servicii de distribuție. Poți filtra după prospețime (1, 7 sau 30 de zile) pentru a obține doar cele mai recente contacte.

1 credit deblochează 1 adresă de e-mail nouă. E-mailurile deja deblocate sunt gratuite pentru acces repetat. Endpoint-urile de listă și categorii costă o fracțiune de credit.

Da. Folosește endpoint-ul de export pentru a descărca toate contactele deblocate ca JSON sau CSV, opțional filtrate pe categorie.

E-mailurile pe care nu le-ai deblocat încă sunt parțial mascate (ex. j***@example.com). După deblocare, adresa completă este returnată în toate cererile ulterioare.

Da. Fiecare cerere, chiar și cele care rezultă în erori, consumă credite. Creditele tale sunt legate de numărul de cereri, indiferent de succes sau eșec. Dacă eroarea este clar cauzată de o problemă a platformei din partea noastră, vom restaura creditele afectate (fără rambursări în numerar).

Contactați-ne la [email protected]. Luăm feedback-ul în serios—dacă raportul de bug sau cererea de funcționalitate este semnificativă, putem repara sau îmbunătăți API-ul rapid și vă acordăm 50 de credite gratuite ca mulțumire.

Depinde de API și uneori chiar de endpoint. Unele endpoint-uri folosesc date din surse externe, care pot avea limite mai stricte. De asemenea, aplicăm limite pentru a preveni abuzul și a menține platforma stabilă. Verificați documentația pentru limita specifică a fiecărui endpoint.

Funcționăm pe un sistem de credite. Creditele sunt unități preplătite, nerambursabile, pe care le cheltuiți pe apeluri API și instrumente. Creditele sunt consumate FIFO (cele mai vechi mai întâi) și sunt valabile 12 luni de la data achiziției. Panoul de control afișează fiecare dată de achiziție și expirarea sa.

Da. Toate creditele achiziționate (inclusiv soldurile fracționare) sunt valabile 12 luni de la achiziție. Creditele neutilizate expiră automat și sunt șterse permanent la sfârșitul perioadei de valabilitate. Creditele expirate nu pot fi restaurate sau convertite în numerar sau altă valoare. Regulă tranzitorie: creditele cumpărate înainte de 22 sept. 2025 sunt tratate ca achiziționate pe 22 sept. 2025 și expiră pe 22 sept. 2026 (cu excepția cazului în care a fost indicată o expirare anterioară la achiziție).

Da—în cadrul perioadei de valabilitate. Creditele neutilizate rămân disponibile și se transferă din lună în lună până expiră la 12 luni de la achiziție.

Creditele sunt nerambursabile. Cumpărați doar ce aveți nevoie—puteți oricând reîncărca mai târziu. Dacă o eroare a platformei cauzează o debitare eșuată, putem restaura creditele afectate după investigare. Fără rambursări în numerar.

Prețurile sunt stabilite în credite, nu în dolari. Fiecare endpoint are propriul cost—vedeți insigna „Credite / cerere" de mai sus. Veți ști întotdeauna exact cât cheltuiți.

← Înapoi la API-uri

Obțineți credite pentru a debloca conținut și funcții premium

Tip client

Țara de facturare

API / Endpoint

Monedă

Număr de cereri

Director de Contacte E-mail

List Press Releases

Exemplu

Exemplu de răspuns

Coduri de răspuns

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Exemplu

Exemplu de răspuns

Coduri de răspuns

Unlock Emails

Parameters

Code Samples

Response

List Categories

Exemplu

Exemplu de răspuns

Coduri de răspuns

List Categories

Parameters

Code Samples

Response

Export Contacts

Exemplu

Exemplu de răspuns

Coduri de răspuns

Export Contacts

Parameters

Code Samples

Response

Întrebări frecvente

De unde provin contactele de e-mail?

Cât de proaspete sunt contactele?

Cum funcționează prețurile?

Pot exporta contactele?

De ce sunt unele e-mailuri mascate?

Cererile cu erori sunt contorizate și costă credite?

Am găsit un bug sau vreau personalizări în API-uri. Ce fac?

Care este limita de cereri?

Cum funcționează plata și utilizarea?

Creditele expiră?

Creditele neutilizate se transferă?

Oferiți rambursări?

Cât costă fiecare apel API?