> ## 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.

# Pricing tiers

> Three personas, two price points, thirteen endpoints.

Syntalic 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](mailto:support@crushrewards.dev).