Direktori Jangkauan E-mel

E-mel hubungan pers terkini yang dikumpulkan mengikut industri.

API FAQ

Dapatkan Kunci API Beli Kredit

Endpoint:

99.9 % Masa Aktif

918ms Respons

20 req/s

0.01 Kredit / permintaan

List Press Releases


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

Parameter	Jenis	Wajib	Penerangan
`api_key`	string	ya	Your API key
`category`	string	pilihan	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	pilihan	Only show press releases from the last N days (0 = all time)
`page`	integer	pilihan	Page number (default: 1)
`per_page`	integer	pilihan	Results per page, max 100 (default: 20)

Contoh

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

Contoh Respons

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

Kod Respons

Kod	Penerangan
200 Success	Permintaan diproses OK.
400 Bad Request	Pengesahan input gagal.
401 Unauthorized	Kunci API hilang / salah.
403 Forbidden	Kunci tidak aktif atau tidak dibenarkan.
429 Rate Limit	Terlalu banyak permintaan.
500 Server Error	Kegagalan tidak dijangka.

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

Parameter	Jenis	Wajib	Penerangan
`api_key`	string	ya	Your API key
`mails`	array	ya	Array of email addresses to unlock

Contoh

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

Contoh Respons

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

Kod Respons

Kod	Penerangan
200 Success	Permintaan diproses OK.
400 Bad Request	Pengesahan input gagal.
401 Unauthorized	Kunci API hilang / salah.
403 Forbidden	Kunci tidak aktif atau tidak dibenarkan.
429 Rate Limit	Terlalu banyak permintaan.
500 Server Error	Kegagalan tidak dijangka.

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

Parameter	Jenis	Wajib	Penerangan
`api_key`	string	ya	Your API key

Contoh

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

Contoh Respons

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

Kod Respons

Kod	Penerangan
200 Success	Permintaan diproses OK.
400 Bad Request	Pengesahan input gagal.
401 Unauthorized	Kunci API hilang / salah.
403 Forbidden	Kunci tidak aktif atau tidak dibenarkan.
429 Rate Limit	Terlalu banyak permintaan.
500 Server Error	Kegagalan tidak dijangka.

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

Parameter	Jenis	Wajib	Penerangan
`api_key`	string	ya	Your API key
`format`	string	pilihan	Export format: json or csv (default: json)
`category`	string	pilihan	Filter exported contacts by category

Contoh

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

Contoh Respons

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

Kod Respons

Kod	Penerangan
200 Success	Permintaan diproses OK.
400 Bad Request	Pengesahan input gagal.
401 Unauthorized	Kunci API hilang / salah.
403 Forbidden	Kunci tidak aktif atau tidak dibenarkan.
429 Rate Limit	Terlalu banyak permintaan.
500 Server Error	Kegagalan tidak dijangka.

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

Soalan Lazim

Setiap kenalan diekstrak daripada siaran akhbar berbayar atau pesanan pos tetamu di perkhidmatan pengedaran rakan kongsi. Syarikat telah melabur dalam pengedaran dan sedang aktif mencari liputan media.

Siaran akhbar baharu dikumpul setiap hari daripada pelbagai perkhidmatan pengedaran. Anda boleh menapis mengikut kebaruan (1, 7 atau 30 hari) untuk mendapatkan hanya kenalan terkini.

1 kredit membuka kunci 1 alamat e-mel baharu. E-mel yang sudah dibuka kunci percuma untuk diakses semula. Titik akhir senarai dan kategori memerlukan sebahagian kecil kredit.

Ya. Gunakan titik akhir eksport untuk memuat turun semua kenalan yang dibuka kunci sebagai JSON atau CSV, dengan penapis pilihan mengikut kategori.

E-mel yang belum anda buka kunci bertopeng sebahagian (cth. j***@example.com). Selepas dibuka kunci, alamat penuh dikembalikan dalam semua permintaan seterusnya.

