Copy page

Tutorials

Companies Search

Find companies that match structured filters and write them to a table: market sizing, territory planning, or a fresh list of target accounts. You choose the filters; there is no free-text or AI search.

Credits: 1 search credit per 50 companies returned (companies come in pages of 50). See Pricing and limits.

Build a table of companies

Code
CALL TOMBA.core.search_companies(
    {'location_country': ['DE', 'AT'],
     'industry': 'Financial Services',
     'size': ['51-200', '201-500'],
     'keywords': {'include': ['payments'], 'exclude': ['crypto']}},
    'DACH_FINTECH', 500);

SELECT NAME, WEBSITE_URL, INDUSTRY, COMPANY_SIZE, REVENUE, CITY, COUNTRY
  FROM TOMBA.results.DACH_FINTECH;

Signature: search_companies(filters VARIANT, output_table STRING, max_results INT DEFAULT 500). At most 5,000 companies per call. For large searches, use search_companies_async (same arguments) to run it in the background.

Filters

A filter is a single value, a list of values, or {'include': [...], 'exclude': [...]}, with up to 50 values each. Filters are combined with AND.

More examples

Code
-- SaaS companies in the US using Snowflake, founded since 2010
CALL TOMBA.core.search_companies(
    {'country': 'US', 'industry': 'Software Development', 'technologies': 'Snowflake',
     'founded': ['2010-2019', '2020+']}, 'US_SAAS_ON_SNOWFLAKE', 1000);

-- one page (50 companies) as a result, without a table
CALL TOMBA.core.lookup('companies_search', {'filters': {'country': 'FR', 'size': '11-50'}, 'page': 1});

Output columns

One row per company: INPUT_FILTERS (the filters, as JSON), the company columns, and the common columns. Every column, with its type: Output columns.

Tips

• Use the Streamlit app's Find companies page to build filters without writing JSON.
• TOTAL_EMAILS shows how many emails Tomba knows at each company: sort by it to prioritize.
• Chain it: run Domain Search on WEBSITE_URL to find people, or Company Enrichment for more firmographics.

Related

• Similar Domains
• Company Enrichment
• Domain Search