GETInsights4–12 credits

Fake-follower audit

GET https://api.instagramapi.dev/v1/insights/profile/audit

Samples an account's followers and heuristically scores each for bot/throwaway signals (no profile picture, no display name, digit-heavy username, private + nameless), then estimates the real-follower percentage and assigns a quality grade. Includes a one-paragraph AI verdict for sponsorship decisions. Pass `sample` (1–500, default 100). Cost: 4–12 credits depending on the sample size.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

Name	Type	Required	Description
handle	string	yes	An Instagram account. Accepts a username (`nike`), a numeric user id (`13460080`), or a full profile URL (`https://instagram.com/nike`). We resolve it automatically.
sample	number	no	Followers to sample (1–500). Defaults to 100. More = more accurate, more credits.

Example request

curl "https://api.instagramapi.dev/v1/insights/profile/audit?handle=nike&sample=100" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/insights/profile/audit?handle=nike&sample=100", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/insights/profile/audit?handle=nike&sample=100",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 4 credits

API key

handle *string

samplenumber

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "username": "nike",
    "followers_total": 291952375,
    "sampled": 100,
    "suspected_fake_pct": 14,
    "estimated_real_pct": 86,
    "estimated_real_followers": 251079042,
    "quality_grade": "B",
    "signal_breakdown": {
      "no profile picture": 9,
      "digit-heavy username": 7,
      "no display name": 11
    },
    "summary": "A healthy audience: roughly 86% of sampled followers look authentic…"
  },
  "meta": {
    "endpoint": "insights/profile/audit",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 4,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"handle\".",
    "docs": "/docs/insights/profile/audit"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/insights/profile/audit"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "insights/profile/audit",
    "credits_charged": 4,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/insights/profile/audit"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
username	string	The account's @handle.
followers_total	number	The account's total follower count.
sampled	number	How many followers were sampled and scored.
suspected_fake_pct	number	Estimated percentage of sampled followers that look fake.
estimated_real_pct	number	Estimated percentage of sampled followers that look authentic.
estimated_real_followers	number	Total followers projected to be real (followers_total × estimated_real_pct).
quality_grade	string	Letter grade (A–F) for overall audience quality.
signal_breakdown	object	Count of how many sampled followers tripped each suspicious-signal heuristic.
signal_breakdown.no profile picture	number	Sampled followers with no profile picture.
signal_breakdown.digit-heavy username	number	Sampled followers whose username is mostly digits.
signal_breakdown.no display name	number	Sampled followers with no display name.
summary	string	One-paragraph AI verdict on the audience for sponsorship decisions.