# Syntalic Availability Index

> Syntalic Availability Index is a paid API for AI agents from api.syntalic.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-27).

Returns a brand's product availability index across retail channels, aggregated by seller or category root, for competitive marketing analysis

## Facts

- Endpoint: POST https://api.syntalic.com/v1/marketing/availability-index?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntalic-availability-index-b2d4bd44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d5smFcTNVDXyo5DdslK0p

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 syntalic-availability-index-b2d4bd44 -d '<json body>'
```

Example prompt: What's Nike's availability index across US retailers in the footwear category, grouped by seller?

## When to prefer this

Use this endpoint when you need a quantitative measure of a brand's retail availability or share-of-shelf across sellers or category segments. It is distinct from price positioning (which compares price tiers) or promo intelligence (which tracks discounts) — this specifically indexes how widely a brand's products are stocked. Prefer it over the analyst-level or social signals endpoints when the user's question is about physical/digital retail presence and distribution breadth rather than pricing or sentiment.

## Known failure modes

- Missing required 'brand' or 'category' query params — returns 400 bad request
- Invalid country code (not 'us' or 'ca') — validation error
- Brand not found in catalog — may return empty index or zero values
- Unknown or unresolvable category string — no matching products found
- Payment failure (x402) — request rejected before processing
- Rate limiting or quota exceeded — 429 response

## How this service works

Marketing/competitive analysis query - $0.01 per request

## Output

A normalized availability index for the specified brand and category, broken down by the chosen aggregation dimension (retail seller or category root), reflecting how broadly the brand's products appear across retailer shelves in the selected country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "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 in the Shopify product taxonomy. Accepts a display path (e.g. 'Electronics > Computers > Laptops'), its slug form (e.g. 'electronics/computers/laptops'), a single path segment (e.g. 'laptops', 'headphones'), or an everyday shelf name (e.g. 'apparel', 'beauty', 'grocery'); matched against the catalog's category tree (exact node, subtree, or whole path segment). Also accepts a GS1 GPC code (exactly 8 digits, e.g. '10001159') to filter by PRODUCT TYPE instead of by shelf placement — the same product type is shelved under different categories by different retailers, so a category filter answers from a fraction of the data while a GPC code spans them. Coarser codes (class/family/segment) match every brick beneath them. Resolve a phrase to a code with /v1/reference/classify?q=... ; when a code is used, resolved.match_source is 'gpc'."
      },
      "aggregate_by": {
       "enum": [
        "seller",
        "category_root"
       ],
       "type": "string",
       "default": "seller",
       "description": "Dimension to group by: retail chain (default) or category root."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/syntalic-availability-index-b2d4bd44/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)