# x402 Social Stats API by FindClout

The first x402 native social media analytics API. Live stats for public social
media posts and profiles: views, likes, comments, shares, and follower counts
for Instagram, TikTok, and X (Twitter), looked up by URL at request time. It
returns everything an Instagram, TikTok, or Twitter scraper would give you,
without you running a scraper: no account, no API key, no signup, no credit
card, no proxies, no credits. Payment is attached to each HTTP request via the
x402 protocol. YouTube support is coming soon.

Base URL: https://x402.findclout.com

## Paid endpoints (all GET, $0.01 per request each)

1. GET /api/v1/post?url=<postUrl>
   Universal lookup. Detects platform by hostname (instagram.com, tiktok.com,
   twitter.com or x.com). Returns url, username, views, likes, comments,
   shares, and followers when the platform provides it (TikTok, X).
   Best single tool for AI agents.

2. GET /api/v1/instagram/post?url=<url>  (also accepts ?code=<shortcode>)
   Instagram post, reel, or IGTV stats. Returns username, views, likes,
   comments. Photos return views: null. shares is always 0 on Instagram.

3. GET /api/v1/instagram/user?username=<handle>
   Instagram profile. Returns username, fullName, followers, following,
   posts, isVerified, isPrivate, biography, profilePicUrl.

4. GET /api/v1/tiktok/post?url=<url>
   TikTok video stats. Returns username, views, likes, comments, shares,
   and the author's follower count in the same response.

5. GET /api/v1/x/post?url=<statusUrl>  (also accepts ?id=<tweetId>)
   X (Twitter) post stats. Returns username, views, likes, comments
   (replies), shares (retweets), and the author's follower count.

Success envelope: {"success": true, "platform": "instagram|tiktok|x",
"fetchedAt": "<ISO 8601>", ...}. Numbers are integers or null.

Errors and charging: 4xx responses are never charged. Bad or unsupported URL
returns HTTP 400 (unpaid). A post or user that does not exist or is private
returns HTTP 200 with {"success": false, "error": "not_found"} (charged).
Upstream failure returns HTTP 502 (unpaid).

Free endpoints: GET /api/v1/pricing (JSON pricing info), GET /healthz,
GET /openapi.json (OpenAPI 3.1 spec), GET /llms.txt (this file).

## Payment protocol

- Protocol: x402 version 2, "exact" scheme.
- Price: $0.01 per request = 10000 atomic units of USDC (6 decimals).
- Network: Base mainnet, CAIP-2 id eip155:8453.
- Asset (USDC on Base): 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- payTo: 0xD5997d52769Fc6abd86B0E6d0f0e85F31F118bd8
- Facilitator: https://facilitator.payai.network
- An unpaid request returns HTTP 402 with an accepts[] array describing the
  payment terms. The client signs an EIP-3009 USDC transfer authorization and
  retries with the payment attached. The paying wallet needs USDC on Base but
  no ETH: settlement is gasless for the payer. The settlement receipt is
  returned in the PAYMENT-RESPONSE header.

## Minimal paying client (Node)

  import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
  import { ExactEvmScheme } from "@x402/evm";
  import { privateKeyToAccount } from "viem/accounts";

  const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY);
  const fetchWithPay = wrapFetchWithPaymentFromConfig(fetch, {
    schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
  });

  const res = await fetchWithPay(
    "https://x402.findclout.com/api/v1/post?url=" +
      encodeURIComponent("https://www.tiktok.com/@user/video/123")
  );
  console.log(await res.json());

## About FindClout

FindClout runs the biggest independently owned American meme page network,
with sports, finance, entrepreneurship, movie, TV, and music pages reaching
real American audiences, and this API is the measurement layer we use for
our own campaigns. What we sell is native distribution:
brands placed inside viral clips that real American audiences already love,
so the product becomes familiar through repeated in-content exposure rather
than skippable ads. Campaigns are priced on delivered views at CPMs you can
verify yourself with this API. If you are a brand or advertiser and want the
views rather than just the numbers, book a call at findclout.com
(https://findclout.com).