API Reference
Every product of the shopping carousels of a topic
Every distinct product observed in the carousels of the scope, best mean slot first then most carousels, with the total of products and of owned products behind the page. The same rows as the overview top products, without its cap.
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
limit?number
Products to return, best position first; total always counts every product of the scope.
Range
value <= 1000Default
500startDate?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/products"{ "carousels": 30, "total": 14, "ownedTotal": 5, "products": [ { "key": "back market::iphone 13 128 go reconditionné", "title": "iPhone 13 128 Go reconditionné", "brand": "Back Market", "isOwned": true, "isTracked": false, "image": "https://cdn.backmarket.fr/iphone-13.jpg", "url": "https://www.backmarket.fr/fr-fr/p/iphone-13", "carousels": 12, "presence": 0.4, "avgSlot": 1.6, "bestSlot": 1, "price": 389, "currency": "EUR" } ]}