Drejtoria e Kontakteve me E-mail

Adresa e-maili të freskëta për kontakte shtypi të grupuara sipas industrisë.

API FAQ

Merr çelësin API Bli kredite

Endpoint:

99.9 % Koha aktive

918ms Përgjigje

20 req/s

0.01 Kredite / kërkesë

List Press Releases


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

Parametri	Lloji	I detyrueshëm	Përshkrimi
`api_key`	string	po	Your API key
`category`	string	opsional	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	opsional	Only show press releases from the last N days (0 = all time)
`page`	integer	opsional	Page number (default: 1)
`per_page`	integer	opsional	Results per page, max 100 (default: 20)

Shembull

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

Shembull përgjigje

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

Kodet e përgjigjes

Kodi	Përshkrimi
200 Success	Kërkesa u përpunua me sukses.
400 Bad Request	Vërtetimi i hyrjes dështoi.
401 Unauthorized	Çelësi API mungon / është i gabuar.
403 Forbidden	Çelësi joaktiv ose i palejuar.
429 Rate Limit	Shumë kërkesa.
500 Server Error	Dështim i papritur.

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

Parametri	Lloji	I detyrueshëm	Përshkrimi
`api_key`	string	po	Your API key
`mails`	array	po	Array of email addresses to unlock

Shembull

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

Shembull përgjigje

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

Kodet e përgjigjes

Kodi	Përshkrimi
200 Success	Kërkesa u përpunua me sukses.
400 Bad Request	Vërtetimi i hyrjes dështoi.
401 Unauthorized	Çelësi API mungon / është i gabuar.
403 Forbidden	Çelësi joaktiv ose i palejuar.
429 Rate Limit	Shumë kërkesa.
500 Server Error	Dështim i papritur.

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

Parametri	Lloji	I detyrueshëm	Përshkrimi
`api_key`	string	po	Your API key

Shembull

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

Shembull përgjigje

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

Kodet e përgjigjes

Kodi	Përshkrimi
200 Success	Kërkesa u përpunua me sukses.
400 Bad Request	Vërtetimi i hyrjes dështoi.
401 Unauthorized	Çelësi API mungon / është i gabuar.
403 Forbidden	Çelësi joaktiv ose i palejuar.
429 Rate Limit	Shumë kërkesa.
500 Server Error	Dështim i papritur.

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

Parametri	Lloji	I detyrueshëm	Përshkrimi
`api_key`	string	po	Your API key
`format`	string	opsional	Export format: json or csv (default: json)
`category`	string	opsional	Filter exported contacts by category

Shembull

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

Shembull përgjigje

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

Kodet e përgjigjes

Kodi	Përshkrimi
200 Success	Kërkesa u përpunua me sukses.
400 Bad Request	Vërtetimi i hyrjes dështoi.
401 Unauthorized	Çelësi API mungon / është i gabuar.
403 Forbidden	Çelësi joaktiv ose i palejuar.
429 Rate Limit	Shumë kërkesa.
500 Server Error	Dështim i papritur.

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

Pyetje të bëra shpesh

Çdo kontakt nxirret nga një njoftim shtypi i paguar ose porosi artikulli mysafir në shërbimet e shpërndarjes partnere. Kompania ka investuar tashmë në shpërndarje dhe kërkon aktivisht mbulim mediatik.

Njoftimet e reja për shtyp mblidhen çdo ditë nga disa shërbime shpërndarjeje. Mund të filtroni sipas freskisë (1, 7 ose 30 ditë) për të marrë vetëm kontaktet më të reja.

1 kredit zhbllokon 1 adresë e-maili krejtësisht të re. E-mailet e zhbllokuara tashmë janë falas për qasje të përsëritur. Pikat përfundimtare të listës dhe kategorive kushtojnë një fraksion krediti.

Po. Përdorni pikën përfundimtare të eksportit për të shkarkuar të gjitha kontaktet e zhbllokuara si JSON ose CSV, me filtrim opsional sipas kategorisë.

E-mailet që nuk i keni zhbllokuar ende janë të maskuara pjesërisht (p.sh. j***@example.com). Pas zhbllokimit, adresa e plotë kthehet në të gjitha kërkesat e mëvonshme.

