API Documentation

Creator Tracking API v1 — Social media analytics for your applications

Authentication

All API requests require an API key. Pass it via one of these methods:

# Option 1: Authorization header
curl -X POST https://creatortracking.com/v1/post/stats \
  -H "Authorization: Bearer ct_live_YOUR_KEY" \
  -H "Content-Type: application/json"

# Option 2: X-API-Key header
curl -X POST https://creatortracking.com/v1/post/stats \
  -H "X-API-Key: ct_live_YOUR_KEY" \
  -H "Content-Type: application/json"

Base URL

https://creatortracking.com/v1

Response Format

All responses follow this structure:

{
  "ok": true,
  "data": { ... },
  "meta": {
    "cached": false,
    "platform": "tiktok"
  }
}

Error responses:

{
  "ok": false,
  "error": "Description of what went wrong"
}

Rate Limiting

Default: 60 requests/minute per API key. Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57

POST /v1/post/stats

Get view, like, comment, and share counts for a single social media post.

Supported Platforms

TikTok, Instagram, YouTube, Twitter/X, Facebook, LinkedIn

Request Body

{
  "url": "https://www.tiktok.com/@user/video/7123456789",
  "platform": "tiktok"  // optional — auto-detected from URL
}

Response

{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "post_url": "https://www.tiktok.com/@user/video/7123456789",
    "post_id": "7123456789",
    "views": 1250000,
    "likes": 85000,
    "comments": 3200,
    "shares": 12000,
    "provider": "tiktok-api23",
    "fetched_at": "2026-03-28T12:00:00.000Z"
  },
  "meta": { "cached": false, "platform": "tiktok" }
}

Examples

# TikTok
curl -X POST https://creatortracking.com/v1/post/stats \
  -H "Authorization: Bearer ct_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.tiktok.com/@charlidamelio/video/7123456789"}'

# Instagram Reel
curl -X POST https://creatortracking.com/v1/post/stats \
  -H "Authorization: Bearer ct_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.instagram.com/reel/ABC123/"}'

# YouTube Video
curl -X POST https://creatortracking.com/v1/post/stats \
  -H "Authorization: Bearer ct_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

# Twitter/X Post
curl -X POST https://creatortracking.com/v1/post/stats \
  -H "Authorization: Bearer ct_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://x.com/elonmusk/status/1234567890"}'

POST /v1/profile

Get profile info (followers, bio, verification status, etc.) for a creator.

Supported Platforms

TikTok, Instagram, YouTube

Request Body

{
  "url": "https://www.tiktok.com/@charlidamelio",
  // OR
  "username": "charlidamelio",
  "platform": "tiktok"
}

Response

{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "username": "charlidamelio",
    "full_name": "Charli D'Amelio",
    "bio": "don't you dare",
    "profile_pic_url": "https://...",
    "followers": 155000000,
    "following": 1200,
    "posts_count": 2300,
    "is_verified": true,
    "external_url": null,
    "provider": "tiktok-api23",
    "fetched_at": "2026-03-28T12:00:00.000Z"
  }
}

POST /v1/channel/videos

Get recent videos/posts from a creator's channel.

Supported Platforms

TikTok, Instagram, YouTube

Request Body

{
  "url": "https://www.tiktok.com/@charlidamelio",
  // OR
  "username": "charlidamelio",
  "platform": "tiktok"
}

Response

{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "username": "charlidamelio",
    "videos": [
      {
        "id": "7123456789",
        "url": "https://www.tiktok.com/@charlidamelio/video/7123456789",
        "description": "new dance video",
        "views": 5200000,
        "likes": 420000,
        "comments": 8500,
        "shares": 15000,
        "created_at": "2026-03-20T14:30:00.000Z"
      }
    ],
    "count": 20,
    "fetched_at": "2026-03-28T12:00:00.000Z"
  }
}

POST /v1/median-views

Calculate the median view count from a creator's recent posts. Useful for estimating typical performance.

Supported Platforms

TikTok, Instagram, YouTube

Request Body

{
  "username": "charlidamelio",
  "platform": "tiktok"
}

Response

{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "username": "charlidamelio",
    "median_views": 3500000,
    "videos_analyzed": 18,
    "raw_view_counts": [120000, 450000, ...],
    "fetched_at": "2026-03-28T12:00:00.000Z"
  }
}

POST /v1/email

Extract email addresses from a creator's bio/profile.

Supported Platforms

TikTok, Instagram, YouTube

Request Body

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

Response

{
  "ok": true,
  "data": {
    "platform": "instagram",
    "username": "creator_username",
    "email": "contact@creator.com",
    "found": true,
    "source": "bio",
    "fetched_at": "2026-03-28T12:00:00.000Z"
  }
}

GET /v1/platforms

Returns a list of supported platforms and which endpoints work for each.

curl https://creatortracking.com/v1/platforms \
  -H "Authorization: Bearer ct_live_YOUR_KEY"

GET /v1/ping

Health check endpoint. Returns pong if the API is running.

curl https://creatortracking.com/v1/ping \
  -H "Authorization: Bearer ct_live_YOUR_KEY"

Error Codes

Code Meaning
400Bad request — missing or invalid parameters
401Unauthorized — missing or invalid API key
402Insufficient balance — add funds at /billing
429Rate limit exceeded — wait and retry
500Internal server error
502Upstream provider error — all data sources failed

Notes

  • Responses are cached for 5-15 minutes depending on endpoint.
  • LinkedIn "views" may return reaction count if impression data is unavailable.
  • YouTube providers may not return comment counts.
  • The provider field in responses tells you which upstream source was used.
  • Pass "platform" explicitly if URL auto-detection doesn't work for your use case.