Directory E-mail Outreach

Contatti e-mail stampa freschi raggruppati per settore.

API FAQ

Ottieni chiave API Acquista crediti

Endpoint:

99.9 % Disponibilità

918ms Risposta

20 req/s

0.01 Crediti / richiesta

List Press Releases


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

Parametro	Tipo	Rich.	Descrizione
`api_key`	string	sì	Your API key
`category`	string	opz.	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	opz.	Only show press releases from the last N days (0 = all time)
`page`	integer	opz.	Page number (default: 1)
`per_page`	integer	opz.	Results per page, max 100 (default: 20)

Esempio

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

Esempio di risposta

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

Codici di risposta

Codice	Descrizione
200 Success	Richiesta elaborata OK.
400 Bad Request	Validazione input fallita.
401 Unauthorized	Chiave API mancante o errata.
403 Forbidden	Chiave inattiva o non consentita.
429 Rate Limit	Troppe richieste.
500 Server Error	Errore imprevisto.

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

Parametro	Tipo	Rich.	Descrizione
`api_key`	string	sì	Your API key
`mails`	array	sì	Array of email addresses to unlock

Esempio

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

Esempio di risposta

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

Codici di risposta

Codice	Descrizione
200 Success	Richiesta elaborata OK.
400 Bad Request	Validazione input fallita.
401 Unauthorized	Chiave API mancante o errata.
403 Forbidden	Chiave inattiva o non consentita.
429 Rate Limit	Troppe richieste.
500 Server Error	Errore imprevisto.

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

Parametro	Tipo	Rich.	Descrizione
`api_key`	string	sì	Your API key

Esempio

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

Esempio di risposta

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

Codici di risposta

Codice	Descrizione
200 Success	Richiesta elaborata OK.
400 Bad Request	Validazione input fallita.
401 Unauthorized	Chiave API mancante o errata.
403 Forbidden	Chiave inattiva o non consentita.
429 Rate Limit	Troppe richieste.
500 Server Error	Errore imprevisto.

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

Parametro	Tipo	Rich.	Descrizione
`api_key`	string	sì	Your API key
`format`	string	opz.	Export format: json or csv (default: json)
`category`	string	opz.	Filter exported contacts by category

Esempio

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

Esempio di risposta

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

Codici di risposta

Codice	Descrizione
200 Success	Richiesta elaborata OK.
400 Bad Request	Validazione input fallita.
401 Unauthorized	Chiave API mancante o errata.
403 Forbidden	Chiave inattiva o non consentita.
429 Rate Limit	Troppe richieste.
500 Server Error	Errore imprevisto.

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

Domande frequenti

Ogni contatto è estratto da un comunicato stampa a pagamento o da un ordine di guest-post su servizi di distribuzione partner. L'azienda ha già investito nella distribuzione, quindi cerca attivamente copertura mediatica.

Nuovi comunicati stampa vengono raccolti quotidianamente da più servizi di distribuzione. Puoi filtrare per recentità (1, 7 o 30 giorni) per ottenere solo i contatti più recenti.

1 credito sblocca 1 indirizzo e-mail nuovo di zecca. Le e-mail già sbloccate sono gratuite da consultare nuovamente. Gli endpoint lista e categorie costano una frazione di credito.

Sì. Usa l'endpoint di esportazione per scaricare tutti i tuoi contatti sbloccati come JSON o CSV, opzionalmente filtrati per categoria.

Le e-mail che non hai ancora sbloccato sono parzialmente mascherate (es. j***@example.com). Una volta sbloccate, l'indirizzo completo viene restituito in tutte le richieste successive.

Sì. Ogni richiesta, anche quelle che generano errori, consuma crediti. I tuoi crediti sono legati al numero di richieste, indipendentemente dal successo o dal fallimento. Se l'errore è chiaramente dovuto a un problema della piattaforma da parte nostra, ripristineremo i crediti interessati (nessun rimborso in contanti).

Contattaci a [email protected]. Prendiamo i feedback seriamente—se la tua segnalazione di bug o richiesta di funzionalità è significativa, possiamo correggere o migliorare l'API rapidamente e concederti 50 crediti gratuiti come ringraziamento.

Dipende dall'API e a volte anche dall'endpoint. Alcuni endpoint utilizzano dati da fonti esterne, che possono avere limiti più rigorosi. Imponiamo anche limiti per prevenire abusi e mantenere la nostra piattaforma stabile. Consulta la documentazione per il limite specifico di ogni endpoint.

Operiamo con un sistema di crediti. I crediti sono unità prepagate e non rimborsabili che spendi per chiamate API e strumenti. I crediti vengono consumati in ordine FIFO (i più vecchi per primi) e sono validi per 12 mesi dalla data di acquisto. La dashboard mostra ogni data di acquisto e la sua scadenza.

Sì. Tutti i crediti acquistati (inclusi i saldi frazionari) sono validi per 12 mesi dall'acquisto. I crediti non utilizzati scadono automaticamente e vengono eliminati permanentemente alla fine del periodo di validità. I crediti scaduti non possono essere ripristinati o convertiti in contanti o altro valore. Regola transitoria: i crediti acquistati prima del 22 set. 2025 sono trattati come acquistati il 22 set. 2025 e scadono il 22 set. 2026 (salvo diversa scadenza indicata all'acquisto).

Sì—entro il periodo di validità. I crediti non utilizzati rimangono disponibili e vengono riportati di mese in mese fino alla scadenza 12 mesi dopo l'acquisto.

I crediti sono non rimborsabili. Acquista solo ciò di cui hai bisogno—puoi sempre ricaricare in seguito. Se un errore della piattaforma causa un addebito fallito, possiamo ripristinare i crediti interessati dopo indagine. Nessun rimborso in contanti.

I prezzi sono fissati in crediti, non in dollari. Ogni endpoint ha il proprio costo—vedi il badge "Crediti / richiesta" sopra. Saprai sempre esattamente quanto stai spendendo.

← Torna alle API

Ottieni crediti per sbloccare contenuti e funzionalità premium

Tipo di cliente

Paese di fatturazione

API / Endpoint

Valuta

N. di richieste

Directory E-mail Outreach

List Press Releases

Esempio

Esempio di risposta

Codici di risposta

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Esempio

Esempio di risposta

Codici di risposta

Unlock Emails

Parameters

Code Samples

Response

List Categories

Esempio

Esempio di risposta

Codici di risposta

List Categories

Parameters

Code Samples

Response

Export Contacts

Esempio

Esempio di risposta

Codici di risposta

Export Contacts

Parameters

Code Samples

Response

Domande frequenti

Da dove provengono i contatti e-mail?

Quanto sono aggiornati i contatti?

Come funzionano i prezzi?

Posso esportare i contatti?

Perché alcune e-mail sono mascherate?

Le richieste con errori contano e costano crediti?

Ho trovato un bug o voglio personalizzazioni nelle API. Cosa faccio?

Qual è il limite di richieste?

Come funzionano il pagamento e l'utilizzo?

I crediti scadono?

I crediti non utilizzati vengono riportati?

Offrite rimborsi?

Quanto costa ogni chiamata API?