API Reference
Searches the surface ran behind the shopping answers of a topic
One row per distinct search the surface issued while answering, with the prompts whose answers ran it.
AuthorizationBearer <token>
Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
In: header
Path Parameters
domainId*string
topicId*string
Query Parameters
search?string
Case-insensitive match on the search text.
Length
length <= 200startDate?string
endDate?string
usedModels?string
Comma-separated shopping model ids to include (chatgpt, amazon-alexa-shopping).
tagIds?string
Comma-separated prompt tag ids; narrows the scope to the tagged prompts.
limit?number
skip?number
sortBy?string
Value in
- "totalAppearances"
- "lastSeenAt"
- "query"
sortOrder?string
Value in
- "asc"
- "desc"
Response Body
application/json
curl -X GET "https://example.com/api/domains/string/topics/string/shopping/search-queries"{ "queries": [ { "query": "iphone 13 reconditionné prix", "totalAppearances": 5, "uniquePrompts": 2, "promptIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6" ], "prompts": [ "meilleur iPhone reconditionné" ], "firstSeenAt": "2026-09-01T10:30:00.000Z", "lastSeenAt": "2026-09-15T10:30:00.000Z" } ], "total": 17}