Developer API · v1

DecodeCreator API

Analyze any public Instagram, TikTok, or YouTube account with one endpoint. REST + JSON, x-api-key auth, credit-based pricing. All 11 tools available programmatically.

Get your API key →Quickstart Endpoints Errors

Quickstart

Every request needs your API key in the x-api-key header. Base URL: https://decodecreator.com

Get engagement rate for @mkbhd on Instagrambash

curl -H "x-api-key: dc_live_YOUR_KEY_HERE" \
  "https://decodecreator.com/v1/scan/instagram/mkbhd?tool=engagement-rate"

Node.js (fetch)js

const res = await fetch(
  "https://decodecreator.com/v1/scan/instagram/mkbhd?tool=engagement-rate",
  { headers: { "x-api-key": process.env.DC_KEY } }
);
const json = await res.json();
console.log(json.data.free.engagementRatePct);

Python (requests)python

import os, requests
r = requests.get(
  "https://decodecreator.com/v1/scan/instagram/mkbhd?tool=engagement-rate",
  headers={"x-api-key": os.environ["DC_KEY"]},
)
print(r.json()["data"]["free"]["engagementRatePct"])

Response envelope: every successful call returns { ok: true, tool, platform, handle, credits: {charged, remaining}, data }. On error, { ok: false, error, code }.

Endpoints

GET/v1/scan/{platform}/{handle}?tool={toolId}

Run any analytics tool on any account. Serves every tool in the registry — see the table below.

GET/v1/scan/{platform}/{handle}?tool=full-report

Bundled call — runs every eligible tool and returns keyed results. Primitives share our cache so provider cost is closer to 4-5 API calls than the sum of all tools.

POST/v1/watchlist

Add an account to your monitoring watchlist. Body: {platform, handle, label?}

GET/v1/watchlist

List watched accounts with their latest snapshot + follower delta. Costs 2 credits.

DELETE/v1/watchlist/{id}

Untrack a watched account. Free.

GET/v1/download?url={media_url}[&filename=X&stream=1]

Proxy a thumbnail or video URL through our infra (bypasses CDN hotlink blocks). Costs 5 credits.

GET/embed/{toolId}/{platform}/{handle}?theme=light|dark

Iframe-safe rendering of any tool. Free (no API key needed). Suitable for embedding in your customer dashboards.

Tools + credit costs

Tool ID	What it returns	Platforms	Credits
gender-split	Audience Gender Split	instagramtiktokyoutube	25
banned-hashtag	Banned Hashtag Checker	instagramtiktokyoutube	1
comment-picker	Comment Picker	instagramtiktokyoutube	12
earnings-estimator	Earnings Estimator	instagramtiktokyoutube	10
engagement-rate	Engagement Rate	instagramtiktokyoutube	10
unfollower-tracker	Follower Churn Tracker	instagramtiktokyoutube	5
live-counter	Follower Growth	instagramtiktokyoutube	5
fake-follower	Real Follower Check	instagramtiktokyoutube	10
recent-posts	Recent Posts	instagramtiktokyoutube	15
shadowban-checker	Shadowban Checker	instagramtiktokyoutube	12
thumbnail-downloader	Thumbnail Downloader	instagramtiktokyoutube	8
username-checker	Username Checker	instagramtiktokyoutube	3
full-report	All tools bundled (cache-shared primitives)	instagramtiktokyoutube	80

Failed scans do NOT charge credits — you only pay for successful responses. Cache hits are charged the same (data is still yours; cache saves us provider cost).

Plans

Starter

$29/mo

3,000 credits/mo

Overage: $0.005/credit

Pro

$99/mo

15,000 credits/mo

Overage: $0.005/credit

Scale

$299/mo

60,000 credits/mo

Overage: $0.005/credit

Enterprise

Custom

Custom volume

Overage: $0.003/credit

Error codes

Code	HTTP	What it means
no_api_key	401	x-api-key header missing
invalid_api_key	401	Key not recognised
revoked_api_key	401	Key was revoked in the dashboard
credits_exhausted	402	Monthly credit allowance exceeded
bad_platform	400	Platform must be instagram / tiktok / youtube
missing_tool	400	?tool= query param is required for /v1/scan
not_available	404	That tool isn't supported for that platform
not_found	404	Handle doesn't exist / provider returned different account
private_account	422	Account is private — public data only
provider_rate_limit	503	Upstream provider is throttling us; retry in a minute
data_source	502	Upstream provider returned an error
host_not_allowed	400	/v1/download URL is from an un-allowlisted CDN

Support

Bugs, feature requests, or enterprise questions — email hello@decodecreator.com. SLA on Pro and above.