# FindClout Social Post Stats

> FindClout Social Post Stats is a paid API for AI agents from x402.findclout.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns live engagement metrics (views, likes, comments, shares, author username, optional followers) for any public post URL from Instagram, TikTok, Twitter, or X.

## Facts

- Endpoint: GET https://x402.findclout.com/api/v1/post
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/findclout-social-post-stats-b24e836e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xnhdVSLyKQkEsUyC0Vi32

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 findclout-social-post-stats-b24e836e
```

Example prompt: Can you pull the live stats for this TikTok post — views, likes, comments, shares, and how many followers the author has? Here's the link: https://www.tiktok.com/@someuser/video/1234567890

## When to prefer this

Choose this endpoint when you have a raw public post URL from Instagram, TikTok, Twitter, or X and need live engagement metrics without knowing the platform in advance — it auto-detects the platform and returns a unified JSON response. Ideal for agents that receive arbitrary social links and need a single, cheap ($0.01) call to get stats. Prefer alternatives if you need bulk/batch processing, historical trend data, or private account analytics.

## Known failure modes

- Private or deleted post URL — returns success: false or null metrics
- Unsupported platform domain — platform not detected, request rejected
- Rate limiting or platform-side blocking — live fetch fails, metrics may be null
- Malformed URL passed as query param — request fails or returns error
- Payment not confirmed via x402 — 402 response before data is returned

## How this service works

Universal social post stats for $0.01. Pass any public post URL from instagram.com, tiktok.com, twitter.com, or x.com as ?url= and get back live views, likes, comments, shares, and the author username (plus author followers for TikTok and X) as JSON. The platform is auto-detected from the URL hostname. Great default endpoint for agents that just have a link.

## Output

A JSON object containing: success boolean, platform name (instagram/tiktok/x), the original URL, views, likes, comments, shares (all nullable numbers), the author's username (nullable string), followers count (nullable, available for TikTok and X only), and a fetchedAt ISO timestamp indicating when data was retrieved.

## 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": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public post URL from instagram.com, tiktok.com, twitter.com, or x.com"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string"
      },
      "likes": {
       "type": [
        "number",
        "null"
       ]
      },
      "views": {
       "type": [
        "number",
        "null"
       ]
      },
      "shares": {
       "type": [
        "number",
        "null"
       ]
      },
      "success": {
       "type": "boolean"
      },
      "comments": {
       "type": [
        "number",
        "null"
       ]
      },
      "platform": {
       "enum": [
        "instagram",
        "tiktok",
        "x"
       ],
       "type": "string"
      },
      "username": {
       "type": [
        "string",
        "null"
       ]
      },
      "fetchedAt": {
       "type": "string"
      },
      "followers": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findclout-social-post-stats-b24e836e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.findclout.com](https://www.zero.xyz/host/x402.findclout.com/llms.txt)