Drop TV API

Appearance

SECTION 1 — HOME ​

1. GET /home ​

Returns home screen section configuration: an ordered list of sections with type, position, title, and path. For hero, includes autoplay and autoplay_interval_seconds. For category_row, includes category_id.

Request ​

http
GET /home

Response 200 OK ​

json
{
  "status": "success",
  "data": [
    {
      "type": "hero",
      "position": 1,
      "title": null,
      "autoplay": true,
      "autoplay_interval_seconds": 6,
      "path": "/home/hero"
    },
    {
      "type": "live_now",
      "position": 2,
      "title": "Live Now",
      "path": "/home/live"
    },
    {
      "type": "most_viewed",
      "position": 3,
      "title": "Most Viewed",
      "path": "/shows/episodes/most-viewed?category=all&limit=10&page=1"
    },
    {
      "type": "creators_row",
      "position": 4,
      "title": "MycDrop Creators",
      "path": "/creators/featured?limit=10"
    },
    {
      "type": "category_row",
      "position": 5,
      "title": "High Science",
      "category_id": "education",
      "path": "/shows?category=education&sort=most_popular&section=all&page=1&limit=20"
    },
    {
      "type": "category_row",
      "position": 6,
      "title": "D'Lar",
      "category_id": "dlar",
      "path": "/shows?category=dlar&sort=most_popular&section=all&page=1&limit=20"
    },
    {
      "type": "category_row",
      "position": 7,
      "title": "Lifestyle",
      "category_id": "lifestyle",
      "path": "/shows?category=lifestyle&sort=most_popular&section=all&page=1&limit=20"
    },
    {
      "type": "category_row",
      "position": 8,
      "title": "FilmDrop",
      "category_id": "film_tv",
      "path": "/shows?category=film_tv&sort=most_popular&section=all&page=1&limit=20"
    },
    {
      "type": "category_row",
      "position": 9,
      "title": "DropDrop",
      "category_id": "comedy",
      "path": "/shows?category=comedy&sort=most_popular&section=all&page=1&limit=20"
    },
    {
      "type": "category_row",
      "position": 10,
      "title": "PitchDrop",
      "category_id": "sports",
      "path": "/shows?category=sports&sort=most_popular&section=all&page=1&limit=20"
    }
  ]
}

2. GET /home/hero ​

Returns hero carousel content for the home screen.

Request ​

http
GET /home/hero

Response 200 OK ​

json
{
  "status": "success",
  "data": [
    {
      "show_id": "show_001",
      "title": "I Wish I Could See Heaven",
      "thumb_url": null,
      "stream_url": "https://cdn.droptv.com/episodes/ep_001/stream.m3u8",
      "category": "comedy",
      "seasons": 3,
      "rating": "TV-14",
      "is_free": true,
      "description": "Exploring the intersection of cannabis culture and cutting-edge science",
      "duration_formatted": "24:32"
    },
    {
      "show_id": "show_001",
      "title": "High Science",
      "thumb_url": null,
      "stream_url": "https://cdn.droptv.com/episodes/ep_001/stream.m3u8",
      "category": "comedy",
      "seasons": 3,
      "rating": "TV-14",
      "is_free": true,
      "description": "Exploring the intersection of cannabis culture and cutting-edge science",
      "duration_formatted": "24:32"
    },
    {
      "show_id": "show_001",
      "title": "Go Big or Go Home",
      "thumb_url": null,
      "stream_url": "https://cdn.droptv.com/episodes/ep_001/stream.m3u8",
      "category": "comedy",
      "seasons": 3,
      "rating": "TV-14",
      "is_free": true,
      "description": "Exploring the intersection of cannabis culture and cutting-edge science",
      "duration_formatted": "24:32"
    }
  ]
}

3. GET /home/live ​

Returns currently live streams for the home screen "Live Now" section.

Request ​

http
GET /home/live

Response 200 OK ​

json
{
  "status": "success",
  "data": [
    {
      "stream_id": "stream_abc123",
      "title": "Behind the Laughs",
      "started_at": "2024-11-01T18:15:00Z",
      "thumbnail_url": "https://cdn.droptv.com/streams/stream_abc123/thumb.jpg",
      "stream_url": "https://cdn.droptv.com/streams/stream_abc123/stream.m3u8",
      "dvr_url": "https://cdn.droptv.com/streams/stream_abc123/dvr.m3u8"
    },
    {
      "stream_id": "stream_abc123",
      "title": "Behind the Laughs",
      "started_at": "2024-11-01T18:15:00Z",
      "thumbnail_url": "https://cdn.droptv.com/streams/stream_abc123/thumb.jpg",
      "stream_url": "https://cdn.droptv.com/streams/stream_abc123/stream.m3u8",
      "dvr_url": "https://cdn.droptv.com/streams/stream_abc123/dvr.m3u8"
    }
  ]
}