List shopping results for a domain
API Key for programmatic access
In: header
Path Parameters
Query Parameters
Filter by query ID
uuidFilter by topic ID
uuidFilter by market country code
Filter by query group ID
uuidStart date filter (ISO 8601)
End date filter (ISO 8601)
Number of results to return
20Number of results to skip
0Response Body
application/json
curl -X GET "https://example.com/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"
}
}Get a result's AI response text (on-demand) GET
Returns the AI surface's natural-language answer for a single execution. Fetched lazily when the result detail panel is opened — the prose is never included in the list/detail reads.
Get enrichment data for source URLs POST
Takes a batch of source URLs (max 100) and returns enrichment metadata for each: the domain category and any brand/competitor mentions detected during source crawling. URLs with no enrichment data are omitted from the response. Invalid URLs are silently skipped.