API

A small public, read-only, unauthenticated JSON API for finding micro-dramas and where to watch them. Base URL: https://thedramadb.com

Rate limit: 30 requests/minute per IP on every endpoint below. Each response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (Unix seconds) headers; going over returns 429 with a Retry-After header.

GET/api/v1/search

Search dramas by title. Returns a list, ready to feed into /api/v1/dramas/{id} for full detail on one result.

Param	Description
`q` required	Title text to search for (case-insensitive substring match), or a full `tddb-` id for an exact lookup (see below).

Up to 20 results, no pagination -- narrow your query if you don't see what you're looking for. Each result: id, title, posterUrl, description.

curl "https://thedramadb.com/api/v1/search?q=billionaire"

[
  {
    "id": "tddb-e1lhjmf2",
    "title": "50 & Broke, Then Flash-Married a Billionaire",
    "posterUrl": "https://thedramadb.com/api/poster?url=...",
    "description": "Catherine, a 50-year-old single mother..."
  },
  ...
]

A query starting with tddb- (case-insensitive) is treated as an exact public id, not a text search, and returns at most one result.

GET/api/v1/dramas/{id}

Full detail for one drama by its public id (the id field from a search result, or shown on the drama's own page).

curl "https://thedramadb.com/api/v1/dramas/tddb-e1lhjmf2"

{
  "id": "tddb-e1lhjmf2",
  "title": "50 & Broke, Then Flash-Married a Billionaire",
  "alternativeTitles": [],
  "genres": ["Romance", "Billionaire"],
  "episodeCount": 40,
  "releaseYear": null,
  "languages": ["ENGLISH"],
  "upvotes": 42,
  "downvotes": 3,
  "description": "Catherine, a 50-year-old single mother...",
  "posterUrl": "https://thedramadb.com/api/poster?url=...",
  "availableOn": [
    {
      "platform": "DramaBox",
      "url": "https://www.dramaboxdb.com/movie/...",
      "language": "ENGLISH",
      "dubbed": false,
      "externalId": "42000025102",
      "lastCheckedAt": "2026-09-14T02:42:50.592Z"
    }
  ]
}

Returns 404 (with the same rate-limit headers) if the id doesn't exist.

Something missing you'd find useful? Reach out at support@thedramadb.com.