Ya. Setiap permintaan, termasuk yang menghasilkan ralat, menggunakan kredit. Kredit anda terikat kepada bilangan permintaan, tanpa mengira kejayaan atau kegagalan. Jika ralat jelas disebabkan oleh masalah platform di pihak kami, kami akan memulihkan kredit yang terjejas (tiada bayaran balik tunai).

Hubungi kami di [email protected]. Kami mengambil maklum balas dengan serius—jika laporan pepijat atau permintaan ciri anda bermakna, kami boleh memperbaiki atau menambah baik API dengan cepat dan memberikan anda 50 kredit percuma sebagai penghargaan.

Ia bergantung pada API dan kadangkala pada endpoint. Sesetengah endpoint menggunakan data dari sumber luaran, yang mungkin mempunyai had yang lebih ketat. Kami juga menguatkuasakan had untuk mencegah penyalahgunaan dan mengekalkan kestabilan platform kami. Semak dokumentasi untuk had khusus setiap endpoint.

Kami beroperasi dengan sistem kredit. Kredit ialah unit prabayar yang tidak boleh dikembalikan yang anda belanjakan untuk panggilan API dan alatan. Kredit digunakan secara FIFO (yang paling lama dahulu) dan sah selama 12 bulan dari tarikh pembelian. Papan pemuka menunjukkan setiap tarikh pembelian dan tamat tempohnya.

Ya. Semua kredit yang dibeli (termasuk baki pecahan) sah selama 12 bulan dari pembelian. Kredit yang tidak digunakan tamat tempoh secara automatik dan dipadam secara kekal pada akhir tempoh sah. Kredit yang tamat tempoh tidak boleh dipulihkan atau ditukar kepada tunai atau nilai lain. Peraturan peralihan: kredit yang dibeli sebelum 22 Sep 2025 dianggap dibeli pada 22 Sep 2025 dan tamat tempoh pada 22 Sep 2026 (melainkan tamat tempoh lebih awal dinyatakan semasa pembelian).

Ya—dalam tempoh sah mereka. Kredit yang tidak digunakan kekal tersedia dan dibawa dari bulan ke bulan sehingga tamat tempoh 12 bulan selepas pembelian.

Kredit adalah tidak boleh dikembalikan. Beli hanya apa yang anda perlukan—anda sentiasa boleh menambah nilai kemudian. Jika ralat platform menyebabkan caj gagal, kami mungkin memulihkan kredit yang terjejas selepas siasatan. Tiada bayaran balik tunai.

Harga ditetapkan dalam kredit, bukan dolar. Setiap endpoint mempunyai kosnya sendiri—lihat lencana "Kredit / permintaan" di atas. Anda akan sentiasa tahu dengan tepat berapa yang anda belanjakan.

← Kembali ke API

Dapatkan kredit untuk membuka kandungan dan ciri premium

Jenis Pelanggan

Negara Pengebilan

API / Titik Akhir

Mata Wang

Bilangan permintaan

Direktori Jangkauan E-mel

List Press Releases

Contoh

Contoh Respons

Kod Respons

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Contoh

Contoh Respons

Kod Respons

Unlock Emails

Parameters

Code Samples

Response

List Categories

Contoh

Contoh Respons

Kod Respons

List Categories

Parameters

Code Samples

Response

Export Contacts

Contoh

Contoh Respons

Kod Respons

Export Contacts

Parameters

Code Samples

Response

Soalan Lazim

Dari mana datangnya kenalan e-mel?

Berapa segar kenalan tersebut?

Bagaimana sistem penentuan harga berfungsi?

Bolehkah saya mengeksport kenalan?

Mengapa sesetengah e-mel bertopeng?

Adakah permintaan dengan ralat dikira dan memakan kredit?

Saya menemui pepijat atau mahu penyesuaian dalam API. Apa yang perlu dilakukan?

Apakah had kadar permintaan?

Bagaimana pembayaran dan penggunaan berfungsi?

Adakah kredit tamat tempoh?

Adakah kredit yang tidak digunakan dibawa ke hadapan?

Adakah anda menawarkan bayaran balik?

Berapakah kos setiap panggilan API?