// العمليات المجمّعة
البحث المجمّع عن البريد الإلكتروني
حمّل ملف CSV يحتوي على الأسماء والنطاقات للعثور على جميع عناوين البريد الإلكتروني المهنية دفعة واحدة.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueالتقدّم يُستعلم عنه عبر GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedwebhook موقّع يُرسل إلى webhook_url الخاص بك
GET /v1/bulk/finder/1042/download?file=fullيُخصم عند أول تنزيل · تنتهي صلاحية المهمة بعد 180 يومًا// 01 · المُدخلات
مُدخلات مهمة Email Finder المجمّعة
ارفع ملف CSV بحجم يصل إلى 4 MB في التطبيق، أو أرسل قائمة أو صفوفًا أو ملفًا إلى POST /v1/bulk/finder. تُحدَّد الأعمدة من صف العناوين؛ اضبط فهرس الحقل لتختار عمودًا بنفسك.
/bulk/finderالأعمدةdomain_field_index- Domain
company_name_field_index- Company name
first_name_field_index, last_name_field_index- First name, last name
full_name_field_index- Full name
/bulk/finderالخياراتfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
skip_rows_with_email- true skips rows that already have a value in an email column
// 02 · api
طلب واحد يبدأ المهمة
أنشئها وشغّلها في استدعاء واحد، ثم تابع تقدّمها أو استقبل حدث bulk.completed موقّعًا. كل صف في النتائج هو ما يعيده GET /email-finder.
curl -X POST "https://api.tomba.io/v1/bulk/finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Conference leads","data":[["first_name","last_name","company_website"],["Richard","Hendricks","piedpiper.com"]],"launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/finder", {
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": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.com"
]
],
"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/finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.com"
]
],
"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
}
],
"phone_data": []
}
}// 03 · التكلفة والحدود
تكلفة المهمة
لا يُخصم شيء عند إنشاء المهمة أو تشغيلها. تُخصم تكلفتها مرة واحدة، عند أول تنزيل لنتائجها.
// الفوترة لكل صف
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
فوترة المهام المجمّعة في الوثائق- الصفوف: حتى 10,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 · استخدمه في أي مكان
شغّل مهام Email Finder من التطبيق أو من كودك
المهمة نفسها والأرصدة نفسها: ارفع ملفًا في التطبيق، أو استدعِ API، أو اعمل من جدول بيانات أو أداة بدون كود.
- REST APIJSON عبر HTTPS، و13 SDK، وwebhooks موقّعة.
GET /v1/email-finder - CSV مجمّعارفع قائمة في التطبيق أو أرسلها عبر POST إلى /bulk؛ ونزّلها عند الانتهاء.
POST /v1/bulk/{type} - Google Sheets وExcelصيغ وشريط جانبي يستدعيان نقاط النهاية نفسها.
=TOMBA_FIND(A2, B2) - Zapier وMake وn8nإجراءات بدون كود للبحث والتحقق والإثراء.
Zapier · Make · n8n · Pipedream
مرجع الطلب الكامل: /api/bulk/email-finder
// اختبار مقارنة على 5,000 عميل محتمل
رسائل بريد إلكتروني صالحة أكثر من الأدوات الثماني الأخرى التي اختبرناها
بيانات حقيقية. المدخلات نفسها. دون تدخل بشري. شفافية كاملة. أجرينا اختبارًا مباشرًا بملف المدخلات نفسه المكوّن من 5,000 سطر عبر عدة أدوات للبحث عن البريد.
| الترتيب | الأداة | من مواقع الويب | من أسماء الشركات | الإجمالي |
|---|---|---|---|---|
| 1 | 2,02681.0% | 1,98979.6% | 4,015 | |
| 2 | 1,91876.7% | 1,95778.3% | 3,875 | |
| 3 | 1,88075.2% | 1,87775.1% | 3,757 | |
| 4 | 1,48359.3% | 1,61364.5% | 3,096 | |
| 5 | 1,00140.0% | 1,14145.6% | 2,142 | |
| 6 | 88735.5% | 99539.8% | 1,882 | |
| 7 | 1,05142.0% | 74930.0% | 1,800 | |
| 8 | 98839.5% | أقل من 1% عُثر عليها من أسماء الشركات: تحتاج الأداة إلى موقع ويب أو نطاق:190.8% | 1,007 | |
| 9 | 82433.0% | أقل من 1% عُثر عليها من أسماء الشركات: تحتاج الأداة إلى موقع ويب أو نطاق:220.9% | 846 |
عثرت Tomba.io على 4,015 بريدًا إلكترونيًا صالحًا من 5,000 عميلًا محتملًا: المرتبة #1 من بين 9 أدوات تم اختبارها.
اختبار أجرته Tomba بنفسها، فبراير 2026. ملف واحد من 5,000 عميل محتمل، 2,500 منها مع موقع الشركة و2,500 مع اسم الشركة فقط، مرّ عبر كل أداة دون أي تنظيف يدوي. لا تُحتسب إلا العناوين التي صنّفتها الأداة صالحة أو موثّقة؛ والنسب المئوية محسوبة من 2,500 مُدخل من كل نوع.
أقل من 1% عُثر عليها من أسماء الشركات: تحتاج الأداة إلى موقع ويب أو نطاق.