// العمليات المجمّعة
البحث المجمّع عن مؤلفي المقالات
حمّل ملف CSV يحتوي على روابط المقالات واعثر على عناوين البريد الإلكتروني لجميع المؤلفين دفعة واحدة.
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: trueالتقدّم يُستعلم عنه عبر GET /v1/bulk/author/1042/progress - 03completed
bulk.completedwebhook موقّع يُرسل إلى webhook_url الخاص بك
GET /v1/bulk/author/1042/download?file=fullيُخصم عند أول تنزيل · تنتهي صلاحية المهمة بعد 180 يومًا// 01 · المُدخلات
مُدخلات مهمة Author Finder المجمّعة
ارفع ملف CSV بحجم يصل إلى 4 MB في التطبيق، أو أرسل قائمة أو صفوفًا أو ملفًا إلى POST /v1/bulk/author. تُحدَّد الأعمدة من صف العناوين؛ اضبط فهرس الحقل لتختار عمودًا بنفسك.
/bulk/authorالأعمدةurl_field_index- Article URL
/bulk/authorالخياراتinclude_sources- true adds the web pages where each address was found
// 02 · api
طلب واحد يبدأ المهمة
أنشئها وشغّلها في استدعاء واحد، ثم تابع تقدّمها أو استقبل حدث bulk.completed موقّعًا. كل صف في النتائج هو ما يعيده GET /author-finder.
curl -X POST "https://api.tomba.io/v1/bulk/author" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Author Finder job","list":"https://piedpiper.com/blog/middle-out-compression","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/author", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Author Finder job",
"list": "https://piedpiper.com/blog/middle-out-compression",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/author",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Author Finder job",
"list": "https://piedpiper.com/blog/middle-out-compression",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"email": "richard@piedpiper.com",
"first_name": "Richard",
"last_name": "Hendricks",
"full_name": "Richard Hendricks",
"website_url": "piedpiper.com",
"company": "Pied Piper",
"pattern": "{first}",
"department": "executive",
"type": "personal",
"position": "CEO",
"country": "US",
"gender": "male",
"twitter": null,
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"score": 100,
"accept_all": false,
"phone_number": true,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
],
"info": {
"url": "https://piedpiper.com/blog/middle-out-compression",
"title": "Middle-out compression, explained",
"og_image": "https://piedpiper.com/blog/middle-out-compression/cover.png",
"description": "How middle-out compression reached a Weissman score of 5.2.",
"article_domain": "piedpiper.com",
"publisher_name": "Pied Piper",
"publish_date": "2025-03-04",
"candidates": [
{
"full_name": "Richard Hendricks",
"first_name": "Richard",
"last_name": "Hendricks",
"job_title": "CEO",
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"name_confidence": 0.98,
"score": 0.95,
"count": 3
}
]
}
}
}// 03 · التكلفة والحدود
تكلفة المهمة
لا يُخصم شيء عند إنشاء المهمة أو تشغيلها. تُخصم تكلفتها مرة واحدة، عند أول تنزيل لنتائجها.
// الفوترة لكل صف
1 search credit per article with an author address.
فوترة المهام المجمّعة في الوثائق- الصفوف: حتى 5,000 لكل مهمة
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
// 04 · استخدمه في أي مكان
شغّل مهام Author Finder من التطبيق أو من كودك
المهمة نفسها والأرصدة نفسها: ارفع ملفًا في التطبيق، أو استدعِ API، أو اعمل من جدول بيانات أو أداة بدون كود.
- REST APIJSON عبر HTTPS، و13 SDK، وwebhooks موقّعة.
GET /v1/author-finder - CSV مجمّعارفع قائمة في التطبيق أو أرسلها عبر POST إلى /bulk؛ ونزّلها عند الانتهاء.
POST /v1/bulk/{type} - Google Sheets وExcelصيغ وشريط جانبي يستدعيان نقاط النهاية نفسها.
=TOMBA_AUTHOR(A2) - Zapier وMake وn8nإجراءات بدون كود للبحث والتحقق والإثراء.
Zapier · Make · n8n · Pipedream
مرجع الطلب الكامل: /api/bulk/author-finder
// العملاء
فرق تشغّل مهام Author Finder
Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, VizmeTomba has been critical to my SEO and cold outreach workflow. None matched Tomba's accuracy or the depth of contact details it returns.
Henry HoeSEO & Sales Outreach Specialist