# Crush Rewards Promo Intelligence

> Crush Rewards Promo Intelligence is a paid API for AI agents from api.crushrewards.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Analyzes promotional activity for brands within a product category, returning promo frequency, average discount depth, and max discount depth per brand over a date range.

## Facts

- Endpoint: GET https://api.crushrewards.dev/v1/marketing/promo-intelligence
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-crushrewards-dev-5a70c258
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SKdqPw7tltgtxvosi34dE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-crushrewards-dev-5a70c258
```

Example prompt: Show me the promotional activity for brands in the 'beauty' category on Amazon in the US from 2024-01-01 to 2024-03-31 — I want to see which brands ran promos most often and how deep their discounts went.

## When to prefer this

Use this endpoint when you need brand-level promotional intelligence within a specific product category — specifically promo frequency and discount depth metrics. Prefer this over generic price history or product-level endpoints when the goal is competitive analysis of how aggressively different brands are discounting. It is best suited for marketing analysts, category managers, or agents comparing brand promotional strategies across retailers like Amazon, Walmart, or Costco.

## Known failure modes

- Missing required 'category' parameter returns a 400 validation error
- Invalid date format (non-ISO 8601) returns a 400 error
- Unsupported country code returns a 400 enum validation error
- Unsupported retailer value returns a 400 enum validation error
- No data available for the specified category/date range may return an empty brands array
- Payment failure or insufficient USDC balance returns a 402 Payment Required error

## How this service works

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.

## Output

Returns an array of brands within the specified category, each with: total product observations, number of promotional observations, promo frequency as a percentage, average promotional discount depth percentage, and maximum promotional discount depth percentage. Also includes the queried category, country, and currency code.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "to": "2024-03-31",
   "from": "2024-01-01",
   "country": "us",
   "category": "beauty",
   "retailer": "amazon"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-crushrewards-dev-5a70c258/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.crushrewards.dev](https://www.zero.xyz/host/api.crushrewards.dev/llms.txt)