Search Lookalikes Bulk

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/account/search-lookalikes-bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "seed_domains": [
    "<string>"
  ],
  "limit": 100,
  "min_employees": 1,
  "max_employees": 1,
  "funding_stages": [],
  "locations": [
    "<string>"
  ],
  "search_type": "semantic"
}
'

{
  "job_id": "<string>",
  "message": "<string>",
  "requested_top_k": 123,
  "status": "pending"
}

Company Search

Search Lookalikes Bulk

No API key yet? Sign up via Agent Auth to get your X-API-Key — the only required header for this endpoint.

Asynchronous, high-volume variant of Search Lookalikes. Same lookalike engine and inputs, but it accepts up to 5000 companies and runs as a background job: the call returns a job_id immediately, and you poll a separate endpoint for status + paginated results.

Find lookalike companies from either a natural-language description or a set of seed company websites, with optional firmographic filters.

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.

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.
Seed-based discovery (seed_domains): pass up to 10 company websites and OpenFunnel uses them to synthesize the lookalike query for you. The response manifest echoes back the LLM-synthesized derived_query, plus resolved_seed_domains and unresolved_seed_domains.
Both together: pass seed_domains AND query — the query becomes a must-have angle layered on top of the seeds.

Choosing a search strategy: precision vs. recall

semantic (default) — high recall. Wider net; includes companies that don’t use your exact phrasing but are conceptually adjacent.
agentic — high precision. Tighter, high-confidence set of companies that explicitly self-describe with your trait.

Omitting filters

If you omit filters, search runs across all company sizes, funding stages, and supported locations. Use the optional firmographic filters (min_employees, max_employees, funding_stages, locations) to restrict to your ICP.

Polling for results

This endpoint responds immediately with a job_id and status: "pending". Poll GET /api/v1/account/search-lookalikes-bulk/{job_id} (“Search Lookalikes Bulk Results”, listed under Agent Helpers) until status is completed, then walk the result pages using next_cursor. A large limit can take minutes — polling avoids a long-held connection.

Credits

1 credit per company returned, charged when the job completes. Empty result sets are free. The amount is echoed in the manifest’s credits_consumed.

Example — submit a bulk job

curl -sS -X POST "https://api.openfunnel.dev/api/v1/account/search-lookalikes-bulk" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Healthcare companies building with voice AI", "limit": 2000, "min_employees": 50, "max_employees": 500, "funding_stages": ["Series A", "Series B"], "locations": ["USA"]}'

The response returns a job_id; then poll GET /api/v1/account/search-lookalikes-bulk/{job_id} for status and results.

POST

api

account

search-lookalikes-bulk

Search Lookalikes Bulk

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/account/search-lookalikes-bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "seed_domains": [
    "<string>"
  ],
  "limit": 100,
  "min_employees": 1,
  "max_employees": 1,
  "funding_stages": [],
  "locations": [
    "<string>"
  ],
  "search_type": "semantic"
}
'

{
  "job_id": "<string>",
  "message": "<string>",
  "requested_top_k": 123,
  "status": "pending"
}

Headers

X-API-Key

string

required

Body

application/json

Request body for the async bulk lookalike search. Same fields as Search Lookalikes, but limit accepts up to 5000. At least one of query or seed_domains is required.

query

string | null

Describe the kinds of companies you want to find. Required unless seed_domains is provided. When both are supplied, used as a must-have angle on top of the seeds.

Required string length: 1 - 200

seed_domains

string[] | null

Up to 10 seed company websites/domains. When provided, OpenFunnel synthesizes the lookalike query for you.

Maximum array length: 10

limit

integer

default:100

Maximum number of companies to return. Default 100, max 5000. Large input set can take a few minutes to process.

Required range: 1 <= x <= 5000

min_employees

integer | null

Minimum employee count, inclusive.

Required range: x >= 0

max_employees

integer | null

Maximum employee count, inclusive.

Required range: x >= 0

funding_stages

enum<string>[] | null

Funding stages to include.

Available options:

Pre-Seed,

Seed,

Series A,

Series B,

Series C,

Series D,

Series E,

Series F,

Series G,

Series H,

Acquired,

Private,

Public

locations

string[] | null

Headquarters country filter using ISO 3166-1 alpha-3 codes (e.g. USA, GBR, IND, DEU). Pass EU to expand to all 27 EU member states.

search_type

enum<string>

default:semantic

Retrieval strategy: semantic (default, high recall) or agentic (high precision).

Available options:

semantic,

agentic

Response

Job accepted. Returns a job_id to poll for status and results.

Returned immediately when a bulk lookalike job is submitted.

job_id

string

required

Async job id. Poll GET /api/v1/account/search-lookalikes-bulk/{job_id} for status and results.

message

string

required

Human-readable next-step hint.

requested_top_k

integer

required

The requested result limit.

status

string

default:pending

Job status at submit time (always pending).

Search Lookalikes Search Companies By Tech Stack

⌘I