Drop TV API

Appearance

SECTION 2 — CREATORS ​

4. GET /creators ​

Get all creators with filtering and sorting.

Query Parameters ​

ParameterTypeRequiredDefaultDescription
categorystringNoallcomedy, music, lifestyle, sports, film_tv, art_design, gaming, education
tierstringNoallambassador, platinum, gold, silver
sortstringNomost_popularmost_popular, newest, trending
pageintNo1Page number
limitintNo20Results per page

Request ​

http
GET /creators?category=all&tier=all&sort=most_popular&page=1&limit=20

Response 200 OK ​

json
{
  "status": "success",
  "meta_data": {
    "total": 19,
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "filters_applied": {
      "category": "all",
      "tier": "all",
      "sort": "most_popular"
    }
  },
  "data": {
    "creators": [
      {
        "id": "creator_001",
        "name": "Chris Spencer",
        "initials": "CS",
        "avatar_color": "#4A90D9",
        "avatar_url": null,
        "tier": "ambassador",
        "category": "comedy",
        "subscribers": 15000,
        "subscribers_formatted": "15K",
        "is_live": true,
        "is_verified": true,
        "is_hot": false,
        "watching_now": 13000,
        "watching_now_formatted": "13K",
        "channel_url": "/creators/chris-spencer"
      }
    ]
  }
}

Errors ​

json
{
  "status": "error",
  "code": 400,
  "message": "Invalid category value. Allowed: comedy, music, lifestyle, sports, film_tv, art_design, gaming, education"
}

5. GET /creators/live ​

Get all currently live streaming creators.

Query Parameters ​

ParameterTypeRequiredDefaultDescription
limitintNo10Results per page
pageintNo1Page number

Request ​

http
GET /creators/live?limit=10&page=1

Response 200 OK ​

json
{
  "status": "success",
  "meta_data": {
    "total_live": 3,
    "page": 1,
    "limit": 10,
    "total_pages": 1
  },
  "data": {
    "creators": [
      {
        "id": "creator_001",
        "name": "Chris Spencer",
        "initials": "CS",
        "avatar_color": "#4A90D9",
        "avatar_url": null,
        "tier": "ambassador",
        "is_live": true,
        "is_verified": true,
        "watching_now": 13000,
        "watching_now_formatted": "13K",
        "stream": {
          "stream_id": "stream_abc123",
          "title": "Late Night Comedy Show",
          "started_at": "2024-11-01T20:00:00Z",
          "thumbnail_url": "https://cdn.droptv.com/streams/stream_abc123/thumb.jpg"
        },
        "channel_url": "/creators/chris-spencer"
      }
    ]
  }
}

6. GET /creators/featured ​

Get featured top talent creators. Pagination is included for "View all" navigation; section headers can be static. Filters are available on the view-all list page.

Query Parameters ​

ParameterTypeRequiredDefaultDescription
limitintNo10Number of creators to return
pageintNo1Page number

Request ​

http
GET /creators/featured?limit=10&page=1

Response 200 OK ​

json
{
  "status": "success",
  "meta_data": {
    "total": 19,
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "filters_applied": {
      "category": "all",
      "tier": "all",
      "sort": "most_popular"
    }
  },
  "data": {
    "creators": [
      {
        "id": "creator_001",
        "name": "Chris Spencer",
        "initials": "CS",
        "avatar_color": "#4A90D9",
        "avatar_url": null,
        "tier": "ambassador",
        "category": "comedy",
        "subscribers": 15000,
        "subscribers_formatted": "15K",
        "is_live": true,
        "is_verified": true,
        "is_hot": false,
        "watching_now": 13000,
        "watching_now_formatted": "13K",
        "channel_url": "/creators/chris-spencer"
      }
    ]
  }
}

7. GET /creators/search ​

Search creators by name or keyword.

Query Parameters ​

ParameterTypeRequiredDefaultDescription
qstringYes—Search query
categorystringNoallFilter by category
tierstringNoallFilter by tier
pageintNo1Page number
limitintNo20Results per page

Request ​

http
GET /creators/search?q=chris&category=comedy&tier=ambassador&page=1&limit=20

Response 200 OK ​

json
{
  "status": "success",
  "meta_data": {
    "query": "chris",
    "total": 1,
    "page": 1,
    "limit": 20,
    "total_pages": 1
  },
  "data": {
    "creators": [
      {
        "id": "creator_001",
        "name": "Chris Spencer",
        "initials": "CS",
        "avatar_color": "#4A90D9",
        "avatar_url": null,
        "tier": "ambassador",
        "category": "comedy",
        "subscribers": 15000,
        "subscribers_formatted": "15K",
        "is_live": true,
        "is_verified": true,
        "channel_url": "/creators/chris-spencer"
      }
    ]
  }
}

