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

// get /v1/combined/find

API المدمج

احصل على بيانات الشخص والشركة معاً من عنوان بريد إلكتروني واحد الملفات الاجتماعية والتوظيف والبيانات الديموغرافية والمكدس التقني ومقاييس الأعمال في استدعاء API واحد. بديل مباشر لـ Clearbit Combined API.

احصل على مفتاح API مجانيمرجع API
2 search credits

// وحدة تحكم api

GETapi.tomba.io/v1/combined/find
مثال
person.name.fullName
Richard Hendricks
person.employment.title
CEO
person.verification.status
valid
company.name
Pied Piper
company.category.industry
Internet Software & Services
company.geo.city
Palo Alto
company.metrics.employees
11-50
company.foundedYear
2014

// 01 · الطلب

Person + Company هو طلب HTTPS واحد

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

GET/combined/find
emailمطلوب
Work email
curl -G https://api.tomba.io/v1/combined/find \
  --data-urlencode "email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

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

ما يُعاد إليك

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

GET/combined/find
data.personobject
Name, employment, location, social handles, verification (as in Person Enrichment)
data.person.employmentobject
Company, domain, title, role, seniority
data.companyobject
Name, industry codes, location, metrics, tech (as in Company Enrichment)
data.company.categoryobject
Sector, industry, SIC and NAICS codes
meta.emailstring
The address you sent
errorsobject
When nothing is found the response is still 200, with errors {type, message, code} instead of data
GET /combined/find
200 OK
{
  "data": {
    "person": {
      "name": {
        "fullName": "Richard Hendricks",
        "givenName": "Richard",
        "familyName": "Hendricks"
      },
      "email": "richard@piedpiper.com",
      "location": "Palo Alto, California, United States",
      "gender": "male",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "city": "Palo Alto",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "bio": "Founder of Pied Piper.",
      "site": "https://piedpiper.com",
      "avatar": null,
      "employment": {
        "domain": "piedpiper.com",
        "name": "Pied Piper",
        "title": "CEO",
        "role": "executive",
        "subRole": null,
        "seniority": "executive"
      },
      "facebook": {
        "handle": null
      },
      "github": {
        "handle": null,
        "id": null,
        "avatar": null,
        "company": null,
        "blog": null,
        "followers": null,
        "following": null
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "statuses": null,
        "favorites": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "linkedin": {
        "handle": "in/richard-hendricks"
      },
      "gravatar": {
        "handle": null,
        "urls": null,
        "avatar": null,
        "avatars": null
      },
      "verification": {
        "date": "2025-01-15T10:32:00+01:00",
        "status": "valid"
      },
      "phone": true,
      "fuzzy": false,
      "emailProvider": "Google",
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "activeAt": "2025-01-15T10:32:00+01:00",
      "inactiveAt": null
    },
    "company": {
      "name": "Pied Piper",
      "legalName": "Pied Piper, Inc.",
      "domain": "piedpiper.com",
      "domainAliases": [],
      "site": {
        "phoneNumbers": [],
        "emailAddresses": [
          "hello@piedpiper.com"
        ]
      },
      "category": {
        "sector": "Information Technology",
        "industryGroup": "Software & Services",
        "industry": "Internet Software & Services",
        "subIndustry": "Internet Software & Services",
        "sicCode": "73",
        "sic4Codes": [
          "7372"
        ],
        "naicsCode": "51",
        "naics6Codes": [
          "511210"
        ],
        "naics6Codes2022": [
          "513210"
        ]
      },
      "tags": [
        "Compression",
        "Decentralized internet"
      ],
      "description": "Middle-out compression for files and video.",
      "foundedYear": "2014",
      "location": "5230 Newell Road, Palo Alto, CA 94303, United States",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "streetNumber": "5230",
        "streetName": "Newell Road",
        "subPremise": null,
        "streetAddress": "5230 Newell Road",
        "city": "Palo Alto",
        "postalCode": "94303",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "logo": "https://logo.tomba.io/piedpiper.com",
      "facebook": {
        "handle": null,
        "likes": null
      },
      "linkedin": {
        "handle": "company/pied-piper"
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "emailProvider": "Google",
      "type": "private",
      "ticker": null,
      "identifiers": {
        "usEIN": null
      },
      "metrics": {
        "alexaUsRank": null,
        "alexaGlobalRank": null,
        "trafficRank": null,
        "employees": "11-50",
        "marketCap": null,
        "raised": null,
        "annualRevenue": null,
        "estimatedAnnualRevenue": null,
        "fiscalYearEnd": null
      },
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "tech": [
        "google_apps",
        "intercom"
      ],
      "techCategories": [
        "email_hosting_service",
        "live_chat"
      ],
      "parent": {
        "domain": null
      },
      "ultimateParent": {
        "domain": null
      }
    }
  },
  "meta": {
    "email": "richard@piedpiper.com"
  }
}

// 03 · التكلفة والحدود

تكلفة الاستدعاء

لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.

// التكلفة

2search credit

يُخصم عند: A person is returned.

الأخطاء واستجابات 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. حدود المعدّل

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

أسئلة حول Combined API

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

// ابدأ مجانًا

اكتشف من يجده Tomba في أي شركة

اكتب نطاق شركة لترى موظفيها وأدوارهم وعناوين بريدهم المهنية الموثّقة، مع الصفحات التي وُجد عليها كل عنوان. حساب مجاني، دون بطاقة.

تحدّث إلى فريق المبيعاتتبني على API؟ اقرأ دليل البدء السريع