Sähköposti-outreach-hakemisto — PR-yhteystietolistat | YEB

Selaa tuoreita, vahvistettuja lehdistöyhteystietojen sähköposteja toimialoittain. Avaa lämpimiä liidejä PR-aktiivisilta brändeiltä sponsorointeihin, vieraskirjoituksiin ja affiliate-outreach-kampanjoihin.

99.9 % Käytettävyys
918ms Vastaus
20 req/s
0.01 Krediitit / pyyntö

List Press Releases


POST https://api.yeb.to/v1/outreach/list
ParametriTyyppiVaadittuKuvaus
api_key string kyllä Your API key
category string valinnainen Filter by category (e.g. Technology, Healthcare & Pharma)
days integer valinnainen Only show press releases from the last N days (0 = all time)
page integer valinnainen Page number (default: 1)
per_page integer valinnainen Results per page, max 100 (default: 20)

Esimerkki

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

Vastausesimerkki

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

Vastauskoodit

KoodiKuvaus
200 SuccessPyyntö käsitelty OK.
400 Bad RequestSyötteen validointi epäonnistui.
401 UnauthorizedAPI-avain puuttuu tai on väärä.
403 ForbiddenAvain ei-aktiivinen tai ei sallittu.
429 Rate LimitLiian monta pyyntöä.
500 Server ErrorOdottamaton virhe.

List Press Releases

outreach/list 0.0100 credits

Parameters

API Key
body · string · required
Category
body · string
Days
body · string
Page
body · string
Per Page
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Unlock Emails


POST https://api.yeb.to/v1/outreach/unlock
ParametriTyyppiVaadittuKuvaus
api_key string kyllä Your API key
mails array kyllä Array of email addresses to unlock

Esimerkki

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

Vastausesimerkki

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

Vastauskoodit

KoodiKuvaus
200 SuccessPyyntö käsitelty OK.
400 Bad RequestSyötteen validointi epäonnistui.
401 UnauthorizedAPI-avain puuttuu tai on väärä.
403 ForbiddenAvain ei-aktiivinen tai ei sallittu.
429 Rate LimitLiian monta pyyntöä.
500 Server ErrorOdottamaton virhe.

Unlock Emails

outreach/unlock 1.0000 credits

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
ParametriTyyppiVaadittuKuvaus
api_key string kyllä Your API key

Esimerkki

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

Vastausesimerkki

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

Vastauskoodit

KoodiKuvaus
200 SuccessPyyntö käsitelty OK.
400 Bad RequestSyötteen validointi epäonnistui.
401 UnauthorizedAPI-avain puuttuu tai on väärä.
403 ForbiddenAvain ei-aktiivinen tai ei sallittu.
429 Rate LimitLiian monta pyyntöä.
500 Server ErrorOdottamaton virhe.

List Categories

outreach/categories 0.0010 credits

Parameters

API Key
body · string · required

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Export Contacts


POST https://api.yeb.to/v1/outreach/export
ParametriTyyppiVaadittuKuvaus
api_key string kyllä Your API key
format string valinnainen Export format: json or csv (default: json)
category string valinnainen Filter exported contacts by category

Esimerkki

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

Vastausesimerkki

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

Vastauskoodit

KoodiKuvaus
200 SuccessPyyntö käsitelty OK.
400 Bad RequestSyötteen validointi epäonnistui.
401 UnauthorizedAPI-avain puuttuu tai on väärä.
403 ForbiddenAvain ei-aktiivinen tai ei sallittu.
429 Rate LimitLiian monta pyyntöä.
500 Server ErrorOdottamaton virhe.

Export Contacts

outreach/export 0.0500 credits

Parameters

API Key
body · string · required
Format
body · string
Category
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Usein kysytyt kysymykset

Jokainen kontakti on poimittu maksetusta lehdistötiedotteesta tai vieraskirjoitustilauksesta kumppanien jakelupalveluissa. Yritys on jo investoinut jakeluun ja etsii aktiivisesti mediahuomiota.

Uusia lehdistötiedotteita kerätään päivittäin useilta jakelupalveluilta. Voit suodattaa tuoreuden mukaan (1, 7 tai 30 päivää) saadaksesi vain uusimmat kontaktit.

1 krediitti avaa 1 upouuden sähköpostiosoitteen. Jo avatut sähköpostit ovat ilmaisia käyttää uudelleen. Lista- ja kategoriarajapinnat maksavat murto-osan krediitistä.

Kyllä. Käytä vientirajapintaa ladataksesi kaikki avatut kontaktisi JSON- tai CSV-muodossa, halutessasi suodatettuna kategorian mukaan.

Sähköpostit, joita et ole vielä avannut, ovat osittain peitettyjä (esim. j***@example.com). Avaamisen jälkeen täydellinen osoite palautetaan kaikissa seuraavissa pyynnöissä.

Kyllä. Jokainen pyyntö, myös virheelliset, kuluttaa krediittejä. Krediittisi on sidottu pyyntöjen määrään riippumatta onnistumisesta tai epäonnistumisesta. Jos virhe johtuu selvästi alustamme ongelmasta, palautamme vaikutetut krediitit (ei käteispalautuksia).

Ota meihin yhteyttä osoitteessa [email protected]. Otamme palautteen vakavasti—jos virheraporttisi tai ominaisuuspyyntösi on mielekäs, voimme korjata tai parantaa API:a nopeasti ja myöntää sinulle 50 ilmaista krediittiä kiitokseksi.

Se riippuu API:sta ja joskus jopa endpointista. Jotkut endpointit käyttävät ulkoisten lähteiden dataa, joilla voi olla tiukemmat rajat. Asetamme myös rajoja väärinkäytön estämiseksi ja alustamme vakauden ylläpitämiseksi. Tarkista dokumentaatiosta kunkin endpointin tarkka raja.

Toimimme krediittijärjestelmällä. Krediitit ovat ennakkoon maksettuja, ei-palautettavia yksiköitä, joita käytät API-kutsuihin ja työkaluihin. Krediitit kulutetaan FIFO-periaatteella (vanhimmat ensin) ja ne ovat voimassa 12 kuukautta ostopäivästä. Hallintapaneeli näyttää kunkin oston päivämäärän ja vanhenemisen.

Kyllä. Kaikki ostetut krediitit (mukaan lukien osittaiset saldot) ovat voimassa 12 kuukautta ostosta. Käyttämättömät krediitit vanhenevat automaattisesti ja poistetaan pysyvästi voimassaolokauden lopussa. Vanhentuneita krediittejä ei voi palauttaa tai muuntaa rahaksi tai muuksi arvoksi. Siirtymäsääntö: ennen 22.9.2025 ostetut krediitit käsitellään kuin ne olisi ostettu 22.9.2025, ja ne vanhenevat 22.9.2026 (ellei ostossa ilmoitettu aikaisempaa vanhenemista).

Kyllä—voimassaolokauden sisällä. Käyttämättömät krediitit pysyvät saatavilla ja siirtyvät kuukaudesta toiseen, kunnes ne vanhenevat 12 kuukautta oston jälkeen.

Krediitit ovat ei-palautettavia. Osta vain tarvitsemasi—voit aina ladata lisää myöhemmin. Jos alustavirhe aiheuttaa epäonnistuneen veloituksen, voimme palauttaa vaikutetut krediitit tutkimuksen jälkeen. Ei käteispalautuksia.

Hinnat on asetettu krediiteissä, ei dollareissa. Jokaisella endpointilla on oma hintansa—katso "Krediitit / pyyntö" -merkki yllä. Tiedät aina tarkalleen, mitä käytät.
← Takaisin API:hin