{"uid":"cap_lJdnbHgFhiJwElyIIYbg7","slug":"api-crushrewards-dev-ab9fd2c7","name":"CrushRewards Price History","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/shopper/price-history","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"q":"laptop"}}},"response":{"query":"laptop","trend":null,"country":"us","currency":"USD","retailer":"target","condition":"new","period_avg":24.99,"period_low":24.99,"period_high":24.99,"is_good_deal":null,"observations":[{"date":"2026-05-20","price":24.99}],"product_name":"Uncaged Ergonomics Swivel Laptop Stand, Adjustable Laptop Riser for Desk to Raise, Tilt, Rotate & Cool Laptops Ergonomic Laptop Stand","current_price":24.99,"observation_count":1,"insufficient_history":true}},"exampleRequest":{"q":"laptop"},"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_q3KDbGmJ2KSpnRzFasUAp","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":"Returns historical price observations for a product over a date range, including current price, period low/high/avg, trend direction, and a good-deal flag.","exampleAgentPrompt":"Can you pull up the price history for 'Sony WH-1000XM5 headphones' on Amazon in the US from January 1 to June 30 this year, and tell me if it's currently a good deal based on the trend?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the matched product name, retailer, currency, current price, period low/high/average prices, a trend enum (rising/falling/stable), a boolean good-deal flag, and a dated time-series array of price observations suitable for charting.","failureModes":["No matching product found for the query — returns empty or null result","Invalid date format (non-ISO 8601) causes a 400 validation error","Unsupported retailer or country code causes a 400 validation error","Query string too short or missing causes a 400 required-field error","Payment not processed or x402 header missing causes a 402 Payment Required error","Date range with no historical data returns an empty observations array"],"whenToPreferThis":"Use this endpoint when you need historical price data and trend analysis for a specific product at a specific retailer, including whether the current price is a good deal relative to its history. Prefer this over category-level or brand-level endpoints when the user has a specific product in mind and wants a time-series for charting or a buy/wait recommendation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:33:56.998Z","isFirstParty":false}