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

> Six personas, four price points, thirty-one paid endpoints.

Syntalic organizes its 31 paid endpoints into 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. A social scout wants who is talking about a shelf, and whether that attention matches distribution. 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 |
| `brand-breakdown` | A brand's assortment broken down by category |
| `retailer-assortment` | Which retail chains carry a brand or category |
| `availability-index` | Out-of-stock rates by retailer or category |

### 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 |
| `price-bands` | Price architecture of one browse-node shelf |
| `category-summary` | Category-level pricing distribution and stats |
| `category-concentration` | How concentrated a category is |
| `price-change-leaders` | Biggest price movers over 7, 30, or 90 days |

### Taxonomy — \$0.01 / request

GS1 GPC identity lookups, priced per request (up to 100 ids).

| Endpoint | Purpose |
| - | - |
| `classify` | Resolve product types to GPC bricks |
| `reverse` | GPC codes → retailer browse nodes |
| `brick-attributes` | GS1 attribute schema for a brick |

### Social — \$0.03 / query

TikTok and Instagram mention rankings, scoped to one browse **category root** (for example `grocery-gourmet-food` or `beauty-personal-care`). There is no `subcategory` filter and `subject_kind` is `brand` or `category` only. `organic_only` is a live filter. Aisle slugs such as `beverages` are not a social subcategory.

| Endpoint | Purpose |
| - | - |
| `creator-index` | Creators ranked by mention volume |
| `brand-share` | Share of conversation by brand |
| `category-structure` | Subcategory ownership of a category's conversation (**rollup not published yet**) |
| `brand-momentum` | Brands rising, falling, or newly appearing |
| `topic-trends` | Emerging conversation topics (**rollup not published yet**) |
| `product-type-trends` | Attention by product type (**rollup not published yet**) |
| `series` | Weekly mentions/views for one brand or category |

### Scout — \$0.05 / query

The only routes that bind social conversation and the retail shelf to one category axis.

| Endpoint | Purpose |
| - | - |
| `attention-vs-shelf` | Share-of-conversation vs share-of-shelf gap |
| `launch-buzz` | New shelf arrivals vs conversation around their brand |

## 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, Marketing, and Taxonomy tiers serve lookup-style use cases. Social answers are ranked comparisons over a bought corpus (TikTok + Instagram), so they sit above Analyst. Scout binds both corpora, which is why it is priced above Social.

Unpublished social rollups return `404 NOT_PUBLISHED` and are **not billed**. That is a gap in what we publish, not a finding that the category is quiet.

## Volume discounts

Above 100k requests/month, we offer custom pricing. [Get in touch](mailto:support@syntalic.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.