Skip to main content
POST
AI search

Authorizations

X-API-Key
string
header
required

Query Parameters

page
number

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

limit
integer
default:25

The number of results to return per page (default 25, max 100).

Required range: 1 <= x <= 100

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.

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

total_count
integer
required

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

Example:

56

items
(Company · object | Person · object | Talent Signal · object | Investor Interest Signal · object | Investor · object | Funding Round · object | Acquisition · object | IPO · object)[]
required

The current page of results. Each item's type 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
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.