Direct naar de inhoud

// bulkbewerkingen

Bulk Bedrijfsverrijking

Upload een CSV met bedrijfsdomeinen en verrijk ze allemaal met gedetailleerde bedrijfsgegevens tegelijk.

Domains or company namesTot 25,000 rijen per taakCSV, lijst of rijen
company-enrichment-list.csv2,500 rijen · domains or company namescompleted
Bulk Company Enrichment · /bulk/company2,500 / 2,500
  1. 01pendingPOST /v1/bulk/company201 · { "data": { "id": 1042 } }
  2. 02runninglaunch: truevoortgang opgevraagd met GET /v1/bulk/company/1042/progress
  3. 03completedbulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/company/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen

// 01 · invoer

De invoer van een Company Enrichment-bulktaak

Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/company. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.

POST/bulk/companyKolommen
domain_field_index
Domain
company_name_field_index
Company name
POST/bulk/companyOpties
input_type
domain or company; company when the input has a company name column and no domain column
find_phones
true adds phone numbers, at an extra cost

// 02 · api

Eén verzoek start de taak

Maak en start de taak in één aanroep, volg daarna de voortgang of ontvang een ondertekend bulk.completed-event. Elke resultaatrij is wat GET /companies/find teruggeeft.

curl -X POST "https://api.tomba.io/v1/bulk/company" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Company Enrichment job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'
POST /bulk/company
201 Created
{
  "data": {
    "id": 1042
  }
}
Elke rij, zoals GET /companies/find die teruggeeft
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": "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 taak kost

Een taak aanmaken of starten kost niets. De kosten worden één keer in rekening gebracht, bij de eerste download van de resultaten.

// facturering per rij

1 search credit per company found. Plus 1 per company with phone data.

Bulkfacturering in de documentatie
  • Rijen: tot 25,000 per taak
  • Jobs created: 15 per day for each type
  • Running jobs: 2 per type
  • Downloads: 25 per day for each job
  • Request size: 4 MB (CSV, list or rows)

// klanten

Teams die Company Enrichment-taken uitvoeren

  • We rely on Tomba to efficiently locate email addresses of key professionals. This allows us to connect directly and build meaningful relationships.
    Josh LeierCreative Director, IceHound Marketing
  • Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
    Nicholas RizzoSenior Digital Manager, Vizme

// faq

Veelgestelde 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": []
  }
}