الانتقال إلى المحتوى

// get /v1/email-verifier

API التحقق من البريد الإلكتروني API

تحقق من قابلية تسليم البريد الإلكتروني في الوقت الفعلي مع فحوصات SMTP والتحقق من MX واكتشاف catch-all عبر API RESTful.

1 verification credit

// وحدة تحكم api

GETapi.tomba.io/v1/email-verifier
مثال استجابة من مرجع API
email.email
richard@piedpiper.com
email.result
deliverable
email.status
valid
email.score
99
email.smtp_provider
Google
email.accept_all
false
email.disposable
false
email.webmail
false
email.greylisted
false

// 01 · الطلب

Email Verifier هو طلب HTTPS واحد

أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.

GET/email-verifierالمعامل
emailمطلوب
The address to verify
enrich_mobilefalse
Also return phone numbers
curl "https://api.tomba.io/v1/email-verifier?email=richard%40piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · الاستجابة

ما يُعاد إليك

JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.

GET/email-verifierالحقل
data.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.

الأخطاء واستجابات 429 و451 وتكرار الطلب نفسه ضمن نافذة استخدامك لا تكلّف شيئًا.

كيف تعمل الأرصدة

// حدود المعدّل

الطلبات في الثانية / الدقيقة / اليوم
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 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. حدود المعدّل

// الأسئلة الشائعة

أسئلة API التحقق من البريد الإلكتروني

هل لديك أسئلة أخرى؟ زُر مركز المساعدة

// البدء السريع

نفّذ أول استدعاء لك في دقيقة

حساب مجاني، ومفتاح API حقيقي، ونقاط النهاية نفسها التي يستخدمها عملاء Enterprise.

  1. 1أنشئ حسابًا مجانيًا25 عملية بحث شهريًا. دون بطاقة.
  2. 2انسخ مفتاحك وسرّكمن مفاتيح API في لوحة التحكم.
  3. 3استدعِ APIالصق الطلب؛ والإجابة بصيغة JSON.
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
الاستجابة
200 OK· 1 search credit
{
  "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": []
  }
}