API Reference
List shopping results for a domain
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Query Parameters
queryId?string
Filter by query ID
Format
uuidtopicId?string
Filter by topic ID
Format
uuidmarket?string
Filter by market country code
groupId?string
Filter by query group ID
Format
uuidstartDate?string
Start date filter (ISO 8601)
endDate?string
End date filter (ISO 8601)
limit?number
Number of results to return
Default
20skip?number
Number of results to skip
Default
0Response Body
application/json
curl -X GET "https://example.com/api/domains/string/shopping/results"{ "results": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "domainId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "organizationId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "queryId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "query": "best wireless headphones", "topicId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "products": [ {} ], "totalResults": 25, "source": "dataforseo", "usedModel": "amazon-alexa-shopping", "executionTimeMs": 1500, "metadata": { "triggerSource": "cron" }, "market": "US", "language": "en", "reportDate": "2026-05-25T10:30:00.000Z", "createdAt": "2026-05-25T10:30:00.000Z" } ], "totalCount": 100, "dateRange": { "start": "2024-01-01", "end": "2024-12-31" }}