TV broadcast schedule (TVmaze) API

Full TV broadcast schedule for a country and date: which episodes air, on which network, at what time, sorted by airtime (TVmaze). Answers 'what is on TV in the US today', 'what airs on 2024-05-01 in GB', 'tonight's TV schedule'.

Price$0.01per request

MethodPOST

Route/v1/data/screen-schedule

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

datatvscheduletvmazebroadcastairingstelevisionscreen

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

Integration docs

Example request

{
  "country": "US",
  "date": "2024-05-01",
  "limit": 1
}

Example response

{
  "country": "US",
  "date": "2024-05-01",
  "count": 1,
  "schedule": [
    {
      "show": "Jeopardy!",
      "showId": 5,
      "episode": "Tournament of Champions",
      "season": 40,
      "number": 162,
      "airtime": "19:00",
      "airstamp": "2024-05-01T23:00:00+00:00",
      "runtime": 30,
      "network": "ABC",
      "genres": [
        "Game Show"
      ],
      "showUrl": "https://www.tvmaze.com/shows/5/jeopardy"
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "US",
      "examples": [
        "US",
        "GB"
      ]
    },
    "date": {
      "type": "string",
      "examples": [
        "2024-05-01"
      ]
    },
    "limit": {
      "type": "number",
      "default": 50
    }
  }
}

Output schema

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