Каталог контактів електронної пошти

Свіжі електронні адреси прес-контактів, згруповані за галуззю.

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

Часті запитання

Each contact is extracted from a paid press release or guest-post order on partner wire services. The company has already invested in distribution, so they are actively seeking coverage.

New press releases are scraped daily from multiple wire services. You can filter by recency (1, 7 or 30 days) to get only the latest contacts.

1 credit unlocks 1 brand-new email address. Already-unlocked emails are free to access again. The list and categories endpoints cost a fraction of a credit.

Yes. Use the export endpoint to download all your unlocked contacts as JSON or CSV, optionally filtered by category.

Emails you haven't unlocked yet are partially masked (e.g. j***@example.com). Once unlocked, the full address is returned in all subsequent requests.

Так. Кожен запит, навіть з помилкою, витрачає кредити. Ваші кредити прив'язані до кількості запитів, незалежно від успіху чи невдачі. Якщо помилка явно спричинена проблемою платформи з нашого боку, ми відновимо постраждалі кредити (без грошового повернення).

Зв'яжіться з нами за адресою [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

Часті запитання

Where do the email contacts come from?

How fresh are the contacts?

How does pricing work?

Can I export contacts?

Why are some emails masked?

Чи враховуються запити з помилками і чи коштують вони кредити?

Я знайшов помилку або хочу налаштування в API. Що робити?

Який ліміт запитів?

Як працює оплата та використання?

Чи закінчуються кредити?

Чи переносяться невикористані кредити?

Чи пропонуєте ви повернення коштів?

Скільки коштує кожен API-виклик?