Get any Instagram follower count by API

Follower count is the denominator of social media. Every serious question you ask about an Instagram account, is this creator worth the rate card, is this engagement organic, is this brand actually growing, divides something by followers. Which makes it strange that getting the number programmatically for an account you do not own has been awkward for a decade. The official API will not tell you, tool sites are unreliable, and scraping profile pages is a maintenance treadmill.

Here is the boring, durable answer: one GET request that returns the full public profile of any Instagram account for $0.01, with no login, no Meta developer app, and no API key.

The endpoint

GET /api/v1/instagram/user?username=<handle> is the profile lookup on the x402 Social Stats API. Payment is attached to the request itself via the x402 protocol, so the whole integration is a wrapped fetch:

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

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

const res = await payFetch(
  "https://x402.findclout.com/api/v1/instagram/user?username=nba"
);
console.log(await res.json());

The response is the complete public profile in one envelope:

{
  "success": true,
  "platform": "instagram",
  "fetchedAt": "2026-07-19T16:20:07.000Z",
  "username": "nba",
  "fullName": "NBA",
  "followers": 89214550,
  "following": 1104,
  "posts": 51230,
  "isVerified": true,
  "isPrivate": false,
  "biography": "The official account of the NBA.",
  "profilePicUrl": "https://..."
}

Nine fields, and every one earns its place. followers and following are the headline numbers. posts is the account's media count, useful for computing average performance per post. isVerified and isPrivate are the two flags that gate most downstream logic: a private account will not have readable post stats, and verification is a cheap authenticity signal. biography and profilePicUrl let you render or classify the account without a second data source. fetchedAt timestamps the reading so you can build honest time series.

What people actually build with follower counts

• Rate sanity checks. A creator quotes you $4,000 per reel and claims 800k followers. One cent confirms the count before the negotiation goes further, and a second lookup a week later tells you whether the count is stable, growing, or suspiciously jumpy.
• Engagement ratio math. Views mean little without audience size. Pull post views and profile followers together and you can compute views per follower, the single most useful screen for spotting inflated accounts. We wrote a full playbook in how advertisers detect inflated influencer numbers.
• Growth tracking. Poll a watchlist of accounts daily and store the counts. Fifty accounts checked every day for a month is fifteen dollars, which is less than most tools charge to track five.
• Lead enrichment. A CRM row with a handle becomes a row with followers, bio, and verification status, one paid call per record, no enrichment vendor contract.

Costs and error behavior, precisely

Every successful lookup costs $0.01 in USDC on Base, settled gaslessly for the payer through an EIP-3009 authorization: the paying wallet holds only USDC and never needs ETH. The mechanics are described in the payment section, and the terms are also published as free JSON at /api/v1/pricing if you want your code to read them.

Billing follows the fairness rule used across the API. A request with a missing or malformed username returns HTTP 400, and 4xx responses are never charged. A handle that does not exist returns HTTP 200 with {"success": false, "error": "not_found"}, which is charged, because the lookup ran and that is the answer. If our upstream infrastructure fails, you get a 502 and pay nothing. This matters when you automate: your retry logic can be aggressive on 502s and conservative on not_found, and your spend maps exactly to questions answered.

Why not the official route?

Meta's Graph API exposes follower counts through Instagram professional accounts and business discovery, and if you are building a product around accounts that authenticate with you, it is the sanctioned path. But it requires a developer app, app review, the right permission scopes, and an authenticated professional account to anchor the calls. For the everyday case, "here is a handle, how many followers," that machinery is wildly out of proportion, and for an AI agent it is a hard wall, since agents cannot pass app review. The full comparison, including where the official API genuinely wins, is in Instagram data without the Graph API.

The x402 model inverts the setup cost. There is nothing to apply for and nobody to wait on. Fund a wallet with five dollars of USDC and you have five hundred profile lookups, available in the next sixty seconds, to any handle on the platform.

Pairing profiles with posts

The profile endpoint gets most valuable when combined with its sibling, /api/v1/instagram/post. A common loop: pull a creator's profile once, then check their recent posts, and judge every view count against the follower base. Two endpoints, same one cent price, same envelope, documented side by side in the x402 Instagram API reference. TikTok is actually one call cheaper for this workflow, because the TikTok post endpoint returns the author's follower count in the same response.

This ratio work is not academic for us. FindClout pays creators across a network of large American sports, finance, entrepreneurship, movie, TV, and music pages based on verified views, and follower-to-view ratios are one of the checks that keep those payouts honest. The measurement layer we run our own money through is the same one you are calling here; that story is in why FindClout built this API.

The quickstart has the sixty second version: curl the endpoint, read the 402, wire the paying client, get your first follower count.