Create saved search
Saved Searches
Create saved search
Saves an existing query under a name so its results can be read later.
Free. This call does not consume credits.
What you need
A query_id, which AI search returns for every query it resolves, and a name.
Behaviour
- The product is taken from the saved query, not the request, so a saved search and its filters cannot disagree about which product they describe. Sending a
product_typeis rejected with422. - The search is shared with the API and with your organization on creation, so it appears in Get all saved searches immediately and is visible to your team in the app.
- The search is assigned to an admin of your organization, returned as
owner_id. You do not choose the owner: only an admin-owned search can be deleted through the API, so any other owner would leave a search you cannot remove. An organization with no admin gets a422. - A name the owner has already used returns
409. - An unknown
query_idreturns404.
What you do next
- Read the results. Take the returned
idand call the matching product’s results endpoint. - Remove it. Delete it with Delete search.
POST
Create saved search
Authorizations
Body
application/json
Response
The saved search that was created.
Id of the saved search, for the read endpoints.
Example:
41966
Example:
"German fintech"
Example:
4242
Product the saved query searches.
Example:
"company"
Id of the organization admin the search was assigned to.
Example:
"user_2abcDEF456"