# Syntalic Category Concentration Analysis

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

Returns market concentration metrics for a product category, showing how sales or shelf presence is distributed across brands and retailers

## Facts

- Endpoint: POST https://api.syntalic.com/v1/analyst/category-concentration?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntalic-category-concentration-analysis-13561989
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2n01VSyG_Nb8G0X5TvDiT

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-category-concentration-analysis-13561989 -d '<json body>'
```

Example prompt: How concentrated is the electronics category in the US right now — are a few brands dominating most of the shelf, or is it fragmented across many players?

## When to prefer this

Use this endpoint when you need to understand the competitive structure of a product category — specifically how concentrated or fragmented brand and retailer presence is. Prefer this over Category Summary when your goal is market power analysis rather than simple counts or pricing statistics. Use GPC code input when a product type spans multiple shelf categories across retailers for broader coverage.

## Known failure modes

- Missing or invalid category parameter returns a 400 error
- Unrecognized category string that cannot be matched to the taxonomy returns empty or error
- Invalid GPC code format (not exactly 8 digits) may fail to match
- Unsupported country code outside 'us' or 'ca' returns validation error
- Payment failure or missing x402 payment header results in 402 response

## How this service works

Analyst/market-level query - $0.02 per request

## Output

Returns concentration metrics for the specified product category or GPC product type, including how brand and retailer presence is distributed — enabling analysis of market dominance, fragmentation, or competitive balance within a category.

## 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",
     "required": [
      "category"
     ],
     "properties": {
      "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'."
      }
     },
     "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-category-concentration-analysis-13561989/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)