Direct naar de inhoud

// get /v1/companies/find

Bedrijfsverrijking API

Krijg volledige bedrijfsprofielen van elk domein branche, grootte, technologiestack, sociale profielen en werknemersdata via API.

1 search credit

// api-console

GETapi.tomba.io/v1/companies/find
Voorbeeldantwoord uit de API-naslag
name
Pied Piper
domain
piedpiper.com
description
Pied Piper builds middle-out compression for files, video and a decentralized internet.
category.industry
Internet Software & Services
foundedYear
2014
geo.city
Palo Alto
geo.country
United States
metrics.employees
11-50
emailProvider
Google

// 01 · verzoek

Company Enrichment is één HTTPS-verzoek

Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.

GET/companies/findParameter
domainverplicht
Company domain
curl "https://api.tomba.io/v1/companies/find?domain=piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · antwoord

Wat je terugkrijgt

JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.

GET/companies/findVeld
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· 1 search credit
{
  "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": "Pied Piper builds middle-out compression for files, video and a decentralized internet.",
    "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 · kosten en limieten

Wat een aanroep kost

Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.

// kosten

1search credit

In rekening gebracht als: A company is returned.

Fouten, 429- en 451-antwoorden en hetzelfde verzoek opnieuw binnen je gebruiksvenster kosten niets.

Hoe credits werken

// rate limits

Verzoeken per seconde / minuut / dag
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. Rate limits

// faq

Bedrijfsverrijking API-vragen

Nog vragen? Bezoek het helpcentrum

// snelstart

Doe je eerste aanroep binnen een minuut

Gratis account, echte API-sleutel, dezelfde endpoints die Enterprise-klanten gebruiken.

  1. 1Maak een gratis account aan25 zoekopdrachten per maand. Geen creditcard.
  2. 2Kopieer je sleutel en secretOnder API-sleutels in het dashboard.
  3. 3Roep de API aanPlak het verzoek; het antwoord is JSON.
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Antwoord
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": []
  }
}