AI search
Search Specter with a plain-English query. Describe what you’re looking for, such as “high-growth fintech companies in Germany founded after 2022” or “VC investors focused on climate”, and the endpoint turns it into a structured search and returns the matching records.
Costs 1 credit per result. A page of 25 results uses 25
credits. To check how many records match before fetching them, send the
query with limit=1 and read total_count (or the X-Total-Count header).
You’ll only be charged for that one result.
What you need
A plain-English query. Optionally set product to force which product to
search; omit it and Specter infers the best product from your query. No IDs
or prior setup are required.
Supported products and return types
All eight products are searchable, and each result is the same object that
product’s own endpoints return, so you parse it the same way. Pass a
product value to get the matching object:
product | Returns |
|---|---|
company | Company |
people | Person |
investors | Investor |
talent_signals | Talent signal |
interest_signals | Investor-interest signal |
funding_rounds | Funding round |
acquisitions | Acquisition |
ipos | IPO |
Supported filters
Any filter a product supports can be expressed in the query: geography, sector, growth stage, funding, headcount, revenue, seniority, dates, “similar to” a company, and “backed by” an investor.
Behaviour
- The search is organization-scoped. It is not saved as a saved search, but the
response returns a
query_idthat identifies the structured filters the query resolved to (identical queries share an id). - Paginate with the
pageandlimitquery parameters. Totals are returned both on the body (total_count) and via theX-Total-CountandLinkresponse headers. querymust be non-empty, and an unknownproductvalue is rejected with a422.
What you do next
- Get the full record. Every result carries its ID. Pass it to that
product’s by-ID endpoint: a
companyresult to Get company by ID, aninvestorsresult to Get investor by ID. - Save results to a list. Add companies with Create company list, or people with Create people list.
Authorizations
Query Parameters
The page number of results to return, base 0, default is 0.
The number of results to return per page (default 25, max 100).
1 <= x <= 100Body
A natural-language description of what to search for.
1"high-growth fintech companies in Germany founded after 2022"
The product to search for. Omit to infer it from the query.
company, people, talent_signals, interest_signals, investors, funding_rounds, acquisitions, ipos "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.
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.
254476
Total number of matches across all pages (also returned as the X-Total-Count response header).
56
The current page of results. Each item's type matches product.
- Company
- Person
- Talent Signal
- Investor Interest Signal
- Investor
- Funding Round
- Acquisition
- IPO
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.
company, people, talent_signals, interest_signals, investors, funding_rounds, acquisitions, ipos 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.