Search Lookalikes

curl --request GET \
  --url https://api.openfunnel.dev/api/v1/account/search-lookalikes \
  --header 'X-API-Key: <x-api-key>'

{
  "query": "<string>",
  "results": [
    {
      "name": "<string>",
      "domain": "<string>",
      "linkedin_url": "<string>",
      "headquarters": "<string>",
      "company_size": "<string>",
      "match_reason": "<string>"
    }
  ],
  "total": 123,
  "credits_consumed": 0
}

Company Search

Search Lookalikes

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

Find lookalike companies from a natural-language description, 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

You can also restrict results to your ICP by applying filters for company size, funding stage, and headquarters country.

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.

Choosing a search strategy: precision vs. recall

Use the search_type parameter to pick how aggressively the API filters:

agentic — high precision. Tighter results — a smaller, more obvious set of companies that explicitly describe themselves with your trait. Fastest path (~2-4s).
semantic (default) — high recall. Wider net. Includes companies that don’t use your exact phrasing but are conceptually adjacent. Slower but better when you want the long tail.

Stick with semantic (default) when your trait is fuzzy or conceptual, or when you want adjacent / near-fit companies in addition to obvious matches. Switch to agentic when your query has a clear category (B2B customer support software, HVAC home services, LLM evaluation tools) and you want a tight, high-confidence shortlist fast.

Credits

1 credit per company returned. Empty result sets are free. The exact amount billed is echoed back in credits_consumed on the response.

Example — semantic (default, high recall)

This request finds 100 healthcare companies building with voice AI in the US, with 50-500 employees, and funded at Series A or Series B.

curl -sS -G "https://api.openfunnel.dev/api/v1/account/search-lookalikes" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "query=Healthcare companies building with voice AI" \
  --data-urlencode "limit=100" \
  --data-urlencode "min_employees=50" \
  --data-urlencode "max_employees=500" \
  --data-urlencode "funding_stages=Series A" \
  --data-urlencode "funding_stages=Series B" \
  --data-urlencode "locations=USA"

Example — agentic (high precision, fastest)

For crisp queries that mention specific software categories or industries, opt into the agentic backend to get a tight, high-confidence set quickly.

curl -sS -G "https://api.openfunnel.dev/api/v1/account/search-lookalikes" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "query=B2B customer support software" \
  --data-urlencode "search_type=agentic" \
  --data-urlencode "limit=10" \
  --data-urlencode "min_employees=50" \
  --data-urlencode "max_employees=500" \
  --data-urlencode "locations=USA"

GET

api

account

search-lookalikes

Search Lookalikes

curl --request GET \
  --url https://api.openfunnel.dev/api/v1/account/search-lookalikes \
  --header 'X-API-Key: <x-api-key>'

{
  "query": "<string>",
  "results": [
    {
      "name": "<string>",
      "domain": "<string>",
      "linkedin_url": "<string>",
      "headquarters": "<string>",
      "company_size": "<string>",
      "match_reason": "<string>"
    }
  ],
  "total": 123,
  "credits_consumed": 0
}

Headers

X-API-Key

string

required

Query Parameters

query

string

required

Describe the kinds of companies you want to find.

Required string length: 1 - 200

limit

integer

default:10

Maximum number of companies to return. Default 10, max 5000. Practical values for interactive use are <=100; values >=500 are intended for batch / data-extraction workflows where minutes-long latency is acceptable (LLM trait validation runs on every candidate).

Required range: 1 <= x <= 5000

min_employees

integer

Minimum employee count, inclusive.

Required range: x >= 0

max_employees

integer

Maximum employee count, inclusive.

Required range: x >= 0

funding_stages

enum<string>[]

Funding stages to include. Repeat the parameter to send multiple values.

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[]

Headquarters country filter using ISO 3166-1 alpha-3 codes (e.g. USA, GBR, IND, DEU). Top 30 by company volume: USA, GBR, CHN, FRA, IND, DEU, BRA, BEL, ESP, CAN, AUS, NLD, ITA, NOR, ZAF, MEX, TUR, CHE, ARE, POL, SWE, IDN, ARG, PAK, COL, PRT, JPN, CHL, NGA, AUT. Pass EU to expand to all 27 EU member states. Repeat the parameter to send multiple values. Full list of 250 codes via GET /api/v2/tech/country-options (under Agent Helpers).

search_type

enum<string>

default:semantic

Retrieval strategy. Pick based on whether you want high precision (a tight set of obvious matches) or high recall (a wider net that includes near-fits and adjacent companies).

agentic — high precision. Returns a smaller, tighter set of companies that explicitly self-describe with your trait. Latency-optimized — typically 2-4s.
semantic (default) — high recall. Surfaces a broader candidate pool including companies that don't use your exact phrasing but are conceptually similar. Slower but better when you want to cast a wide net or your trait is fuzzy.

Rule of thumb: start with agentic if you know roughly what category you want; switch to semantic if results feel too narrow or you want the long tail.

Available options:

semantic,

agentic

Response

Successful Response

Response for the public lookalike search.

query

string

required

Original user query

results

InstantTraitSearchResult · object[]

required

Matching companies

Show child attributes

total

integer

required

Number of results returned

credits_consumed

integer

default:0

Credits charged for this response. 1 credit per company returned.

Search Companies By Tech Stack

⌘I