Credits - OpenFunnel

Credits are charged only for data a primitive actually returns. Every billable response echoes the exact amount in its credits_consumed field, empty result sets are always free, and async jobs are billed once on completion — never for polling. Unit: 1C = 1 Credit

Primitives

Endpoint	Credits
`GET /api/v1/account/search-lookalikes` — Search Lookalikes	1C per company returned
`POST /api/v1/account/search-lookalikes-bulk` — Search Lookalikes Bulk	1C per company returned
`GET /api/v2/tech/companies` — Search Companies by Tech Stack	0.5C per company
`POST /api/v2/research/deep` — Deep Research	1 charge per successful call (per-call price configured for your workspace)

Helpers

Discovery, lookup, and job-control endpoints are free.

Endpoint	Credits
`POST /api/v1/account/lookup-companies` — Lookup Companies	Free
`GET /api/v2/tech/country-options` — List Country Codes	Free
`GET /api/v1/account/firmographic-options` — List Firmographic Options	Free
`GET /api/v1/account/search-lookalikes-bulk/{job_id}` — Search Lookalikes Bulk Results	Free
`POST /api/v1/account/search-lookalikes-bulk/{job_id}/cancel` — Cancel Bulk Lookalike Job	Free

Cancelling a bulk job early caps spend — you are billed only for the companies delivered before the cancel.

Search LookalikesFind lookalike companies from either a natural-language description **or** a set of seed company websites, with optional firmographic filters. <Info>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.</Info> Use it for queries such as: - `Healthcare companies building with voice AI` - `Companies that provide customer support software for B2C` - `Companies that build workflow automation for non technical industries` Or supply 1-10 seed company websites and let OpenFunnel synthesize the query for you: - `seed_domains=datadog.com&seed_domains=grafana.com&seed_domains=dynatrace.com` You can also restrict results to your ICP by applying filters for company size, funding stage, and headquarters country. ## Two input modes At least one of `query` or `seed_domains` is required. Both can be combined for a hybrid trait. - **Natural language** (`query`): describe the kind of company you want. Best when you can articulate the trait in 1-2 sentences. - **Seed-based discovery** (`seed_domains`): pass up to 10 company websites and OpenFunnel uses them to synthesize the lookalike query for you. Best when you can name a few example customers but struggle to phrase what they have in common. - **Both together**: pass `seed_domains` AND `query` - the query becomes a must-have angle layered on top of the seeds (e.g. seeds=[datadog.com, grafana.com] + query="cloud monitoring and observability tools" → synthesized trait targets cloud monitoring tools). With `seed_domains`, the response echoes back the LLM-synthesized `derived_query`, plus `resolved_seed_domains` (seeds that landed in our index) and `unresolved_seed_domains` (seeds we couldn't find - skipped silently as long as at least one resolved). ## Omitting filters If you omit filters, search runs across all company sizes, funding stages, and supported locations. Use the optional firmographic filters below to restrict results to your ICP. ## Discovering available firmographics The `funding_stages`, `locations`, `min_employees`, and `max_employees` filters accept a fixed set of values. Fetch the current set via **`GET /api/v1/account/firmographic-options`** it returns the accepted `funding_stages` labels, the supported HQ `locations` (code + name), and the min/max employee bounds. ## Credits **1 credit per company returned.** Empty result sets are free. The exact amount billed is echoed back in `credits_consumed` on the response. The LLM trait synthesis used by `seed_domains` is included - no extra charge. The response includes a `derived_query` field with the LLM-synthesized trait so you can see exactly what was searched.

⌘I