A show's statistics

Live and CompleteFree key: empty with a noteMCP: show_stats

How often a show has aired: totals, first runs and repeats, by channel, country and year, and its first and last airing.

ReturnsThe show's counts

Up toOne record

FreshUp to an hour old

PlanLive and Complete

GEThttps://api.tvschedule.org/v1/shows/{id}/stats

What it is for

This counts a show's airings across our history: how many there were, how many were first runs and how many repeats, which channels and countries carried it, how the count changed year by year, and the first and last day it aired.

Use it for research, for rights and licensing questions, or to rank shows by how much air time they get.

Research

Compare how much air time shows get over the years.

Rights questions

See which channels and countries carried a show.

Show pages

Add "aired 4,120 times since 2023" to a page.

/v1/shows/{id}/statsthen/v1/shows/{id}/pattern /v1/shows/{id}/airings /v1/countries/{cc}/most-aired

Try it

Calls the real API with your key and shows the answer below. Your key stays in this browser and fills in on every docs page.

A show's statistics

Needs Live or Complete

Your key

No key yet? Get a free key. It fills in here by itself once made.

idrequired

https://api.tvschedule.org/v1/shows/sh_sdkgxsfs/stats

Uses 1 call from your plan.

Calling

Code

Built from the form above, with your key in place. The language you pick is remembered.

curl "https://api.tvschedule.org/v1/shows/sh_sdkgxsfs/stats" \
  -H "X-API-Key: <your key>"

Parameters

Name	In	Type	Example	What it does
`id`required	path	string	sh_sdkgxsfs	The show id, from show search.

Returns

One record under data, with meta beside it.

Field	Type	Example	What it holds
`airings`	integer	4120	How many times it aired
`first_runs`	integer	2210	Airings that were first runs
`repeats`	integer	1910	Airings that were repeats
`channels`	integer	6	How many channels
`first_seen`	string	2023-01-02	The first day it aired in our data.
`last_seen`	string	2026-10-28	The latest day it aired in our data.

Example answer

The example answer appears here as soon as this endpoint's data is live. Run above shows a real answer with your key.

Errors

Status	Code	When	What to do
401	`unauthorized`	No key was sent, or it is not an active TV Schedule key.	Send it as Authorization: Bearer <key> or X-API-Key. Your keys are in your account.
403	`upgrade_required`	Your plan does not read this: a day outside its window, or an endpoint on Live and Complete.	The message names the plan that does. Upgrade on the same key at /pricing.
404	`not_found`	No show has that id.	Take ids from the search and directory endpoints. Every address is listed in these docs.
400	`bad_request`	A value is the wrong shape: a date that is not YYYY-MM-DD, a two-character search, a key sent in the address.	Fix the value the message names and send it again.
429	`rate_limited`	Faster than your plan's pace per minute.	Wait for Retry-After seconds. The X-RateLimit headers show where you are.
429	`quota_exceeded`	Your plan's allowance for the day or month is used.	It resets at the time in the message, or upgrade for a bigger allowance.
500	`server_error`	Something went wrong on our side, or the data was out of reach for a moment.	Try again in a minute. It has been logged, and /status shows the state of the service.

Next calls

PreviousA show's airing pattern NextA channel's statistics