// العمليات المجمّعة
التحقق المجمّع من البريد الإلكتروني
حمّل ملف CSV يحتوي على عناوين البريد الإلكتروني وتحقق من قابليتها للتسليم دفعة واحدة.
- 01pending
POST /v1/bulk/verifier201 · { "data": { "id": 1042 } } - 02running
launch: trueالتقدّم يُستعلم عنه عبر GET /v1/bulk/verifier/1042/progress - 03completed
bulk.completedwebhook موقّع يُرسل إلى webhook_url الخاص بك
GET /v1/bulk/verifier/1042/download?file=fullيُخصم عند أول تنزيل · تنتهي صلاحية المهمة بعد 180 يومًا// 01 · المُدخلات
مُدخلات مهمة Email Verifier المجمّعة
ارفع ملف CSV بحجم يصل إلى 4 MB في التطبيق، أو أرسل قائمة أو صفوفًا أو ملفًا إلى POST /v1/bulk/verifier. تُحدَّد الأعمدة من صف العناوين؛ اضبط فهرس الحقل لتختار عمودًا بنفسك.
/bulk/verifierالأعمدةemail_field_index- Email address
/bulk/verifierالخياراتfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
// 02 · api
طلب واحد يبدأ المهمة
أنشئها وشغّلها في استدعاء واحد، ثم تابع تقدّمها أو استقبل حدث bulk.completed موقّعًا. كل صف في النتائج هو ما يعيده GET /email-verifier.
curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
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": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.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/verifier",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"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": null
}
}// 03 · التكلفة والحدود
تكلفة المهمة
لا يُخصم شيء عند إنشاء المهمة أو تشغيلها. تُخصم تكلفتها مرة واحدة، عند أول تنزيل لنتائجها.
// الفوترة لكل صف
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
فوترة المهام المجمّعة في الوثائق- الصفوف: حتى 20,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 Verifier من التطبيق أو من كودك
المهمة نفسها والأرصدة نفسها: ارفع ملفًا في التطبيق، أو استدعِ API، أو اعمل من جدول بيانات أو أداة بدون كود.
- REST APIJSON عبر HTTPS، و13 SDK، وwebhooks موقّعة.
GET /v1/email-verifier - CSV مجمّعارفع قائمة في التطبيق أو أرسلها عبر POST إلى /bulk؛ ونزّلها عند الانتهاء.
POST /v1/bulk/{type} - Google Sheets وExcelصيغ وشريط جانبي يستدعيان نقاط النهاية نفسها.
=TOMBA_VERIFY(A2) - Zapier وMake وn8nإجراءات بدون كود للبحث والتحقق والإثراء.
Zapier · Make · n8n · Pipedream
مرجع الطلب الكامل: /api/bulk/email-verifier
// العملاء
فرق تشغّل مهام Email Verifier
Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.ioThe data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation