{"uid":"cap_SHWwhyhq_J9fhu-cdnqQD","slug":"api-crushrewards-dev-7cfa370d","name":"Crush Rewards Category Summary","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/category-summary","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"country":"us","category":"electronics","retailer":"amazon"}}},"response":{"meta":{"served_from":"mv","schema_version":"v2","freshness_seconds":1239608},"country":"us","pricing":{"avg":114.11,"max":552.26,"min":9.99,"median":79.99},"category":"electronics","currency":"USD","resolved":{"alternates":[],"category_id":"3429","match_source":"exact","category_path":"electronics","match_confidence":1},"avg_rating":4.45,"top_brands":[{"brand":"pxton","product_count":1},{"brand":"ELEGOO","product_count":1},{"brand":"BOJACK","product_count":1},{"brand":"Amazon","product_count":1},{"brand":"SCRIB3D","product_count":1},{"brand":"MaxTalker","product_count":1},{"brand":"Retevis","product_count":1},{"brand":"SPOOBOOLA","product_count":1},{"brand":"EVAPLUS","product_count":1},{"brand":"Amazon Basics","product_count":1}],"brand_count":10,"product_count":10,"promo_rate_pct":22.2,"retailer_count":1,"in_stock_rate_pct":55.6}},"exampleRequest":{"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_Tb73D5t2QXHM4Xdf4xkrb","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":"Returns high-level statistics for a product category including product/brand/retailer counts, pricing (avg/min/max/median), average rating, promotional rate, in-stock rate, and top brands.","exampleAgentPrompt":"Can you give me a category summary for electronics in the US on Amazon — I want to see how many products and brands there are, average and median pricing, the in-stock rate, and which brands show up the most?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the category name, country, currency, total product count, brand count, retailer count, pricing stats (avg/min/max/median), average rating, promotional rate percentage, in-stock rate percentage, and an array of top brands each with their product count.","failureModes":["Missing required 'category' query parameter returns a 400 validation error","Invalid retailer enum value (not in amazon/walmart/costco/homedepot/nordstrom/ikea) returns 400","Invalid country code (not 'us' or 'ca') returns 400","Category with no matching data returns null pricing and rating fields with zero counts","Payment not provided or x402 payment fails results in 402 response","Empty string for category returns a minLength validation error"],"whenToPreferThis":"Use this endpoint when you need a bird's-eye overview of a product category — aggregate counts, pricing benchmarks, and top brands — rather than individual product-level data. Ideal for market research, competitive benchmarking, and category health checks. Prefer this over the price-spread or inflation endpoints when you want a single holistic snapshot rather than trend or distribution analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:37:02.144Z","isFirstParty":false}