Search companies similar
Stage lookalike companies from seed domains.
Tool: search_companies_similar
The call returns named rows plus search_id without creating companies or a group. Continue the same immutable search with continue_search, then commit approved rows with save_search. Seed or filter changes start a new search. NOT for: filter-based discovery → search_companies; hiring signals → search_companies_hiring; needs a seed, not a filter.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
seed_domains | string[] | yes | Bare domains, e.g. ['stripe.com'] - 2-5 seeds blend a materially stronger similarity signal than 1. |
exclude_domains | string[] | no | Domains to exclude from results. |
company_sizes | string[] | no | Fixed bands, e.g. 51-200 (validated). |
include_countries | string[] | no | ISO-2 list, e.g. ['us', 'de']. |
exclude_countries | string[] | no | ISO-2 list to exclude. |
industries | string[] | no | Optional - use sparingly, overconstrains. |
industry_match | string | no | any | all. |
matching_mode | string | no | precise (default) | broad. |
limit | integer | no | Default: 25, max 100/page (3 credits per result). |
exclude_lead_group | string (slug or UUID) | no | Add stable domains from this company group to the exclusion set. |
Expands from seed companies you like to staged similar accounts via Ocean.
Every durable response returns
search_version; pass that value tocontinue_search(search_id, search_version)for one bounded turn.On the first save, use
save_search(search_id, group_name=...)orsave_search(search_id, lead_group_id=...)to commit approved companies.Changing seeds or filters starts a new search.
Unknown named params are rejected with
validation_error(a typo'd filter must never silently broaden the search) - unlike most operations, which ignore extras.
Sample request
{
"seed_domains": [
"stripe.com",
"adyen.com"
],
"limit": 25
}