Build Company List
build_company_listBuild targeted company lists by market definition: find companies currently hiring for specific roles from live job boards, or US public companies mentioning your phrase in SEC filings.
Instructions
Build a list of companies from a market definition, in two modes. hiring returns companies currently advertising for your role keywords, built from a live index of public Greenhouse and Ashby job boards; role_keywords are matched as whole words against live job titles, so account executive matches Enterprise Account Executive and does not match Executive Assistant. filings returns US public companies whose SEC filings of the form types you name contain your exact phrase. location_contains is a plain substring test against the job board's own free text location string, so Remote does not match US Remote. min_open_jobs is a rough size proxy. resolve_domains looks up each company's website, which adds roughly a second per company and resolves about two thirds of the time, so check domain_status and domain_confidence before trusting a domain. The underlying company universe is rebuilt about monthly on its own; refresh_universe forces a fresh enumeration and is rarely what you want. You are billed per company returned, not per company examined, so max_companies is the cost dial. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | hiring returns companies currently hiring for your role keywords, built from a live index of public Greenhouse and Ashby job boards. filings returns US SEC filers whose filings contain your phrase. | |
| filing_forms | No | Comma separated SEC form types, for example 10-K,10-Q. Used in filings mode. Default: "10-K". | |
| filing_phrase | No | Exact phrase searched in SEC filings, for example agentic AI. Used in filings mode. | |
| max_companies | No | How many companies to return, 1 to 2000. Sent as a string so it works from Clay. You are billed per company returned, not per company examined. Default: "100". | |
| min_open_jobs | No | Skip companies with fewer open roles than this. A rough size proxy. Sent as a string so it works from Clay. Default: "1". | |
| role_keywords | No | Comma separated. Matched as whole words against live job titles, so account executive matches Enterprise Account Executive and does not match Executive Assistant. Leave empty to match any role. Used in hiring mode. | |
| resolve_domains | No | Look up each company's website. Off by default: it adds roughly a second per company and about two thirds of companies resolve. Check domain_status and domain_confidence before trusting a result. Default: true. | |
| refresh_universe | No | Force a fresh Common Crawl enumeration instead of the cached one. The cached universe is rebuilt about monthly on its own, so leave this off unless you need the newest crawl. Default: false. | |
| location_contains | No | Substring match against the job location string, for example London, Remote, New York. Locations are free text on every job board, so this is a plain substring test: Remote does not match US Remote. |