Директоријум е-маил контаката

Свежи е-маилови контаката за штампу груписани по индустрији.

API FAQ

Преузмите 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 позив?