# StableSocial Brand Mentions

> StableSocial Brand Mentions is a paid API for AI agents from stablesocial.dev, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-13).

Searches across TikTok, Instagram, Facebook, Reddit, and LinkedIn for mentions of a specific brand, returning an async job for polling results.

## Facts

- Endpoint: POST https://stablesocial.dev/api/lightreel/brand-mentions
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablesocial-brand-mentions-278c6e6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oHgLs4QiWga9TkBPhLtL5

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 stablesocial-brand-mentions-278c6e6d -d '<json body>'
```

Example prompt: Search StableSocial for brand mentions of 'Notion' across TikTok, Instagram, Facebook, Reddit, and LinkedIn and pull back everything people are saying about them.

## When to prefer this

Choose this endpoint when you need to aggregate brand mention data across multiple social platforms simultaneously without setting up subscriptions or authentication. Ideal for one-off brand audits, competitive research, or social listening tasks where pay-per-request pricing is preferable to a monthly subscription. Use over platform-specific endpoints when you need cross-platform coverage in a single call.

## Known failure modes

- Invalid or missing brand name in request body returns 400
- Payment of $0.06 USDC not included or rejected returns 402
- Job times out or social platforms are unavailable returns 500 or failed status on poll
- Poll URL returns still-pending status if called too early
- Brand with no mentions returns empty results array on completed job

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

An async job object containing a jobId, a status field (initially 'pending'), a pollUrl to check for results, and a retryAfterSeconds value indicating when to poll again. The agent must poll the returned URL to get the actual mention data once the job completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brand": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "Brand, product, app, artist, creator, or campaign to monitor"
  },
  "platform": {
   "enum": [
    "any",
    "tiktok",
    "instagram",
    "twitter",
    "x",
    "youtube",
    "facebook",
    "reddit"
   ],
   "type": "string",
   "default": "any",
   "description": "Social platform to focus on"
  },
  "timeframe": {
   "type": "string",
   "default": "this week",
   "maxLength": 120,
   "minLength": 1,
   "description": "Time window to focus on, e.g. this week, last 30 days"
  },
  "competitors": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 300,
    "minLength": 1
   },
   "default": [],
   "maxItems": 10,
   "description": "Optional competitor brands, products, or accounts to include"
  },
  "max_mentions": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum mentions, examples, or posts to return"
  },
  "conversation_id": {
   "type": "string",
   "minLength": 1,
   "description": "Lightreel conversation ID returned by a prior chat response"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "clx0000000000000000000000",
  "status": "pending",
  "pollUrl": "https://stablesocial.dev/api/jobs/clx0000000000000000000000",
  "retryAfterSeconds": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-brand-mentions-278c6e6d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)