Documentation Index
Fetch the complete documentation index at: https://crushrewards.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
Crush Rewards organizes its 13 endpoints into three persona-based namespaces. Each namespace has a single price point — there is no per-endpoint pricing within a tier.
Why personas?
Different agents call this API for fundamentally different reasons. A shopping assistant wants the cheapest place to buy AirPods right now. A brand strategist wants to track promo cadence across competitors over the last quarter. An economist wants category-level inflation signals. Bundling endpoints by use case keeps the surface area legible.
Tiers
Shopper — $0.01 / query
Point-in-time pricing answers for shopping assistants and price-tracking tools.
| Endpoint | Purpose |
|---|
best-price | Cheapest current price across all covered retailers |
price-history | Time-series price for a product |
deal-finder | Products currently below their typical price |
price-drop-alert | Products that dropped in the last N days |
Marketing — $0.01 / query
Competitive intelligence for brand and category managers.
| Endpoint | Purpose |
|---|
competitive-landscape | Per-retailer pricing across a competitor set |
brand-tracker | All products under a brand, with price + availability |
promo-intelligence | Promotional activity by retailer + brand |
share-of-shelf | What % of category listings each brand occupies |
price-positioning | Premium / mid / value positioning by brand |
Analyst — $0.02 / query
Aggregated, statistical, multi-product queries — more expensive because they touch more rows.
| Endpoint | Purpose |
|---|
inflation | Period-over-period price change for a category |
price-dispersion | Spread of prices for a product across retailers |
retailer-index | Average pricing posture of a retailer vs. category baseline |
category-summary | Category-level pricing distribution and stats |
Why the gap between tiers?
Analyst answers aggregate across many products to produce statistical signals like inflation rates and price distributions — they inform strategic, multi-product decisions. Shopper and Marketing tiers serve direct lookup-style use cases.
Volume discounts
Above 100k requests/month, we offer custom pricing. Get in touch.