الانتقال إلى المحتوى
الصفحة الرئيسية لـ Tomba
ابدأ مجانًا

// منصة المطورين

API قوي لذكاء البريد الإلكتروني

ادمج البحث عن البريد الإلكتروني والتحقق والإثراء في تطبيقاتك. API RESTful مع حزم SDK لجميع اللغات الرئيسية.

احصل على مفتاح API مجانيمرجع API
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
GETapi.tomba.io/v1/domain-search
مثال
organization.organization
Pied Piper
organization.industries
computer software
organization.company_size
11-50
organization.pattern
{first}
organization.accept_all
false
emails
2 items
emails[0].email
dinesh@piedpiper.com
emails[0].position
Software Engineer
emails[0].verification.status
valid

// 01 · نقاط النهاية

كل نقطة نهاية، وتكلفتها، وصفحتها المرجعية

REST عبر HTTPS، وJSON للمُدخلات والمخرجات، وترويستان للمصادقة. عنوان URL الأساسي https://api.tomba.io/v1.

GET/email-finderA person's work email from their name and company domainالتكلفة:1 search creditيُخصم عند:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profileالتكلفة:1 search credit per 10 resultsيُخصم عند:At least one address is returned. 1 credit per 10 results requested with limit.
GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checksالتكلفة:1 verification creditيُخصم عند:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profilesالتكلفة:1 search creditيُخصم عند:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URLالتكلفة:1 search creditيُخصم عند:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an articleالتكلفة:1 search creditيُخصم عند:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URLالتكلفة:5 search creditsيُخصم عند:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and regionالتكلفة:1 search creditيُخصم عند:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filtersالتكلفة:1 search creditيُخصم عند:At least one company is returned.
GET/combined/findThe person and their company from one email addressالتكلفة:2 search creditsيُخصم عند:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socialsالتكلفة:1 search creditيُخصم عند:A company is returned.
GET/technologyThe technologies a website runs, by categoryالتكلفة:Freeيُخصم عند:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniorityالتكلفة:1 email count creditيُخصم عند:Every call.
GET/similarCompanies similar to a domain, with their industryالتكلفة:1 search credit per 10 resultsيُخصم عند:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their shareالتكلفة:1 email count creditيُخصم عند:Every successful call, including an empty result.
GET/locationWhere a company's people are, by countryالتكلفة:1 email count creditيُخصم عند:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handlesالتكلفة:1 search creditيُخصم عند:A person is returned.
عنوان URL الأساسي https://api.tomba.io/v1 · أرسل X-Tomba-Key وX-Tomba-Secret مع كل طلب.جميع نقاط النهاية في مرجع API

// 02 · المهام المجمّعة

مهام مجمّعة لقوائم تصل إلى 25,000 صف

أرسل عبر POST قائمة أو صفوفًا أو ملف CSV إلى /bulk/، واستقبل webhook موقّعًا عند انتهائها، وادفع مرة واحدة عند أول تنزيل.

نوع المهمة المجمّعةالمُدخلاتالحد الأقصى للصفوف
POST/bulk/searchDomains or company names25,000
POST/bulk/similarDomains or company names5,000
POST/bulk/companyDomains or company names25,000
POST/bulk/finderNames, with a domain or company name10,000
POST/bulk/enrichEmail addresses20,000
POST/bulk/linkedinLinkedIn profile URLs20,000
POST/bulk/authorArticle URLs5,000
POST/bulk/verifierEmail addresses20,000
POST/bulk/phone-finderEmail addresses, LinkedIn URLs or domains10,000
POST/bulk/phone-validatorPhone numbers, with an optional country10,000

مرّر أفقيًا لرؤية كل الأعمدة

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

الإنتاجية حسب الخطة

الحدود لكل حساب عبر جميع مفاتيحه. للمهام المجمّعة حدودها الخاصة.

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

الطلبات في الثانية / الدقيقة / اليوم
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. حدود المعدّل

// 04 · sdk والأدوات

13 SDK وCLI وخادم MCP

تغلّف المكتبات الرسمية نقاط النهاية نفسها؛ ويستخدم CLI وخادم MCP مفتاحك أو OAuth.

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

الأسئلة الشائعة حول API

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

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

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

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

  1. 01أنشئ حسابًا مجانيًا25 من أرصدة البحث كل 30 يومًا. دون بطاقة.
  2. 02انسخ مفتاحك وسرّكمن مفاتيح API في لوحة التحكم.
  3. 03استدعِ APIالصق الطلب؛ والإجابة بصيغة JSON.
احصل على مفتاح API مجانياقرأ التوثيق
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"
الاستجابة
200 OK
{
  "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": []
  }
}