tvschedule.org
API Docs / Patterns

Most repeated last week

Live and CompleteMCP: repeats

The shows and films a country repeated most last week, ranked, with the change on the week before.

ReturnsA ranked chart
Up to50 a call, 20 by default
FreshUp to an hour old
PlanLive and Complete
GEThttps://api.tvschedule.org/v1/countries/{cc}/repeats

What it is for

The same weekly count as Most aired, but only repeats: the programmes channels returned to again and again. Each row has its rank, kind, genre, count and change.

Use it to see which programmes carry a country's schedules, or to find the evergreen shows behind its channels.

Evergreen shows

Find what channels rely on week after week.

Programming research

Compare repeat-heavy countries and genres.

Weekly features

Publish "the most repeated shows this week".

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.

Most repeated last week

Needs Live or Complete

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

https://api.tvschedule.org/v1/countries/GB/repeats
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/countries/GB/repeats" \
  -H "X-API-Key: <your key>"

Parameters

NameInTypeExampleWhat it does
ccrequiredpathstringGBThe country as a two-letter code, such as GB.
limitqueryinteger10How many rows of the chart, 20 when left out.
1 to 50

Returns

A list under data, with meta.count beside it.

FieldTypeExampleWhat it holds
rankinteger1Its place in the chart, 1 first.
idstringsh_q1w2e3r4Its id, stable and used by every other endpoint
kindstringshowshow or film.
namestringFriendsIts name
genrestringComedyIts main genre
airingsinteger336How many repeats aired that week.
changeinteger0Places up (positive) or down (negative) on the week before.

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

StatusCodeWhenWhat to do
401unauthorizedNo 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.
403upgrade_requiredThe weekly charts are on Live and Complete.The message names the plan that does. Upgrade on the same key at /pricing.
400bad_requestA 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.
422unknown_parameterA query parameter this endpoint does not take.The message lists the ones it does take.
429rate_limitedFaster than your plan's pace per minute.Wait for Retry-After seconds. The X-RateLimit headers show where you are.
429quota_exceededYour plan's allowance for the day or month is used.It resets at the time in the message, or upgrade for a bigger allowance.
500server_errorSomething 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