# Syntalic Taxonomy Reference Lookup

> Syntalic Taxonomy Reference Lookup 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-13).

Resolves up to 100 taxonomy IDs into their reference metadata (names, hierarchy, classification details) for retail product categorization.

## Facts

- Endpoint: GET https://api.syntalic.com/v1/reference/classify
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntalic-taxonomy-reference-lookup-a07cf025
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9svvrqV2LcHiQMpsq4_bJ

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-taxonomy-reference-lookup-a07cf025
```

Example prompt: Can you look up the taxonomy reference details for these category IDs — 1042, 3871, and 5520 — and tell me their names and where they sit in the retail hierarchy?

## When to prefer this

Use this endpoint when you need to decode or enrich raw taxonomy/category IDs into human-readable reference data within the Syntalic retail intelligence ecosystem, especially when building pipelines that consume other Syntalic endpoints (like Price Dispersion, Promo Intelligence, or Competitive Landscape) and need to resolve the category identifiers those endpoints return. Supports batch lookups of up to 100 IDs per call at $0.01, making it cost-efficient for enrichment workflows.

## Known failure modes

- Invalid taxonomy IDs return empty or error entries per ID
- Exceeding 100 IDs per request results in a validation error
- Unknown or deprecated taxonomy IDs may return null metadata
- Payment failure via x402 blocks the request entirely
- Malformed request body returns a 400 error

## How this service works

Real-time CPG analytics for brand & marketing teams — live pricing, share-of-shelf, and promo intelligence across US and Canadian retailers. Your agent runs the queries; you get the charts on a dashboard you keep. Pay-per-call via x402 and MPP.

## Output

Returns reference metadata for each requested taxonomy ID, including human-readable category names, hierarchical position, and classification labels, for up to 100 IDs per request.

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/syntalic-taxonomy-reference-lookup-a07cf025/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)