API أداة البحث عن البريد الإلكتروني
اعثروا على بريد إلكتروني مهني موثّق باستخدام الاسم الأول واسم العائلة ونطاق الشركة.
تكلفة أداة البحث عن البريد الإلكتروني 20 رصيدًا فقط عند العثور على بريد إلكتروني موثّق. لا تُحتسب أي تكلفة على النتائج غير الموثّقة أو المدخلات غير الصالحة أو نتائج catch-all. تتطلب الطلبات بالجملة وطلبات CSV رصيدًا حاليًا كافيًا لعناوين البريد الموثّقة التي قد تُرجعها المهمة.
كيف يعمل
- ما ترسلونه
first_name,last_name، وdomain. - تتحقق VeriMails من الاسم والنطاق المُرسلين بحثًا عن صندوق بريد شخصي موثّق.
- لا تُرجع النتيجة إلا بعد التحقق المباشر.
- إذا تعذّر تأكيد صندوق بريد موثّق، تُرجع الواجهة البرمجية
not_foundأوcatch_all. - عند البحث عن الأشخاص، تُرجع VeriMails عنوانًا شخصيًا موثّقًا متى أمكن تأكيده.
البحث عن بريد إلكتروني واحد
استخدموا هذا للبحث عن العناوين واحدًا تلو الآخر من تطبيقكم أو أدوات فريقكم.
| الحقل | مطلوب | الوصف |
|---|---|---|
first_name | نعم | الاسم الأول للشخص. |
last_name | نعم | اسم العائلة للشخص. |
domain | نعم | نطاق الشركة، مثل acme.com. تتولى الواجهة البرمجية توحيد صيغة عناوين URL. |
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"}'
{
"found": true,
"email": "jane.doe@company.com",
"status": "found",
"confidence": 0.95,
"elapsed_ms": 420
}
البحث عن ما يصل إلى 100 بريد إلكتروني بشكل متزامن
استخدموا نقطة النهاية المتزامنة للتحقق بالجملة مع الدفعات الصغيرة. أما الملفات الأكبر فاستخدموا لها مسار CSV أدناه.
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.
first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com
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 | لا يحتوي حسابكم على أرصدة كافية لسعة الطلب. | بدون تكلفة |