# Audience & Engagement Stats

> Audience & Engagement Stats is a paid API for AI agents from social.duoleads.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns follower counts, post counts, and average engagement metrics (likes, comments, views, engagement rate) for a single TikTok, Instagram, YouTube, or Threads account.

## Facts

- Endpoint: GET https://social.duoleads.com/v1/social/audience?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/audience-engagement-stats-182346c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5ux7FT1nmNLp7O-pKuuqc

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 audience-engagement-stats-182346c7
```

Example prompt: What are the follower count and engagement rate for the Instagram account @glossier — I need the average likes, comments, and views over their last 20 posts.

## When to prefer this

Choose this endpoint when you need a quick, low-cost snapshot of an account's audience size and engagement health without needing individual post text, follower identities, or detailed post-level data. Ideal for influencer vetting, competitive benchmarking, or pre-campaign due diligence where aggregate metrics are sufficient. Prefer this over full profile scraping endpoints when privacy constraints matter, since it returns no names or post content.

## Known failure modes

- Account not found on the specified platform — no charge applied
- Handle does not match any public account — no charge applied
- Platform value not in allowed enum (tiktok, instagram, youtube, threads) — bad input, no charge
- Account is private or has no public post history — incomplete or empty metrics
- Rate limiting or upstream data provider outage — temporary error response
- X/Twitter not supported unless its key is separately enabled

## How this service works

Audience & Engagement Stats: numbers only for one TikTok, Instagram, YouTube or Threads account, or X when its key is enabled: followers, following, posts, and the average likes, comments and views over its last 20 posts, with the engagement rate in percent. No follower names, no post text. Influencer vetting and benchmarking. Bad input is free; not found or no match is not charged.

## Output

A JSON object containing the platform queried, the handle, a timestamp, follower count, following count, total post count, average likes per post, average comments per post, average views per post, engagement rate as a percentage, and number of posts sampled (up to 20). Also includes a disclaimer about data sourcing and a unique request ID.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "platform",
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "maxLength": 200,
       "description": "The account's handle (with or without @) or its profile URL on that platform."
      },
      "platform": {
       "enum": [
        "tiktok",
        "instagram",
        "x",
        "youtube",
        "threads"
       ],
       "type": "string",
       "description": "One of tiktok, instagram, x, youtube, threads."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-15T12:00:00.000Z",
  "items": [],
  "query": {
   "handle": "synthcreator",
   "platform": "tiktok"
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "audience": {
   "posts": 213,
   "avg_likes": 3000,
   "avg_views": 28496,
   "followers": 44240,
   "following": 81,
   "avg_comments": 30,
   "posts_sampled": 2,
   "engagement_rate_pct": 6.849
  },
  "complete": true,
  "platform": "tiktok",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000",
  "next_cursor": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/audience-engagement-stats-182346c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.duoleads.com](https://www.zero.xyz/host/social.duoleads.com/llms.txt)
