{"uid":"cap_SKdqPw7tltgtxvosi34dE","slug":"api-crushrewards-dev-5a70c258","name":"Crush Rewards Promo Intelligence","description":"Real-time pricing, promotions, and competitive intelligence across US and Canadian retailers — exposed as paid API endpoints and MCP tools that AI agents can call directly, with x402 and MPP micropayments per query.","url":"https://api.crushrewards.dev/v1/marketing/promo-intelligence","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"to":"2024-03-31","from":"2024-01-01","country":"us","category":"beauty","retailer":"amazon"}}},"response":{"meta":{"computed_at":"2026-06-13T04:29:02.579Z","served_from":"live","schema_version":"v3","freshness_seconds":69247},"brand":null,"brands":[],"window":{"to":"2024-04-01","from":"2024-01-01","preset":"custom","timezone":"UTC","granularity":"daily"},"country":"us","category":"beauty","currency":"USD","resolved":{"alternates":[],"category_id":null,"match_source":"slug","category_path":"beauty","match_confidence":1},"aggregate_by":"brand"}},"exampleRequest":{"to":"2024-03-31","from":"2024-01-01","country":"us","category":"beauty","retailer":"amazon"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8hH4AacCQacD1DX8hu_KN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes promotional activity for brands within a product category, returning promo frequency, average discount depth, and max discount depth per brand over a date range.","exampleAgentPrompt":"Show me the promotional activity for brands in the 'beauty' category on Amazon in the US from 2024-01-01 to 2024-03-31 — I want to see which brands ran promos most often and how deep their discounts went.","exampleUseCases":null,"resultDescription":"Returns an array of brands within the specified category, each with: total product observations, number of promotional observations, promo frequency as a percentage, average promotional discount depth percentage, and maximum promotional discount depth percentage. Also includes the queried category, country, and currency code.","failureModes":["Missing required 'category' parameter returns a 400 validation error","Invalid date format (non-ISO 8601) returns a 400 error","Unsupported country code returns a 400 enum validation error","Unsupported retailer value returns a 400 enum validation error","No data available for the specified category/date range may return an empty brands array","Payment failure or insufficient USDC balance returns a 402 Payment Required error"],"whenToPreferThis":"Use this endpoint when you need brand-level promotional intelligence within a specific product category — specifically promo frequency and discount depth metrics. Prefer this over generic price history or product-level endpoints when the goal is competitive analysis of how aggressively different brands are discounting. It is best suited for marketing analysts, category managers, or agents comparing brand promotional strategies across retailers like Amazon, Walmart, or Costco.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:36.748Z","isFirstParty":false}