Skip to content

// bulk operations

Bulk Domain Similar

Upload a CSV of domains and find similar companies for each one at once.

Domains or company namesUp to 5,000 rows a jobCSV, list or rows
domain-similar-list.csv2,500 rows · domains or company namescompleted
Bulk Similar Domains · /bulk/similar2,500 / 2,500
  1. 01pendingPOST /v1/bulk/similar201 · { "data": { "id": 1042 } }
  2. 02runninglaunch: trueprogress polled with GET /v1/bulk/similar/1042/progress
  3. 03completedbulk.completedsigned webhook delivered to your webhook_url
GET /v1/bulk/similar/1042/download?file=fullCharged at the first download · the job expires after 180 days

// 01 · input

The input of a bulk Similar Domains job

Upload a CSV of up to 4 MB in the app, or send a list, rows or a file to POST /v1/bulk/similar. Columns are found from the header row; set a field index to choose one yourself.

POST/bulk/similarColumns
domain_field_index
Domain
company_name_field_index
Company name
POST/bulk/similarOptions
input_type
domain or company; company when the input has a company name column and no domain column
max_emails_per_domain
Addresses per domain: 1, 10 (the default), 20, 50 or 100

// 02 · api

One request starts the job

Create and launch it in one call, then follow its progress or receive a signed bulk.completed event. Each result row is what GET /similar returns.

curl -X POST "https://api.tomba.io/v1/bulk/similar" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'
POST /bulk/similar
201 Created
{
  "data": {
    "id": 1042
  }
}
Each row, as GET /similar returns it
200 OK
{
  "data": [
    {
      "website_url": "hooli.com",
      "name": "Hooli",
      "industries": "internet"
    },
    {
      "website_url": "endframe.com",
      "name": "Endframe",
      "industries": "computer software"
    }
  ],
  "meta": {
    "total": 2,
    "pageSize": 10,
    "current": 1,
    "total_pages": 1,
    "params": {
      "domain": "piedpiper.com",
      "page": 1,
      "limit": 10
    }
  }
}

// 03 · cost and limits

What a job costs

Nothing is charged to create or launch a job. Its cost is charged once, at the first download of its results.

// billing per row

1 search credit per domain with at least one similar company.

Bulk billing in the docs
  • Rows: up to 5,000 per job
  • 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)

// customers

Teams that run Similar Domains jobs

  • We use Tomba to find emails of the right people, helping us reach out and grow our network easily.
    Olderico A.F. CavigliaCEO, Strategycapp
  • Since years, Tomba has provided the most results per search, and it keeps getting better. It recently became one of the most feature-rich tools for our list building.
    Steffen BurandtHead of Business Development, Chandler Orchards

// faq

Frequently Asked Questions

Still have questions? Visit the help center

// quick start

Make your first call in a minute

Free account, real API key, the same endpoints Enterprise customers use.

  1. 1Create a free account25 searches a month. No card.
  2. 2Copy your key and secretFrom API keys in the dashboard.
  3. 3Call the APIPaste the request; the answer 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"
Response
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": []
  }
}