Generate a Supply-Side (SSP) Revenue Report for a retailer account via the Criteo Retail Media API
domain: developers.criteo.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
POST to /{version}/retail-media/reports/revenue with the supply account id (or an ids array for multi-account access), a startDate/endDate window, and either a reportType preset (advertiser, brand, environment, productCategory, pageType) or explicit metrics/dimensions arrays.
Optionally filter by revenueType (auction or preferred), soldBy (directSold, indirectSold, privateMarket), campaignType, or salesChannel to narrow the report to a specific revenue slice.
Set clickAttributionWindow/viewAttributionWindow and clickMatchLevel/viewMatchLevel explicitly if you need attribution settings that differ from the campaign-level defaults.
Poll GET /{version}/retail-media/reports/{reportId}/status until status reports success, noting rowCount and expiresAt.
Download the finished report from GET /{version}/retail-media/reports/{reportId}/output in the requested format (json, json-compact, json-newline, or csv).
Known gotchas
This is a supply-side (retailer/publisher) report distinct from advertiser/DSP-side campaign performance reports — it answers 'where did my retail media revenue come from across all advertisers,' not 'how did my campaign perform.'
The date range is capped at 100 days between startDate and endDate; requesting a wider window returns a 400 validation error.
When a reportType preset is used, the metrics/dimensions arrays are ignored rather than combined with the preset.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?