Po. Çdo kërkesë, edhe ato që rezultojnë në gabime, konsumon kredite. Kreditet tuaja janë të lidhura me numrin e kërkesave, pavarësisht suksesit ose dështimit. Nëse gabimi shkaktohet qartë nga një problem i platformës në anën tonë, do të rivendosim kreditet e prekura (pa rimbursime në para të gatshme).

Na kontaktoni në [email protected]. I marrim komentet seriozisht—nëse raporti juaj i defektit ose kërkesa për veçori është e arsyeshme, mund ta rregullojmë ose përmirësojmë API-në shpejt dhe t'ju japim 50 kredite falas si faleminderit.

Varet nga API-ja dhe ndonjëherë edhe nga endpoint-i. Disa endpoint-e përdorin të dhëna nga burime të jashtme, të cilat mund të kenë kufij më të rreptë. Gjithashtu zbatojmë kufij për të parandaluar abuzimin dhe për të mbajtur platformën tonë të qëndrueshme. Kontrolloni dokumentacionin për kufirin specifik të çdo endpoint-i.

Operojmë me një sistem kreditesh. Kreditet janë njësi të parapaguara, jo të rimbursueshme që i shpenzoni në thirrje API dhe mjete. Kreditet konsumohen sipas FIFO (më të vjetrat së pari) dhe janë të vlefshme për 12 muaj nga data e blerjes. Paneli tregon çdo datë blerjeje dhe skadimin e saj.

Po. Të gjitha kreditet e blera (përfshirë balancat fraksionale) janë të vlefshme për 12 muaj nga blerja. Kreditet e papërdorura skadojnë automatikisht dhe fshihen përgjithmonë në fund të periudhës së vlefshmërisë. Kreditet e skaduara nuk mund të rivendosen ose konvertohen në para të gatshme ose vlerë tjetër. Rregulli kalimtar: kreditet e blera para 22 shtatorit 2025 trajtohen si të blera më 22 shtator 2025 dhe skadojnë më 22 shtator 2026 (përveç nëse një skadim më i hershëm u deklarua gjatë blerjes).

Po—brenda periudhës së tyre të vlefshmërisë. Kreditet e papërdorura mbeten të disponueshme dhe barten nga muaji në muaj derisa të skadojnë 12 muaj pas blerjes.

Kreditet janë jo të rimbursueshme. Blini vetëm atë që ju duhet—gjithmonë mund të rimbushni më vonë. Nëse një gabim i platformës shkakton një debitim të dështuar, mund të rivendosim kreditet e prekura pas hetimit. Asnjë rimbursim në para të gatshme.

Çmimet janë caktuar në kredite, jo në dollarë. Çdo endpoint ka koston e vet—shikoni stemën "Kredite / kërkesë" më lart. Gjithmonë do të dini saktësisht sa po shpenzoni.

← Kthehu te API-të

Merrni kredite për të zhbllokuar përmbajtjen dhe veçoritë premium

Lloji i Klientit

Vendi i Faturimit

API / Pika Përfundimtare

Monedha

Numri i kërkesave

Drejtoria e Kontakteve me E-mail

List Press Releases

Shembull

Shembull përgjigje

Kodet e përgjigjes

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Shembull

Shembull përgjigje

Kodet e përgjigjes

Unlock Emails

Parameters

Code Samples

Response

List Categories

Shembull

Shembull përgjigje

Kodet e përgjigjes

List Categories

Parameters

Code Samples

Response

Export Contacts

Shembull

Shembull përgjigje

Kodet e përgjigjes

Export Contacts

Parameters

Code Samples

Response

Pyetje të bëra shpesh

Nga vijnë kontaktet e e-mailit?

Sa të freskëta janë kontaktet?

Si funksionon çmimi?

A mund t'i eksportoj kontaktet?

Pse disa e-maile janë të maskuara?

A numërohen kërkesat me gabime dhe a kushtojnë kredite?

Gjeta një defekt ose dua personalizime në API. Çfarë të bëj?

Cili është kufiri i kërkesave?

Si funksionon pagesa dhe përdorimi?

A skadojnë kreditet?

A barten kreditet e papërdorura?

A ofroni rimbursime?

Sa kushton çdo thirrje API?