Tomba icon

Tomba

Consume Tomba API

Company → Search Companies

AI-generated

Summary

Search Tomba's company database using natural language queries or structured filters, returning paginated company records.

Inputs

  • Query — Natural language query (e.g., 'Real Estate in France') to let Tomba's AI select filters automatically.
  • Page — Page number for pagination (1-1000). Defaults to 1.
  • Webhook URL — Optional URL to receive results asynchronously instead of returning them immediately.
  • Filters — Structured collection of include/exclude filters for company data (e.g., Industry, Location, Revenue, Technologies). Each filter accepts comma-separated values (max 50 per list).
  • Authentication (required) — OAuth2 or API Key credential type.

Output shape

One or more items, each containing a company object (JSON).

Pagination is manual via the Page parameter (max 1000 pages). Results can be sent asynchronously via Webhook URL. Filters are case-insensitive; empty filters are ignored.

Examples

Example 1: Find SaaS companies in San Francisco with 1M-10M revenue.

Query: 'SaaS companies in San Francisco with 1M-10M revenue'; Filters: Revenue include '1M-10M', Location City include 'San Francisco'.

Example 2: Retrieve the first 10 pages of results.

Query: empty; Page: 10; Filters: empty.

Example 3: Send results asynchronously to a webhook.

Query: 'AI startups in Berlin'; Webhook URL: 'https://my-server.com/tomba-results'; Filters: Industry include 'AI', Location City include 'Berlin'.

Links

Discussion