عناوين بريد إلكتروني حديثة للتواصل الصحفي مصنفة حسب القطاع.
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 | فشل غير متوقع. |
outreach/list
0.0100 credits
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 | فشل غير متوقع. |
outreach/unlock
1.0000 credits
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 | فشل غير متوقع. |
outreach/categories
0.0010 credits
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 | فشل غير متوقع. |
outreach/export
0.0500 credits