التوثيق/أداة البحث عن البريد الإلكتروني

API أداة البحث عن البريد الإلكتروني

اعثروا على بريد إلكتروني مهني موثّق باستخدام الاسم الأول واسم العائلة ونطاق الشركة.

عرض Markdown OpenAPI JSON
قاعدة الفوترة

تكلفة أداة البحث عن البريد الإلكتروني 20 رصيدًا فقط عند العثور على بريد إلكتروني موثّق. لا تُحتسب أي تكلفة على النتائج غير الموثّقة أو المدخلات غير الصالحة أو نتائج catch-all. تتطلب الطلبات بالجملة وطلبات CSV رصيدًا حاليًا كافيًا لعناوين البريد الموثّقة التي قد تُرجعها المهمة.

كيف يعمل

  1. ما ترسلونه first_name, last_name، و domain.
  2. تتحقق VeriMails من الاسم والنطاق المُرسلين بحثًا عن صندوق بريد شخصي موثّق.
  3. لا تُرجع النتيجة إلا بعد التحقق المباشر.
  4. إذا تعذّر تأكيد صندوق بريد موثّق، تُرجع الواجهة البرمجية not_found أو catch_all.
  5. عند البحث عن الأشخاص، تُرجع VeriMails عنوانًا شخصيًا موثّقًا متى أمكن تأكيده.

البحث عن بريد إلكتروني واحد

POST /api/find-email

استخدموا هذا للبحث عن العناوين واحدًا تلو الآخر من تطبيقكم أو أدوات فريقكم.

الحقلمطلوبالوصف
first_nameنعمالاسم الأول للشخص.
last_nameنعماسم العائلة للشخص.
domainنعمنطاق الشركة، مثل acme.com. تتولى الواجهة البرمجية توحيد صيغة عناوين URL.
cURL
curl -X POST https://verimails.com/api/find-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","domain":"company.com"}'
JSON
{
  "found": true,
  "email": "jane.doe@company.com",
  "status": "found",
  "confidence": 0.95,
  "elapsed_ms": 420
}

البحث عن ما يصل إلى 100 بريد إلكتروني بشكل متزامن

استخدموا نقطة النهاية المتزامنة للتحقق بالجملة مع الدفعات الصغيرة. أما الملفات الأكبر فاستخدموا لها مسار CSV أدناه.

cURL
curl -X POST https://verimails.com/api/find-email/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      {"first_name":"Jane","last_name":"Doe","domain":"company.com"},
      {"first_name":"Sam","last_name":"Lee","domain":"example.com"}
    ]
  }'

البحث عن البريد الإلكتروني عبر CSV

ارفعوا ملف CSV عندما تحتاجون إلى العثور على عناوين البريد على نطاق واسع. يجب أن يتضمن الملف أعمدة الاسم الأول واسم العائلة والنطاق. ومن الأسماء البديلة المدعومة firstname, lastname, company_domain, website، و company_website.

CSV
first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com
cURL
curl -X POST https://verimails.com/api/find-email/csv \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv"

curl https://verimails.com/api/find-email/csv/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://verimails.com/api/find-email/csv/JOB_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" -o finder_results.csv

يُضيف ملف CSV الناتج found_email, finder_status, finder_confidence، و finder_elapsed_ms.

الحالات

الحالةالمعنىالفوترة
foundتم العثور على بريد إلكتروني موثّق.مُحتسب
not_foundلم يُعثر على بريد إلكتروني شخصي موثّق.بدون تكلفة
catch_allيقبل النطاق العناوين العامة، لذا يتعذّر تأكيد صندوق البريد.بدون تكلفة
invalid_inputحقول الاسم أو النطاق المطلوبة مفقودة.بدون تكلفة
insufficient_creditsلا يحتوي حسابكم على أرصدة كافية لسعة الطلب.بدون تكلفة