Zum Inhalt springen

// post /v1/bulk/search

API für die Massendomänensuche

Entdecken Sie E-Mails von Entscheidungsträgern in Hunderten von Domänen in einem asynchronen API-Job mit exportfähigen Ergebnissen.

Domains or company namesBis zu 25,000 Zeilen
curl -X POST "https://api.tomba.io/v1/bulk/search" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 01 · anfrage

Massen-Domain Search ist eine HTTPS-Anfrage

Senden Sie die Parameter mit Ihrem Schlüssel und Secret. Jedes SDK, die CLI und der MCP-Server stellen genau diesen Aufruf.

type
search
list | data | file
Domains or company names
launch
true startet den Job sofort
webhook_url
Erhält ein signiertes Ereignis, wenn der Job endet
rows
Bis zu 25,000 pro Job
curl -X POST "https://api.tomba.io/v1/bulk/search" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 02 · antwort

Was zurückkommt

JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.

GET/domain-search
data.organizationobject
Company name, location, social links, industry, size, revenue, description, pattern
data.organization.accept_allboolean
The domain accepts mail for any address (catch-all)
data.emails[].emailstring
Each address found
data.emails[].full_name, data.emails[].position, data.emails[].departmentstring | null
Name, job title and team
data.emails[].senioritystring | null
junior, senior or executive
data.emails[].scoreinteger
Confidence from 0 to 100
data.emails[].verification.statusstring | null
valid, accept_all, invalid or unknown, with verification.date
data.emails[].sources[]array
Where each address was found
meta.total, meta.total_pagesinteger
Addresses that match, and pages at this pageSize
meta.current, meta.pageSizeinteger
This page and its size
meta.paramsobject
The parameters the search ran with
POST /bulk/search
201 Created
{
  "data": {
    "id": 1042
  }
}
Jede Zeile, wie GET /domain-search sie zurückgibt
200 OK
{
  "data": {
    "organization": {
      "website_url": "piedpiper.com",
      "organization": "Pied Piper",
      "location": {
        "country": "US",
        "city": "Palo Alto",
        "state": "CA",
        "street_address": "5230 Newell Road",
        "postal_code": "94303"
      },
      "social_links": {
        "twitter_url": null,
        "facebook_url": null,
        "instagram_url": null,
        "linkedin_url": "https://www.linkedin.com/company/pied-piper",
        "github_url": null,
        "youtube_url": null,
        "pinterest_url": null,
        "tiktok_url": null
      },
      "disposable": false,
      "webmail": false,
      "phone_number": false,
      "industries": "computer software",
      "founded": "2014",
      "company_size": "11-50",
      "company_type": "privately held",
      "revenue": null,
      "accept_all": false,
      "description": "Middle-out compression for files and video.",
      "pattern": "{first}",
      "total_similar": 2,
      "keywords": [
        "compression",
        "middle-out",
        "decentralized internet"
      ],
      "ranking": null,
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "last_updated": "2025-01-15T10:32:00+01:00"
    },
    "emails": [
      {
        "email": "dinesh@piedpiper.com",
        "first_name": "Dinesh",
        "last_name": "Chugtai",
        "full_name": "Dinesh Chugtai",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Software Engineer",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 99,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "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
          }
        ]
      },
      {
        "email": "gilfoyle@piedpiper.com",
        "first_name": "Bertram",
        "last_name": "Gilfoyle",
        "full_name": "Bertram Gilfoyle",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Systems Architect",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 97,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "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
          }
        ]
      }
    ]
  },
  "meta": {
    "total": 12,
    "pageSize": 10,
    "current": 1,
    "total_pages": 2,
    "params": {
      "domain": "piedpiper.com",
      "company": "",
      "page": 1,
      "limit": 10,
      "department": "engineering",
      "country": null,
      "type": "all",
      "live": false,
      "enrich_mobile": false,
      "webhook_url": null
    }
  }
}

// 03 · kosten und limits

Was ein Aufruf kostet

Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.

// kosten

Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.

Charged once, at the first download; later downloads are free

  • 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)

// faq

Häufig gestellte Fragen

Noch Fragen? Zum Hilfezentrum

// kostenlos starten

Sehen Sie, wen Tomba in jedem Unternehmen findet

Geben Sie die Domain eines Unternehmens ein und sehen Sie seine Mitarbeitenden, ihre Rollen und verifizierten geschäftlichen E-Mails, jeweils mit den Seiten, auf denen sie gefunden wurden. Kostenloses Konto, keine Karte.