TV show episode search (TVmaze) API

List/search a TV show's episodes by TVmaze show id, optionally filtered by season or title text, with airdate, runtime, rating and stripped summary (TVmaze). Answers 'list episodes of show 169', 'season 2 episodes of Breaking Bad', 'find the Ozymandias episode'.

Price$0.01per request

MethodPOST

Route/v1/data/screen-episode-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

datatvepisodestvmazeseasontelevisionmediascreen

API URLhttps://x402.hexl.dev/v1/data/screen-episode-search

Integration docs

Example request

{
  "showId": 169,
  "season": 1,
  "limit": 2
}

Example response

{
  "showId": 169,
  "count": 2,
  "episodes": [
    {
      "id": 12852,
      "name": "Pilot",
      "season": 1,
      "number": 1,
      "type": "regular",
      "airdate": "2008-01-20",
      "airstamp": "2008-01-21T02:00:00+00:00",
      "runtime": 60,
      "rating": 8.2,
      "summary": "Walter White, a high school chemistry teacher...",
      "image": "https://static.tvmaze.com/uploads/images/original_untouched/0/2.jpg",
      "url": "https://www.tvmaze.com/episodes/12852/breaking-bad-1x01-pilot"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "showId"
  ],
  "properties": {
    "showId": {
      "type": "number",
      "examples": [
        169
      ]
    },
    "season": {
      "type": "number",
      "examples": [
        1
      ]
    },
    "query": {
      "type": "string",
      "examples": [
        "pilot"
      ]
    },
    "limit": {
      "type": "number",
      "default": 50
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}