What’s covered
- All eight products are searchable through the single AI search endpoint: companies, people, investors, talent signals, investor-interest signals, funding rounds, acquisitions, and IPOs.
- Every filter a product supports can be expressed in the query: geography, sector, growth stage, funding, headcount, revenue, seniority, dates, “similar to” a company, “backed by” an investor, and so on.
- Set
productto force the product, or omit it to let Specter infer it; the response reports the product actually searched.
Return types
Each result is the same rich object the product’s own endpoints return, so you can chain and parse it identically.How to use
- Send
query(required) and optionallyproduct. Results page at 50; walk further withpage. total_count(and theX-Total-Countheader) reports how many records matched in total, so you can tell when there is more than the page you were given. To work through a larger set, keep paging, or save the search in the app and read it with the saved-search results endpoints.
Notes
- Charged per block of results returned rather than per result, so a partial page is cheaper than a full one and a query that matches nothing is free. See the AI search endpoint’s “Costs” note for the block size and the exact figure.
- User-scoped filters are not supported: your network, CRM, or saved lists can’t be resolved (the API authenticates as an organisation, not a user); such a query returns
422.