> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Search

Use a single endpoint and describe what you're looking for in plain English — "high-growth fintech companies in Germany founded after 2022" or "VC investors focused on climate." Specter handles the rest, mapping your query to the right filters and returning the matching records.

## What's covered

* All eight products are searchable through the single [AI search](/api-reference/ai-search/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 `resource_type` to 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.

| `resource_type`    | Returns                   | Object                                                                                                    |
| ------------------ | ------------------------- | --------------------------------------------------------------------------------------------------------- |
| `company`          | Companies                 | [Company](/api-reference/companies/get-company-by-id)                                                     |
| `people`           | People                    | [Person](/api-reference/people/get-person-info-by-id)                                                     |
| `investors`        | Investors                 | [Investor](/api-reference/investors/get-investor-by-id)                                                   |
| `talent_signals`   | Talent signals            | [Talent Signal](/api-reference/talent-and-interest-signals/get-talent-signal-by-id)                       |
| `interest_signals` | Investor-interest signals | [Investor Interest Signal](/api-reference/talent-and-interest-signals/get-investor-interest-signal-by-id) |
| `funding_rounds`   | Funding rounds            | [Funding Round](/api-reference/transactions/get-funding-round-by-id)                                      |
| `acquisitions`     | Acquisitions              | [Acquisition](/api-reference/transactions/get-acquisition-by-id)                                          |
| `ipos`             | IPOs                      | [IPO](/api-reference/transactions/get-ipo-by-id)                                                          |

## How to use

* Send `query` (required) and optionally `resource_type`. Paginate with `page`/`limit` (default 25, max 100).
* Check the count first, cheaply: send `limit=1` and read `total_count` (or the `X-Total-Count` header) before committing credits.

## Notes

* Costs 1 credit per result returned (a page of 25 results = 25 credits).
* 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`.