pull campaign performance metrics from instacart's carrot ads api
domain: docs.instacart.com/ads · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Apply to Instacart's Ads API Partner Program to get Carrot Ads API access for a retailer or brand account.
Authenticate and call the ads reporting endpoints to pull impressions, clicks, conversions, and revenue metrics for active campaigns.
Reference Instacart's ad metrics documentation to confirm each metric's definition before combining with other retail media data.
Schedule regular polling, since the API is designed for ongoing performance monitoring rather than one-off historical backfills.
Cross-check API-reported metrics against the Ads Manager or Retailer Partner Portal dashboards during initial integration testing.
Known gotchas
Access requires enrollment in Instacart's API Partner Program - it isn't available by default with an ads account.
Metric definitions (e.g. what counts as a click vs. a view) are Instacart-specific and documented separately; don't assume parity with Amazon or Walmart equivalents.
Aggregate event data visible to retailers via the Partner Portal can differ in scope and granularity from what's exposed to advertisers via the Carrot Ads API.
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?