REST API v1

Public API Documentation

Integrate FollowerChecker into your apps, dashboards, and workflows. Authenticate with an API key and use credits from your account.

Quick Start

1

Get your API key

2

Make your first request

curl -X POST https://yoursite.com/api/v1/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: fc_your_key_here" \
  -d '{"platform": "instagram", "username": "example"}'

Authentication

All API requests require an API key passed in the X-API-Key header. Each check costs 1 credit from your account balance.

Rate Limit
60 req/min
Max Bulk
25 accounts
Platforms
IG, TT, YT, X

Endpoints

POST/api/v1/check

Run a single check on any account

Request Body

{
  "platform": "instagram",
  "username": "example"
}

Response

{
  "success": true,
  "creditsRemaining": 14,
  "reportUrl": "/report/abc123",
  "data": {
    "profile": { "username": "example", "followers": 150000, ... },
    "overallScore": 72,
    "followerBreakdown": { "realFollowers": { "percentage": 72 }, ... },
    "engagement": { "actualER": 2.3, "expectedER": 2.5 },
    "aiInsights": { "executiveSummary": "..." },
    ...
  }
}
POST/api/v1/bulk

Bulk check up to 25 accounts in one request

Request Body

{
  "checks": [
    { "platform": "instagram", "username": "user1" },
    { "platform": "tiktok", "username": "user2" },
    { "platform": "youtube", "username": "user3" }
  ]
}

Response

{
  "summary": {
    "total": 3, "successful": 3, "failed": 0,
    "creditsUsed": 3, "creditsRemaining": 12
  },
  "results": [
    { "username": "user1", "platform": "instagram", "status": "success",
      "overallScore": 78, "riskLevel": "low", "reportUrl": "/report/..." },
    ...
  ]
}
POST/api/v1/keys

Generate a new API key (auth required)

Request Body

{ "name": "My App" }

Response

{
  "id": "clxyz...",
  "key": "fc_a1b2c3d4...",
  "prefix": "fc_a1b2c3d4...",
  "message": "Save this key — it won't be shown again."
}

Error Codes

401Invalid or missing API key
402Insufficient credits
403Account is private (credit refunded)
429Rate limit exceeded (credit refunded)
500Server error