الانتقال إلى المحتوى

// get /v1/companies/find

API إثراء الشركة API

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

1 search credit

// وحدة تحكم api

GETapi.tomba.io/v1/companies/find
مثال

Tomba

tomba.io

The most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.

القطاع
Information Technology and Services
الموظفون
1-10
سنة التأسيس
2021
الموقع
Claymont, US
مزوّد البريد
Google Workspace
الإيرادات
$0-$1M

// 01 · الطلب

Company Enrichment هو طلب HTTPS واحد

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

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

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

ما يُعاد إليك

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

GET/companies/find
data.name, data.legalName, data.domainstring | null
Who the company is
data.description, data.foundedYear, data.typestring | null
What it does, when it was founded, its ownership
data.categoryobject
Sector, industry, SIC and NAICS codes
data.geoobject
Street address, city, state, country, coordinates
data.metricsobject
Employees, traffic rank, revenue, funding
data.linkedin, data.twitter, data.facebookobject
Social handles
data.tech[], data.techCategories[]array | null
Technologies the website runs
meta.domainstring | null
The domain you sent
errorsobject
When nothing is found the response is still 200, with errors {type, message, code} instead of data
GET /companies/find
200 OK
{
  "data": {
    "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": {
    "domain": "piedpiper.com"
  }
}

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

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

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

// التكلفة

1search credit

يُخصم عند: A company 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. حدود المعدّل

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

أسئلة حول Company Enrichment API

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

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

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

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