API Reference
Raw shopping answers of a topic
Every answer of the scope, newest first: the prompt, the model, the answer text, the product cards the surface rendered and the pages it cited. Paged by `page` and `limit`; the pagination carries the total of answers in the scope.
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
models?string
Comma-separated shopping model ids, the name the other raw-results endpoints take; read when usedModels is absent.
page?number
Page of answers, newest first
Range
1 <= valueDefault
1limit?number
Answers per page
Range
1 <= value <= 100Default
50startDate?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.
Response Body
application/json
curl -X GET "https://example.com/api/domains/string/topics/string/shopping/raw-results"{ "results": [ { "id": "4f0c6b2e-3d3a-4a4a-9f7b-2c3b8a1d5e6f", "prompt": "best refurbished iphone", "promptId": "p1", "response": "string", "model": "chatgpt", "reportDate": "2026-09-14T10:00:00.000Z", "reportId": "4f0c6b2e-3d3a-4a4a-9f7b-2c3b8a1d5e6f", "citations": [ { "url": "https://www.lesnumeriques.com/smartphone/iphone-13-reconditionne", "title": "iPhone 13 reconditionné : notre avis", "text": "string" } ], "productCards": [ { "position": 0, "title": "iPhone 13 128 Go reconditionné", "description": "string", "imageUrl": "https://images.example.com/iphone-13.png", "targetUrl": "https://www.backmarket.fr/fr-fr/p/iphone-13", "merchantName": "Back Market", "merchantUrl": "https://www.backmarket.fr/fr-fr/p/iphone-13", "priceValue": 389, "priceCurrency": "EUR", "priceRaw": "389,00 €", "rating": 4.6, "reviews": "1240", "tags": [ "AI-extracted" ] } ] } ], "pagination": { "page": 1, "limit": 50, "total": 24, "totalPages": 1 }}