TV show / season search (iTunes) API

Search TV shows and seasons via the keyless Apple iTunes Search API, normalized to show, season title, year, genre, episode count, content rating, artwork, store URL, and ids. Emulates IMDb TV lookups without an API key. Answers 'find seasons of Breaking Bad','how many episodes in a season','what year did a TV show air','TV show genre'.

Price$0.01per request

MethodPOST

Route/v1/data/media-tv-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

mediatvtelevisionseriesseasonitunesimdbentertainment

API URLhttps://x402.hexl.dev/v1/data/media-tv-search

Integration docs

Example request

{
  "query": "Breaking Bad",
  "limit": 5
}

Example response

{
  "query": "Breaking Bad",
  "count": 1,
  "results": [
    {
      "kind": "collection",
      "show": "Breaking Bad",
      "title": "Breaking Bad, Season 1",
      "episode": null,
      "year": 2008,
      "releaseDate": "2008-01-20T08:00:00Z",
      "genre": "Drama",
      "episodeCount": 7,
      "rating": "tv-ma",
      "artworkUrl": "https://is1-ssl.mzstatic.com/.../600x600bb.jpg",
      "url": "https://itunes.apple.com/us/tv-season/.../id123",
      "collectionId": 123,
      "trackId": null
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "Breaking Bad",
        "The Office"
      ]
    },
    "limit": {
      "type": "number",
      "default": 15,
      "examples": [
        10
      ]
    },
    "country": {
      "type": "string",
      "examples": [
        "US"
      ]
    }
  }
}

Output schema

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