# Syntalic Social Signals Series

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

Retrieves weekly time-series social engagement data for a brand or category across TikTok and Instagram, optionally filtering by organic posts only

## Facts

- Endpoint: POST https://api.syntalic.com/v1/social/series?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntalic-social-signals-series-b61fa946
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B3cgod7cwNtNxJyHoujl7

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-social-signals-series-b61fa946 -d '<json body>'
```

Example prompt: Pull the last 26 weeks of social signal data for Olipop in the grocery-gourmet-food category across both TikTok and Instagram, organic posts only.

## When to prefer this

Choose this endpoint when you need weekly time-series social engagement data for a specific brand or an entire product category on TikTok and/or Instagram. It is ideal for trend analysis, campaign performance monitoring, and benchmarking organic vs paid social volume over configurable multi-week windows. Prefer this over point-in-time social queries when you need historical trajectory rather than a snapshot.

## Known failure modes

- Missing required 'category' query parameter returns a validation error
- Invalid or unrecognized brand key (subject) may return empty series or 404
- Requesting more than 104 weeks (max) returns a schema validation error
- Invalid platform enum value (not 'all', 'tiktok', or 'instagram') causes request rejection
- Using HTTP methods other than GET/HEAD/DELETE (e.g. POST in the body) may be rejected by the schema wrapper
- Data may be sparse or missing for niche brands with low social presence

## How this service works

Social signals query - $0.03 per request

## Output

Returns a time-series array of weekly social signal data points for the specified brand or category, covering the requested number of trailing ISO weeks. Each data point likely includes engagement or volume metrics segmented by platform (TikTok, Instagram, or combined), with optional filtering to organic-only posts. Useful for charting trends, identifying spikes, and benchmarking social momentum.

## 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": {
      "weeks": {
       "type": "integer",
       "default": 26,
       "maximum": 104,
       "minimum": 1,
       "description": "How many trailing ISO weeks to return."
      },
      "subject": {
       "type": "string",
       "example": "olipop",
       "description": "The subject key (brand_key). Required unless subject_kind=category, where it defaults to `category`."
      },
      "category": {
       "type": "string",
       "example": "grocery-gourmet-food",
       "description": "Category root slug the subject is scoped to (department, not aisle)."
      },
      "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."
      },
      "subject_kind": {
       "enum": [
        "brand",
        "category"
       ],
       "type": "string",
       "default": "brand",
       "description": "What kind of subject to chart. Brand or category only."
      }
     },
     "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-social-signals-series-b61fa946/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)