# Price Positioning

> Price Positioning is a paid API for AI agents from api.syntalic.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Compares a brand's average price to its category average/median and classifies the brand as premium, mid-range, or value positioned.

## Facts

- Endpoint: GET https://api.syntalic.com/v1/marketing/price-positioning
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402, shopping
- Canonical page: https://www.zero.xyz/c/price-positioning-7f461c41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pj00uLG12oSGJTBRxrcU-

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 price-positioning-7f461c41
```

Example prompt: Is Apple positioned as a premium, mid-range, or value brand in the US electronics category compared to the category average price?

## When to prefer this

Use this endpoint when you need to understand how a specific brand's pricing compares to its category peers and want a clear premium/mid-range/value classification. Prefer this over Brand Tracker (which tracks a single brand's price over time) or Competitive Landscape (which returns all products in a category) when the goal is a single, fast classification of brand positioning rather than trend data or full competitive product lists.

## Known failure modes

- Brand not found in the dataset — returns empty or null result
- Category string cannot be resolved to a canonical category_id — fuzzy matching may fail for very niche or misspelled inputs
- Country not supported (only 'us' and 'ca' are valid) — invalid country returns validation error
- Insufficient pricing data for the brand/category combination — result may be unreliable or absent
- Missing required 'brand' parameter — returns 400 validation error

## How this service works

Compare a brand's average price to the category average/median and classify positioning as premium, mid-range, or value.

## Output

Returns a pricing classification (premium, mid-range, or value) for the specified brand, along with the brand's average price versus the category average and median price, enabling quick benchmarking of a brand's price tier within its market.

## Example request

```json
{
 "brand": "Nike",
 "country": "us",
 "category": "footwear"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "brand"
 ],
 "properties": {
  "brand": {
   "type": "string",
   "example": "Apple",
   "minLength": 1,
   "description": "Brand name (e.g., Sony, Samsung, Nike)"
  },
  "country": {
   "enum": [
    "us",
    "ca"
   ],
   "type": "string",
   "default": "us",
   "example": "us",
   "description": "Country (us or ca)"
  },
  "category": {
   "type": "string",
   "example": "electronics",
   "minLength": 1,
   "description": "Product category (e.g., electronics, grocery, beauty). Fuzzy human-readable input — the resolver maps it through tier 1-4 (id → exact name → trigram → embedding kNN) to a canonical category_id. Pair with `category_id` if you have a deterministic id from a prior call."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/price-positioning-7f461c41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.syntalic.com](https://www.zero.xyz/host/api.syntalic.com/llms.txt)