# Syntalic Attention vs Shelf

> Syntalic Attention vs Shelf is a paid API for AI agents from api.syntalic.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Compares social media attention (TikTok/Instagram signals) against retail shelf presence for brands within a product category, ranked by engagement metrics.

## Facts

- Endpoint: POST https://api.syntalic.com/v1/social/attention-vs-shelf
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntalic-attention-vs-shelf-b7acc2d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fv76tjl9sWbYgvqKBS5ne

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-attention-vs-shelf-b7acc2d2 -d '<json body>'
```

Example prompt: Which brands in the grocery-gourmet-food category are getting the most TikTok and Instagram buzz relative to their shelf presence right now? Give me the top 25 brands, using the last 30 days of data for the US market.

## When to prefer this

Choose this endpoint when you need to cross-reference social media momentum (TikTok/Instagram) with actual retail shelf presence for brand ranking within a specific product category. It is uniquely suited for identifying brands whose social buzz is disproportionate to their market shelf share — a signal not available from pure social analytics or pure retail shelf tools. Prefer it over general social listening tools when you need the shelf-side join, and over share-of-shelf endpoints when social attention context is also needed.

## Known failure modes

- Invalid or unsupported category slug returns an error — only pre-computed category root slugs are accepted, no wildcards
- Requesting a time window not yet published (e.g. a future 90d window) returns an error
- Limit outside 1–100 range is rejected
- Unsupported country code (only 'us' and 'ca' are valid) returns validation error
- Payment failure or insufficient USDC balance returns 402 response

## How this service works

Social signals query - $0.03 per request

## Output

A ranked list of brands within the specified category, each with a social attention score derived from TikTok and/or Instagram engagement and a corresponding retail shelf presence metric, allowing comparison of digital buzz against physical/digital retail footprint. Results are filtered by country, platform, and time window as specified.

## 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": {
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum ranked brands to return."
      },
      "window": {
       "enum": [
        "7d",
        "30d",
        "90d"
       ],
       "type": "string",
       "default": "30d",
       "description": "Rollup window. Only published windows are accepted."
      },
      "country": {
       "enum": [
        "us",
        "ca"
       ],
       "type": "string",
       "default": "us",
       "description": "Country for the SHELF side of the join."
      },
      "category": {
       "type": "string",
       "example": "grocery-gourmet-food",
       "description": "Category root slug. No wildcard: these answers are ranked comparisons."
      },
      "platform": {
       "enum": [
        "all",
        "tiktok",
        "instagram"
       ],
       "type": "string",
       "default": "all",
       "description": "TikTok and Instagram are the only platforms in the corpus."
      },
      "organic_only": {
       "type": "boolean",
       "default": false,
       "description": "Exclude posts marked as ads."
      }
     },
     "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-attention-vs-shelf-b7acc2d2/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)