Skip to main content
POST
AI search

Authorizations

X-API-Key
string
header
required

Query Parameters

limit
integer
default:50

The number of results to return per page (minimum 1, maximum 50, default 50). A page is the unit these endpoints are priced in, so it cannot be widened beyond 50.

Required range: 1 <= x <= 50
page
integer
default:0

The page number of results to return, base 0, default is 0.

Required range: x >= 0

Body

application/json
query
string
required

A natural-language description of what to search for.

Minimum string length: 1
Example:

"high-growth fintech companies in Germany founded after 2022"

product
enum<string> | null

The product to search for. Omit to infer it from the query.

Available options:
company,
people,
talent_signals,
interest_signals,
investors,
funding_rounds,
acquisitions,
ipos
Example:

"company"

Response

The matching results. product reports the product that was actually searched: the request's product when one was provided, or the product inferred from the query otherwise. Every object in items is of the type that matches product.

product
enum<string>
required

The product that was searched - the requested product, or the one inferred from the query when it was omitted. Every object in items is of this type.

Available options:
company,
people,
talent_signals,
interest_signals,
investors,
funding_rounds,
acquisitions,
ipos
query_id
integer
required

Identifies the structured filters this natural-language query resolved to. Identical queries share an id. The search itself is not stored as a saved search.

Example:

254476

web_url
string
required

Deep-link that opens this search in the Specter web app, with the resolved filters pre-applied. Open it to refine, save, export, or push the results to a CRM.

total_count
integer
required

Total number of matches across all pages (also returned as the X-Total-Count response header).

Example:

56

items
(CompanyV1Response · object | PublicPersonResponse · object | PublicTalentSignal · object | InvestorSignalV1Response · object | InvestorV1Response · object | PublicFundingRound · object | PublicAcquisition · object | PublicIpo · object)[]
required

The current page of results. Each item's type matches product.