Search companies hiring
Stage companies actively hiring for a role (TheirStack).
Tool: search_companies_hiring
A normal call returns named companies, hiring evidence, and search_id without creating a group. Use sample=true only for the free pool-size probe; it intentionally hides company names and cannot be continued or saved. Continue a real search with continue_search, then commit approved rows with save_search. NOT for: firmographics/funding truth → search_companies / get_company_funding_detail; people → search_people; results are buyer-side signals, not candidates.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
job_title | string[] | no | Case-insensitive title patterns, e.g. ['SDR', 'Account Executive']. |
job_title_exclude | string[] | no | Title patterns to exclude. |
job_keyword | string[] | no | Buying-intent keywords matched in the job description, e.g. ['salesforce', 'kubernetes']. |
posted_within_days | integer | no | Freshness window. Default: 30 when no date/company filter is given. |
posted_after | string | no | ISO date or 90d_ago/6m_ago - posted on/after. |
posted_before | string | no | ISO date - posted on/before. |
company_headcount_min | integer | no | With company_headcount_max - the size-band proxy. |
company_headcount_max | integer | no | Maximum employee count. |
hq_country | string[] | no | Company HQ, uppercase ISO-2 list, e.g. ['US']. |
job_country | string[] | no | Job location, uppercase ISO-2 list. |
seniority | string[] | no | c_level | staff | senior | mid_level | junior. |
employment_type | string[] | no | full_time | part_time | temporary | internship | contract. |
technology | string[] | no | Technology slugs mentioned in the job. |
company_technology | string[] | no | Technology slugs used by the company. |
remote | boolean | no | Remote roles only. |
company_domain | string[] | no | 'Is X hiring?' - prefer domain over exact-match company_name. |
company_name | string[] | no | Exact company name list. |
funding_stage | string[] | no | Convenience pre-filter - confirm via get_company_funding_detail. |
limit | integer | no | Default: 25 (3 credits per job returned). |
sample | boolean | no | Free blurred preview - count + roles, company names hidden, no credits, no group; commit by re-running without it. |
exclude_lead_group | string (slug or UUID) | no | Skip companies already in this group using stable domains. |
A normal call stages named companies and hiring evidence. Show the list before saving approved companies.
sample=trueis the optional free blurred pool-size probe; it cannot be continued or saved.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
{
"job_title": [
"Account Executive"
],
"posted_within_days": 30,
"hq_country": [
"US"
]
}