Errors ​

json
{
  "status": "error",
  "code": 400,
  "message": "Search query 'q' is required"
}

8. GET /creators/tiers ​

Get all creator tier definitions.

Request ​

http
GET /creators/tiers

Response 200 OK ​

json
{
  "status": "success",
  "data": [
    { "id": "silver", "label": "Silver" },
    { "id": "gold", "label": "Gold" },
    { "id": "platinum", "label": "Platinum" },
    { "id": "ambassador", "label": "Ambassador" }
  ]
}

9. GET /categories ​

Get all creator content categories.

Request ​

http
GET /categories

Response 200 OK ​

json
{
  "status": "success",
  "data": [
    { "id": "comedy", "label": "Comedy", "icon": "comedy-icon", "creator_count": 42 },
    { "id": "music", "label": "Music", "icon": "music-icon", "creator_count": 38 },
    { "id": "lifestyle", "label": "Lifestyle", "icon": "lifestyle-icon", "creator_count": 55 },
    { "id": "sports", "label": "Sports", "icon": "sports-icon", "creator_count": 29 },
    { "id": "film_tv", "label": "Film & TV", "icon": "film-icon", "creator_count": 21 },
    { "id": "art_design", "label": "Art & Design", "icon": "art-icon", "creator_count": 18 },
    { "id": "gaming", "label": "Gaming", "icon": "gaming-icon", "creator_count": 33 },
    { "id": "education", "label": "Education", "icon": "education-icon", "creator_count": 14 }
  ]
}

10. GET /creators/:id ​

Get a single creator's detail as an array of content blocks (user info, top content, free episodes, subscribe banner, premium/offered content, and more from creator).

Path Parameters ​

ParameterTypeRequiredDescription
idstringYesCreator ID

Request ​

http
GET /creators/creator_001

Response 200 OK ​

json
{
  "status": "success",
  "data": [
    {
      "type": "user",
      "id": "creator_001",
      "name": "Chris Spencer",
      "initials": "CS",
      "avatar_color": "#4A90D9",
      "avatar_url": null,
      "is_verified": true,
      "is_live": true,
      "description": "Comedian, Actor, Producer. Host of 'Go Big or Go Home'. Bringing laughs from Atlanta to the world.",
      "tier": "ambassador",
      "category": "comedy",
      "audience_metrics": {
        "subscribers": 124000,
        "subscribers_formatted": "124K",
        "views": 245000,
        "views_formatted": "245K",
        "instagram_followers": 89000,
        "instagram_followers_formatted": "89K",
        "youtube_subscribers": 45000,
        "youtube_subscribers_formatted": "45K",
        "tiktok_followers": 45000,
        "tiktok_followers_formatted": "45K"
      },
      "watching_now": 13000,
      "watching_now_formatted": "13K",
      "user_state": {
        "is_following": false,
        "is_subscribed": false
      },
      "channel_url": "/creators/chris-spencer",
      "joined_at": "2022-03-15T00:00:00Z"
    },
    {
      "type": "top_content",
      "id": "cm7gk3a0b0002yz...",
      "title": "The Midnight Sessions",
      "image_url": "https://cdn.drop.tv/series/midnight-cover.jpg",
      "year": 2025,
      "seasons": 2,
      "tags": [],
      "description": "A raw look at underground music culture across five cities.",
      "starring": "Marcus James",
      "subtitles": ["English"]
    },
    {
      "type": "free_episodes",
      "title": "Free Episodes",
      "description": "Watch free episodes from The Midnight Sessions",
      "series_id": "cm7gk3a0b0002yz...",
      "seasons": [
        { "id": "cm7gk4...", "title": "Season 1" },
        { "id": "cm7gk5...", "title": "Season 2" }
      ]
    },
    {
      "type": "subscribe_banner",
      "plan": {
        "price": 9.99,
        "currency": "USD",
        "interval": "month"
      },
      "user_subscription": {
        "is_subscribed": false,
        "subscribed_at": null,
        "renewal_date": null,
        "status": null
      }
    },
    {
      "type": "premium_content",
      "premium_price": 9.99,
      "billing_term": "monthly",
      "currency": "USD"
    },
    {
      "type": "offered_content",
      "title": "Buy Individual Content",
      "description": "Purchase specific videos and episodes"
    },
    {
      "type": "other_content",
      "title": "More from this Creator",
      "items": [
        {
          "id": "cm7gk6...",
          "title": "City Lights",
          "thumbnail_url": null,
          "total_episodes": 0,
          "year": 2024
        }
      ]
    }
  ]
}

Errors ​

json
{
  "status": "error",
  "code": 404,
  "message": "Creator not found"
}