CreatorFanBase API

API documentation

Two endpoints, one key, plain JSON. Search verified creators and open full profiles from your own software. New here? Start with the API overview and credit packs.

Authentication

Every request needs a private API key in the Authorization header. Create up to 5 keys on your API keys page — one per tool or teammate, so you never share your password. Keep keys server-side; never ship them in a browser or mobile app.

Header format

Authorization: Bearer cfb_live_...

Search creators

GET https://creatorfanbase.com/api/public/v1/search

Returns creators matching your filters, newest data first. A search costs 1 base credit plus 1 credit per filter used, and only when at least one creator matches — empty results are free.

Query parameters

Parameter	Type	What it does
q	string	Keyword matched against creator names and handles. Max 100 characters.
country	string	Country name, e.g. India or USA. One country per request.
category	string	Niche such as fitness, beauty, gaming or finance.
language	string	Content language, e.g. Hindi, Arabic, Spanish.
platform	string	One of youtube, instagram, tiktok, facebook, x.
min_followers	integer	Only creators with at least this many followers.
max_followers	integer	Only creators with at most this many followers.
limit	integer	Results per call, 1–100. Defaults to 50.

Rate limit: 60 searches per minute per key.

Example

Request

curl "https://creatorfanbase.com/api/public/v1/search?country=India&category=fitness&min_followers=100000&limit=10" \
  -H "Authorization: Bearer cfb_live_..."

Response

{
  "total": 87,
  "returned": 10,
  "credits_used": 4,
  "credits_remaining": 496,
  "creators": [
    {
      "slug": "example-creator",
      "name": "Example Creator",
      "url": "https://creatorfanbase.com/c/example-creator",
      "country": "India",
      "total_reach": 1250000,
      "platforms": [
        { "platform": "instagram", "handle": "@example", "url": "https://instagram.com/example", "followers": 1250000 }
      ]
    }
  ]
}

Creator profile

GET https://creatorfanbase.com/api/public/v1/creators/{slug}

Returns one creator's full record for 1 credit. The slug is the last part of their CreatorFanBase profile URL, or the slug field from a search result.

Response fields

Field	What it contains
slug	Unique creator identifier used in URLs and API calls.
name	Display name.
url	Full CreatorFanBase profile URL.
tagline	Short creator summary.
country	Creator's country.
languages	Array of content languages.
verified	True when the profile is verified by CreatorFanBase.
website	Official website, when known.
categories	Array of niche slugs.
total_reach	Sum of the latest follower counts across platforms.
platforms	Per-platform handle, profile URL, latest follower count and when it was updated.

Request

curl "https://creatorfanbase.com/api/public/v1/creators/example-creator" \
  -H "Authorization: Bearer cfb_live_..."

Errors

Errors return a JSON body with an error message. Failed requests never consume credits.

Status	Meaning	What to do
400	Invalid parameters	Check the details field — it names the parameter that failed validation.
401	Missing or invalid API key	Send Authorization: Bearer cfb_live_... with an active key from your API keys page.
402	Not enough credits	The body includes credits_needed and credits_remaining. Buy a pack at creatorfanbase.com/api.
404	Creator not found	The slug does not match a published creator. Check spelling or search first.
429	Rate limit reached	Each key allows 60 searches per minute. Wait a few seconds and retry.
503	Temporary failure	Something on our side hiccuped. Retry after a short pause; no credits were charged.

Credits

Credits come in packs — buy them on the API page.
Credits expire 30 days after purchase; the oldest credits are used first.
Every response shows credits_used and credits_remaining.
At 5 credits or fewer, responses add a warning field and an x-credits-warning header so your tool can alert you before you run out.

Common questions

What does a search cost?: 1 base credit plus 1 credit for every filter you use — keyword, country, category, language, platform, minimum and maximum followers. A plain search costs 1 credit; a search with three filters costs 4.
What does a creator profile cost?: 1 credit per profile. You get every platform handle, the latest follower counts and the total reach.
Are failed requests charged?: No. Searches that return no creators cost 0 credits, and 4xx/5xx responses never consume credits.
How do I know when credits run low?: Every response includes credits_remaining. Once you drop to 5 credits or fewer, responses also include a warning field and an x-credits-warning header.
Do credits expire?: Yes, 30 days after purchase. The oldest credits are always used first.