// get /v1/email-verifier
API التحقق من البريد الإلكتروني API
تحقق من قابلية تسليم البريد الإلكتروني في الوقت الفعلي مع فحوصات SMTP والتحقق من MX واكتشاف catch-all عبر API RESTful.
1 verification credit
// وحدة تحكم api
مثالمثال استجابة من مرجع API
- email.email
- richard@piedpiper.com
- email.result
- deliverable
- email.status
- valid
- email.score
- 99
- email.smtp_provider
- email.accept_all
- false
- email.disposable
- false
- email.webmail
- false
- email.greylisted
- false
// 01 · الطلب
Email Verifier هو طلب HTTPS واحد
أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.
GET
/email-verifieremailمطلوب- The address to verify
enrich_mobilefalse- Also return phone numbers
curl -G https://api.tomba.io/v1/email-verifier \
--data-urlencode "email=richard@piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
email: "richard@piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/email-verifier?${params}`, {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/email-verifier",
params={
"email": "richard@piedpiper.com",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · الاستجابة
ما يُعاد إليك
JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.
GET
/email-verifierdata.email.resultstring- deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring- valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger- Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null- Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null- The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean- The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean- Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean- Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array- Where the address was found
data.phone_data[]array | null- Phone numbers, when you send enrich_mobile
GET /email-verifier
200 OK· 1 verification credit
{
"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 · التكلفة والحدود
تكلفة الاستدعاء
لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.
// التكلفة
1verification credit
يُخصم عند: The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
الأخطاء واستجابات 429 و451 وتكرار الطلب نفسه ضمن نافذة استخدامك لا تكلّف شيئًا.
كيف تعمل الأرصدة// حدود المعدّل
الطلبات في الثانية / الدقيقة / اليوم| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
مرّر أفقيًا لرؤية كل الأعمدة
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. حدود المعدّل
التحقق من التنسيق، سجلات MX، فحص صندوق بريد SMTP، اكتشاف catch-all، اكتشاف البريد المؤقت، علامة العنوان الوظيفي، فحص المزود المجاني، ومعالجة القائمة الرمادية.
نعم. كل خطة تتضمن أرصدة تحقق مطابقة بدون تكلفة إضافية.
نعم. تعالج واجهة API التحقق المجمّع من البريد الإلكتروني آلاف العناوين دفعة واحدة.
الحدود حسب الخطة، بالطلبات في الثانية / الدقيقة / اليوم: Free 1 / 2 / 10، Basic 2 / 40 / 500، Growth 3 / 60 / 1,000، Pro 5 / 100 / 4,000. لا حدود في Pro Plus وScale، وتسمح Enterprise بـ 100,000 طلب يوميًا دون حد في الثانية. تحمل كل استجابة ترويسات حدود الطلبات؛ راجع حدود الطلبات.
Deliverable تعني أن صندوق البريد موجود ويستقبل الرسائل. Undeliverable تعني أن العنوان يرتد. Risky تشمل نطاقات catch-all أو المشكلات المؤقتة. Unknown تعني أن الخادم لم يستجب.
نعم. يشير إلى العناوين المؤقتة من مزودين مثل Mailinator وGuerrilla Mail وأكثر من 3,000 نطاق مؤقت آخر.
فحوصات الصياغة تتحقق من الشكل فقط. أما Tomba فيجري مصافحة SMTP كاملة مع خادم البريد، ويفحص سجلات MX، ويكتشف عناوين catch-all والمؤقتة والعناوين الوظيفية.
نعم. تختلف أوقات الاستجابة حسب نقطة النهاية وصعوبة التحقق من العنوان، لذا اضبط مهلة سخية (تقترح الوثائق حتى 180 ثانية) واستخدم المهام المجمّعة أو Webhooks للأحجام الكبيرة.