Danh bạ E-mail Tiếp cận

Địa chỉ e-mail liên hệ báo chí mới nhất được phân nhóm theo ngành.

API FAQ

Lấy API Key Mua tín dụng

Endpoint:

99.9 % Thời gian hoạt động

494ms Phản hồi

20 req/s

0.01 Tín dụng / yêu cầu

List Press Releases


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

Tham số	Loại	Bắt buộc	Mô tả
`api_key`	string	có	Your API key
`category`	string	tùy chọn	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	tùy chọn	Only show press releases from the last N days (0 = all time)
`page`	integer	tùy chọn	Page number (default: 1)
`per_page`	integer	tùy chọn	Results per page, max 100 (default: 20)

Ví dụ

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

Ví dụ phản hồi

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

Mã phản hồi

Mã	Mô tả
200 Success	Yêu cầu xử lý thành công.
400 Bad Request	Xác thực đầu vào thất bại.
401 Unauthorized	API Key thiếu hoặc sai.
403 Forbidden	Key không hoạt động hoặc không được phép.
429 Rate Limit	Quá nhiều yêu cầu.
500 Server Error	Lỗi không mong đợi.

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

Tham số	Loại	Bắt buộc	Mô tả
`api_key`	string	có	Your API key
`mails`	array	có	Array of email addresses to unlock

Ví dụ

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

Ví dụ phản hồi

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

Mã phản hồi

Mã	Mô tả
200 Success	Yêu cầu xử lý thành công.
400 Bad Request	Xác thực đầu vào thất bại.
401 Unauthorized	API Key thiếu hoặc sai.
403 Forbidden	Key không hoạt động hoặc không được phép.
429 Rate Limit	Quá nhiều yêu cầu.
500 Server Error	Lỗi không mong đợi.

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

Tham số	Loại	Bắt buộc	Mô tả
`api_key`	string	có	Your API key

Ví dụ

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

Ví dụ phản hồi

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

Mã phản hồi

Mã	Mô tả
200 Success	Yêu cầu xử lý thành công.
400 Bad Request	Xác thực đầu vào thất bại.
401 Unauthorized	API Key thiếu hoặc sai.
403 Forbidden	Key không hoạt động hoặc không được phép.
429 Rate Limit	Quá nhiều yêu cầu.
500 Server Error	Lỗi không mong đợi.

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

Tham số	Loại	Bắt buộc	Mô tả
`api_key`	string	có	Your API key
`format`	string	tùy chọn	Export format: json or csv (default: json)
`category`	string	tùy chọn	Filter exported contacts by category

Ví dụ

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

Ví dụ phản hồi

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

Mã phản hồi

Mã	Mô tả
200 Success	Yêu cầu xử lý thành công.
400 Bad Request	Xác thực đầu vào thất bại.
401 Unauthorized	API Key thiếu hoặc sai.
403 Forbidden	Key không hoạt động hoặc không được phép.
429 Rate Limit	Quá nhiều yêu cầu.
500 Server Error	Lỗi không mong đợi.

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

Câu hỏi thường gặp

Mỗi liên hệ được trích xuất từ thông cáo báo chí trả phí hoặc đơn đặt hàng bài viết khách qua các dịch vụ phân phối đối tác. Công ty đã đầu tư vào phân phối nên đang tích cực tìm kiếm sự đưa tin.

Thông cáo báo chí mới được thu thập hàng ngày từ nhiều dịch vụ phân phối. Bạn có thể lọc theo độ mới (1, 7 hoặc 30 ngày) để chỉ nhận các liên hệ mới nhất.

1 tín dụng mở khóa 1 địa chỉ email hoàn toàn mới. Email đã mở khóa được truy cập lại miễn phí. Các endpoint danh sách và danh mục tốn một phần nhỏ tín dụng.

Có. Sử dụng endpoint xuất để tải tất cả liên hệ đã mở khóa dưới dạng JSON hoặc CSV, tùy chọn lọc theo danh mục.

Email bạn chưa mở khóa bị ẩn một phần (ví dụ: j***@example.com). Sau khi mở khóa, địa chỉ đầy đủ được trả về trong tất cả các yêu cầu tiếp theo.

Có. Mọi yêu cầu, kể cả những yêu cầu có lỗi, đều tiêu tốn tín dụng. Tín dụng của bạn được gắn với số lượng yêu cầu, bất kể thành công hay thất bại. Nếu lỗi rõ ràng do sự cố nền tảng từ phía chúng tôi, chúng tôi sẽ khôi phục tín dụng bị ảnh hưởng (không hoàn tiền mặt).

Liên hệ chúng tôi tại [email protected]. Chúng tôi coi trọng phản hồi—nếu báo cáo lỗi hoặc yêu cầu tính năng của bạn có ý nghĩa, chúng tôi có thể sửa hoặc cải thiện API nhanh chóng và tặng bạn 50 tín dụng miễn phí để cảm ơn.

Tùy thuộc vào API và đôi khi cả endpoint. Một số endpoint sử dụng dữ liệu từ nguồn bên ngoài, có thể có giới hạn nghiêm ngặt hơn. Chúng tôi cũng áp dụng giới hạn để ngăn chặn lạm dụng và duy trì sự ổn định của nền tảng. Kiểm tra tài liệu để biết giới hạn cụ thể cho mỗi endpoint.

Chúng tôi hoạt động theo hệ thống tín dụng. Tín dụng là các đơn vị trả trước, không hoàn lại mà bạn chi cho các cuộc gọi API và công cụ. Tín dụng được tiêu thụ theo FIFO (cũ nhất trước) và có hiệu lực 12 tháng kể từ ngày mua. Bảng điều khiển hiển thị ngày mua và ngày hết hạn của mỗi giao dịch.

Có. Tất cả tín dụng đã mua (bao gồm số dư lẻ) có hiệu lực 12 tháng kể từ ngày mua. Tín dụng chưa sử dụng tự động hết hạn và bị xóa vĩnh viễn khi kết thúc thời hạn hiệu lực. Tín dụng đã hết hạn không thể khôi phục hoặc chuyển đổi thành tiền mặt hay giá trị khác. Quy tắc chuyển tiếp: tín dụng mua trước ngày 22 tháng 9 năm 2025 được coi là mua vào ngày 22 tháng 9 năm 2025 và hết hạn vào ngày 22 tháng 9 năm 2026 (trừ khi ngày hết hạn sớm hơn được ghi khi mua).

Có—trong thời hạn hiệu lực. Tín dụng chưa sử dụng vẫn khả dụng và được chuyển từ tháng sang tháng cho đến khi hết hạn 12 tháng sau khi mua.

Tín dụng là không hoàn lại. Chỉ mua những gì bạn cần—bạn luôn có thể nạp thêm sau. Nếu lỗi nền tảng gây ra tính phí thất bại, chúng tôi có thể khôi phục tín dụng bị ảnh hưởng sau khi điều tra. Không hoàn tiền mặt.

Giá được tính bằng tín dụng, không phải đô la. Mỗi endpoint có chi phí riêng—xem huy hiệu "Tín dụng / yêu cầu" ở trên. Bạn luôn biết chính xác mình đang chi bao nhiêu.

← Quay lại API

Nhận tín dụng để mở khóa nội dung và tính năng cao cấp

Loại khách hàng

Quốc gia thanh toán

API / Endpoint

Tiền tệ

Số yêu cầu

Danh bạ E-mail Tiếp cận

List Press Releases

Ví dụ

Ví dụ phản hồi

Mã phản hồi

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Ví dụ

Ví dụ phản hồi

Mã phản hồi

Unlock Emails

Parameters

Code Samples

Response

List Categories

Ví dụ

Ví dụ phản hồi

Mã phản hồi

List Categories

Parameters

Code Samples

Response

Export Contacts

Ví dụ

Ví dụ phản hồi

Mã phản hồi

Export Contacts

Parameters

Code Samples

Response

Câu hỏi thường gặp

Các liên hệ email đến từ đâu?

Các liên hệ mới đến mức nào?

Hệ thống giá hoạt động như thế nào?

Tôi có thể xuất liên hệ không?

Tại sao một số email bị ẩn?

Các yêu cầu có lỗi có được tính và tốn tín dụng không?

Tôi tìm thấy lỗi hoặc muốn tùy chỉnh API. Tôi phải làm gì?

Giới hạn yêu cầu là bao nhiêu?

Thanh toán và sử dụng hoạt động như thế nào?

Tín dụng có hết hạn không?

Tín dụng chưa sử dụng có được chuyển sang không?

Bạn có cung cấp hoàn tiền không?

Mỗi cuộc gọi API tốn bao nhiêu?