// العمليات المجمّعة
البحث المجمّع عن النطاقات
حمّل ملف CSV يحتوي على نطاقات الشركات واعثر على جميع عناوين البريد الإلكتروني المرتبطة بها دفعة واحدة.
- 01pending
POST /v1/bulk/search201 · { "data": { "id": 1042 } } - 02running
launch: trueالتقدّم يُستعلم عنه عبر GET /v1/bulk/search/1042/progress - 03completed
bulk.completedwebhook موقّع يُرسل إلى webhook_url الخاص بك
GET /v1/bulk/search/1042/download?file=fullيُخصم عند أول تنزيل · تنتهي صلاحية المهمة بعد 180 يومًا// 01 · المُدخلات
مُدخلات مهمة Domain Search المجمّعة
ارفع ملف CSV بحجم يصل إلى 4 MB في التطبيق، أو أرسل قائمة أو صفوفًا أو ملفًا إلى POST /v1/bulk/search. تُحدَّد الأعمدة من صف العناوين؛ اضبط فهرس الحقل لتختار عمودًا بنفسك.
/bulk/searchالأعمدةdomain_field_index- Domain
company_name_field_index- Company name
/bulk/searchالخياراتinput_type- domain or company; company when the input has a company name column and no domain column
max_emails_per_domain- Addresses per domain: 1, 10 (the default), 20, 50 or 100
email_type, email_type_mode- all (the default), personal or generic; only (the default) or priority
departments, departments_mode- Department names such as ["sales", "marketing"]; only or priority
verify_emails- true verifies the addresses found
find_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
boost_score_from_sources- true adds 10 points, up to 90, to an unverified address found on at least 5 pages
// 02 · api
طلب واحد يبدأ المهمة
أنشئها وشغّلها في استدعاء واحد، ثم تابع تقدّمها أو استقبل حدث bulk.completed موقّعًا. كل صف في النتائج هو ما يعيده GET /domain-search.
curl -X POST "https://api.tomba.io/v1/bulk/search" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/search", {
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": "Domain Search job",
"list": "piedpiper.com\nshopify.com\nnotion.so",
"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/search",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Domain Search job",
"list": "piedpiper.com\nshopify.com\nnotion.so",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"organization": {
"website_url": "piedpiper.com",
"organization": "Pied Piper",
"location": {
"country": "US",
"city": "Palo Alto",
"state": "CA",
"street_address": "5230 Newell Road",
"postal_code": "94303"
},
"social_links": {
"twitter_url": null,
"facebook_url": null,
"instagram_url": null,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"github_url": null,
"youtube_url": null,
"pinterest_url": null,
"tiktok_url": null
},
"disposable": false,
"webmail": false,
"phone_number": false,
"industries": "computer software",
"founded": "2014",
"company_size": "11-50",
"company_type": "privately held",
"revenue": null,
"accept_all": false,
"description": "Middle-out compression for files and video.",
"pattern": "{first}",
"total_similar": 2,
"keywords": [
"compression",
"middle-out",
"decentralized internet"
],
"ranking": null,
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"last_updated": "2025-01-15T10:32:00+01:00"
},
"emails": [
{
"email": "dinesh@piedpiper.com",
"first_name": "Dinesh",
"last_name": "Chugtai",
"full_name": "Dinesh Chugtai",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Software Engineer",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 99,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"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
}
]
},
{
"email": "gilfoyle@piedpiper.com",
"first_name": "Bertram",
"last_name": "Gilfoyle",
"full_name": "Bertram Gilfoyle",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Systems Architect",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 97,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"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
}
]
}
]
},
"meta": {
"total": 12,
"pageSize": 10,
"current": 1,
"total_pages": 2,
"params": {
"domain": "piedpiper.com",
"company": "",
"page": 1,
"limit": 10,
"department": "engineering",
"country": null,
"type": "all",
"live": false,
"enrich_mobile": false,
"webhook_url": null
}
}
}// 03 · التكلفة والحدود
تكلفة المهمة
لا يُخصم شيء عند إنشاء المهمة أو تشغيلها. تُخصم تكلفتها مرة واحدة، عند أول تنزيل لنتائجها.
// الفوترة لكل صف
Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.
فوترة المهام المجمّعة في الوثائق- الصفوف: حتى 25,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 · استخدمه في أي مكان
شغّل مهام Domain Search من التطبيق أو من كودك
المهمة نفسها والأرصدة نفسها: ارفع ملفًا في التطبيق، أو استدعِ API، أو اعمل من جدول بيانات أو أداة بدون كود.
- REST APIJSON عبر HTTPS، و13 SDK، وwebhooks موقّعة.
GET /v1/domain-search - CSV مجمّعارفع قائمة في التطبيق أو أرسلها عبر POST إلى /bulk؛ ونزّلها عند الانتهاء.
POST /v1/bulk/{type} - Google Sheets وExcelصيغ وشريط جانبي يستدعيان نقاط النهاية نفسها.
=TOMBA_SEARCH(A2) - Zapier وMake وn8nإجراءات بدون كود للبحث والتحقق والإثراء.
Zapier · Make · n8n · Pipedream
مرجع الطلب الكامل: /api/bulk/domain-search
// اختبار مقارنة على 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% عُثر عليها من أسماء الشركات: تحتاج الأداة إلى موقع ويب أو نطاق.