Директория за имейл контакти

Актуални имейли на прес контакти, групирани по индустрия.

API ЧЗВ

Вземете API ключ Купете кредити

Крайна точка:

99.9 % Време на работа

918ms Отговор

20 req/s

0.01 Кредити / заявка

List Press Releases


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

Параметър	Тип	Задл.	Описание
`api_key`	string	да	Your API key
`category`	string	опц	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	опц	Only show press releases from the last N days (0 = all time)
`page`	integer	опц	Page number (default: 1)
`per_page`	integer	опц	Results per page, max 100 (default: 20)

Пример

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

Пример за отговор

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

Кодове на отговор

Код	Описание
200 Success	Заявката е обработена успешно.
400 Bad Request	Неуспешна валидация на входните данни.
401 Unauthorized	Липсващ / грешен API ключ.
403 Forbidden	Ключът е неактивен или без достъп.
429 Rate Limit	Твърде много заявки.
500 Server Error	Неочаквана грешка.

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

Параметър	Тип	Задл.	Описание
`api_key`	string	да	Your API key
`mails`	array	да	Array of email addresses to unlock

Пример

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

Пример за отговор

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

Кодове на отговор

Код	Описание
200 Success	Заявката е обработена успешно.
400 Bad Request	Неуспешна валидация на входните данни.
401 Unauthorized	Липсващ / грешен API ключ.
403 Forbidden	Ключът е неактивен или без достъп.
429 Rate Limit	Твърде много заявки.
500 Server Error	Неочаквана грешка.

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

Параметър	Тип	Задл.	Описание
`api_key`	string	да	Your API key

Пример

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

Пример за отговор

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

Кодове на отговор

Код	Описание
200 Success	Заявката е обработена успешно.
400 Bad Request	Неуспешна валидация на входните данни.
401 Unauthorized	Липсващ / грешен API ключ.
403 Forbidden	Ключът е неактивен или без достъп.
429 Rate Limit	Твърде много заявки.
500 Server Error	Неочаквана грешка.

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

Параметър	Тип	Задл.	Описание
`api_key`	string	да	Your API key
`format`	string	опц	Export format: json or csv (default: json)
`category`	string	опц	Filter exported contacts by category

Пример

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

Пример за отговор

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

Кодове на отговор

Код	Описание
200 Success	Заявката е обработена успешно.
400 Bad Request	Неуспешна валидация на входните данни.
401 Unauthorized	Липсващ / грешен API ключ.
403 Forbidden	Ключът е неактивен или без достъп.
429 Rate Limit	Твърде много заявки.
500 Server Error	Неочаквана грешка.

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

Често задавани въпроси

Всеки контакт е извлечен от платено прес съобщение или поръчка за гост публикация в партньорски медийни мрежи. Компанията вече е инвестирала в разпространение, така че активно търси медийно покритие.

Нови прес съобщения се сканират ежедневно от множество медийни мрежи. Можете да филтрирате по давност (1, 7 или 30 дни), за да получите само най-новите контакти.

1 кредит отключва 1 чисто нов имейл адрес. Вече отключените имейли са безплатни за повторен достъп. Крайните точки за списък и категории струват малка част от кредит.

Да. Използвайте крайната точка за експорт, за да изтеглите всичките си отключени контакти като JSON или CSV, с опционално филтриране по категория.

Имейлите, които все още не сте отключили, са частично маскирани (напр. j***@example.com). След отключване пълният адрес се връща при всички последващи заявки.

Да. Всяка заявка, дори тази с грешка, изразходва кредити. Това е така, защото кредитите ви са обвързани с броя заявки, независимо от успеха или неуспеха. Ако грешката е ясно по наша вина, ще възстановим засегнатите кредити (без парично възстановяване).

Свържете се с нас на [email protected]. Приемаме обратната връзка сериозно — ако докладът ви за бъг или заявката за функционалност е смислена, можем да поправим или подобрим API-то бързо и да ви предоставим 50 безплатни кредита като благодарност.

Зависи от API-то и понякога дори от конкретната крайна точка. Някои крайни точки използват данни от външни източници, които може да имат по-строги ограничения. Ние също налагаме лимити за предотвратяване на злоупотреби и поддържане стабилността на платформата. Проверете документацията за конкретния лимит на всяка крайна точка.

Работим на кредитна система. Кредитите са предплатени, невъзстановими единици, които изразходвате за API извиквания и инструменти. Кредитите се изразходват FIFO (първи закупен, първи използван) и са валидни 12 месеца от датата на покупка. Таблото показва датата на покупка и изтичането на всяка покупка.

Да. Всички закупени кредити (включително дробни баланси) са валидни 12 месеца от покупката. Неизползваните кредити автоматично изтичат и се изтриват окончателно в края на периода на валидност. Изтеклите кредити не могат да бъдат възстановени или конвертирани в пари или друга стойност. Преходно правило: кредити, закупени преди 22 септ. 2025 г., се третират като закупени на 22 септ. 2025 г. и изтичат на 22 септ. 2026 г. (освен ако не е посочено по-ранно изтичане при покупката).

Да — в рамките на периода им на валидност. Неизползваните кредити остават налични и се прехвърлят от месец на месец, докато не изтекат 12 месеца след покупката.

Кредитите са невъзстановими. Купувайте само каквото ви трябва — винаги можете да заредите по-късно. Ако грешка от наша страна причини неуспешно таксуване, може да възстановим засегнатите кредити след проверка. Без парично възстановяване.

Цените са определени в кредити, не в долари. Всяка крайна точка посочва собствената си цена — вижте бадж „Кредити / заявка" по-горе. Винаги ще знаете точно колко изразходвате.

← Обратно към API-тата

Вземете кредити за достъп до премиум съдържание и функции

Тип клиент

Държава за фактуриране

API / Крайна точка

Валута

Брой заявки

Директория за имейл контакти

List Press Releases

Пример

Пример за отговор

Кодове на отговор

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Пример

Пример за отговор

Кодове на отговор

Unlock Emails

Parameters

Code Samples

Response

List Categories

Пример

Пример за отговор

Кодове на отговор

List Categories

Parameters

Code Samples

Response

Export Contacts

Пример

Пример за отговор

Кодове на отговор

Export Contacts

Parameters

Code Samples

Response

Често задавани въпроси

Откъде идват имейл контактите?

Колко актуални са контактите?

Как работи ценообразуването?

Мога ли да експортирам контакти?

Защо някои имейли са маскирани?

Заявки с грешки броят ли се и струват ли кредити?

Открих бъг или искам персонализации в API-тата. Какво да направя?

Какъв е лимитът на заявките?

Как работи плащането и употребата?

Изтичат ли кредитите?

Прехвърлят ли се неизползваните кредити?

Предлагате ли възстановяване на средства?

Колко струва всяко API извикване?