{"uid":"cap_Pt71KVdOP-L8EcoKr2ny7","slug":"api-crushrewards-dev-a14f6c8b","name":"Crush Rewards Retailer Price Index","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/analyst/retailer-index","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"to":"2025-01-31","from":"2025-01-01","country":"us","category":"electronics","retailer":"amazon"}}},"response":{"meta":{"computed_at":"2026-06-17T04:12:54.103Z","served_from":"live","schema_version":"v3","freshness_seconds":75665},"window":{"to":"2025-01-31","from":"2025-01-01","preset":"custom","timezone":"UTC","granularity":"weekly"},"country":"us","category":"electronics","currency":"USD","resolved":{"alternates":[],"category_id":null,"match_source":"slug","category_path":"electronics","match_confidence":1},"retailer":"amazon","department":null,"time_series":[],"sample_threshold":5,"stable_basket_size":null,"insufficient_sample":false,"insufficient_sample_points":0}},"exampleRequest":{"to":"2025-01-31","from":"2025-01-01","country":"us","category":"electronics","retailer":"amazon"},"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wPDckDtFZSm5zkfJTFUTe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a normalized daily price index (retailer average price / category average price) for a specific retailer over a date range, showing how a retailer prices relative to its category baseline.","exampleAgentPrompt":"Can you show me the day-by-day price index for Amazon in the electronics category in the US from January 1 to January 31, 2025 — I want to see how their pricing compares to the category average?","exampleUseCases":null,"resultDescription":"Returns a time-series array with one entry per day in the requested range, each containing: the date, the retailer's average price, the category-wide average price, a normalized price_index (retailer_avg / category_avg, where >1 means the retailer prices above category average), and a product count. Also includes top-level fields for retailer name, category, country, and currency code.","failureModes":["Missing required 'retailer' parameter returns a 400 validation error","Invalid retailer value (not in enum) returns a 400 error — only amazon, walmart, costco, homedepot, nordstrom, ikea are supported","Date range with no data returns an empty time_series array","price_index may be null for dates where category_avg_price is unavailable or zero","category_avg_price may be null if insufficient cross-retailer data exists for that day","Payment failure or insufficient USDC balance returns a 402 response blocking the call","Unsupported country code (not 'us' or 'ca') returns a 400 validation error"],"whenToPreferThis":"Use this endpoint when you need to understand how a specific retailer's pricing positions relative to its category peers on a day-by-day basis — ideal for competitive pricing analysis, retailer benchmarking, or detecting when a retailer shifts pricing strategy. Prefer this over raw price history endpoints when you need a normalized, comparable index rather than absolute prices. Best for analysts monitoring whether a retailer is a price leader or price follower within a category.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:20.033Z","isFirstParty":false}