// get /v1/email-finder
API البحث عن البريد الإلكتروني API
ابحث عن عناوين البريد الإلكتروني المهنية باستخدام الاسم ونطاق الشركة عبر API RESTful.
1 search credit
// وحدة تحكم api
مثالمثال استجابة من مرجع API
- richard@piedpiper.com
- full_name
- Richard Hendricks
- position
- CEO
- company
- Pied Piper
- score
- 100
- verification.status
- valid
- phone_number
- true
- accept_all
- false
- sources
- 1 item
// 01 · الطلب
Email Finder هو طلب HTTPS واحد
أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.
GET
/email-finderdomainpiedpiper.com- Company domain (or send company)
first_nameRichard- First name (or send full_name)
last_nameHendricks- Last name
enrich_mobilefalse- Also return phone numbers
webhook_urlhttps://example.com/webhook- Also POST the result to this URL
curl -G https://api.tomba.io/v1/email-finder \
--data-urlencode "domain=piedpiper.com" \
--data-urlencode "first_name=Richard" \
--data-urlencode "last_name=Hendricks" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
domain: "piedpiper.com",
first_name: "Richard",
last_name: "Hendricks"
});
const res = await fetch(`https://api.tomba.io/v1/email-finder?${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-finder",
params={
"domain": "piedpiper.com",
"first_name": "Richard",
"last_name": "Hendricks",
},
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-finderdata.emailstring | null- The address, or null when none is found
data.scoreinteger- Confidence from 0 to 100
data.verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null- Name, job title and team
data.typestring | null- personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null- Public profiles
data.sources[]array | null- Up to 20 public pages where the address was found, with dates
data.accept_allboolean | null- The domain accepts mail for any address (catch-all)
data.phone_numberboolean- Tomba holds a phone number for the person
data.phone_data[]array- The numbers, when you send enrich_mobile (each as in Phone Finder)
GET /email-finder
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": []
}
}// 03 · التكلفة والحدود
تكلفة الاستدعاء
لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.
// التكلفة
1search credit
يُخصم عند: An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
الأخطاء واستجابات 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. حدود المعدّل
بريد إلكتروني محقق، درجة ثقة (0-100)، الاسم الأول، اسم العائلة، المسمى الوظيفي، القسم، الأقدمية، البلد، رابط LinkedIn، Twitter، رقم الهاتف، اسم الشركة، نمط البريد الإلكتروني، روابط المصادر، وحالة التحقق.
لا. يُستهلك الرصيد فقط للنتائج الصالحة والقابلة للتسليم.
نعم. تُعاد أرقام الهواتف المباشرة عند توفرها بدون تكلفة رصيد إضافية.
نعم. تُعاد أرقام الهاتف المباشرة عند توفرها دون أرصدة إضافية.
13 حزمة SDK رسمية: C# وDart وDeno وElixir وGo وLua وNode.js وPerl وPHP وPython وR وRuby وRust.
تعتمد حدود المعدّل على خطتك ونقطة النهاية. تسردها الوثائق، ويعيد GET /v1/rate-limits الحدود التي تنطبق عليك. تختلف أوقات الاستجابة حسب نقطة النهاية وصعوبة التحقق من العنوان، لذا اضبط مهلة سخية (تقترح الوثائق حتى 180 ثانية) واستخدم المهام المجمّعة أو Webhooks للأحجام الكبيرة.
نعم. يعالج API Bulk Email Finder حتى 10,000 زوج من الاسم والنطاق في كل عملية عبر رفع ملف CSV أو طلبات API على دفعات.
درجة من 0 إلى 100 تعتمد على مطابقة النمط وعدد المصادر ونتيجة التحقق وحداثة البيانات. الدرجات الأعلى تعني احتمالًا أعلى لقابلية التسليم.