GET /broadcasts

bbc.com

Summary: Build schedules and find metadata for TV and radio broadcasts
Operation ID: listBroadcasts
Auth: unknown
Description

Fetch metadata about linear Broadcasts and Services, allowing the generation of Television and Radio schedules and other datasets for broadcast items. Use /schedules instead of this feed as it is more efficient. Broadcasts will be deprecated in the future.

Parameters (24)

authority (array, query, optional)

filter for subset of broadcasts that have given authority

descendants_of (array, query, optional)

filter for subset of broadcasts that are descendants of the given programme PID

end_from (string, query, optional)

filter for subset of broadcasts that end on or later than the specified datetime

end_to (string, query, optional)

filter for subset of broadcasts that end on or earlier than the specified datetime

format (array, query, optional)

filter for subset of broadcasts that are classified in the given format ID

genre (array, query, optional)

filter for subset of broadcasts that are classified in the given genre ID

id (array, query, optional)

filter for subset of broadcasts that have given identifier

item (array, query, optional)

filter for subset of broadcasts with the given item performed on it

mixin (array, query, optional)

Mixins: * titles: return ancestor programme titles

page (integer, query, optional, default: 1)

which page of results to return

Constraints: {'minimum': 1}

page_size (integer, query, optional, default: 10)

number of results in each page

Constraints: {'maximum': 300}

people (string, query, optional)

filter for subset of broadcasts that have given contributor

pid (array, query, optional)

filter for subset of broadcasts having given PID

q (string, query, optional)

filter for subset of broadcasts matching supplied keyword/phrase (boolean operators permitted)

schedule_day (string, query, optional)

filter for subset of broadcasts that start on the specified day (BBC time)

schedule_day_from (string, query, optional)

filter for subset of broadcasts that start on or after the specified day (BBC time)

schedule_day_to (string, query, optional)

filter for subset of broadcasts that start on or before the specified day (BBC time)

service_master_brand (array, query, optional)

filter for subset of broadcasts with given service master brand

sid (array, query, optional)

filter for subset of broadcasts that are on the specified linear service

sort (string, query, optional)

Sorts: * start_date: sort chronologically by scheduled start time/date, ascending

Constraints: {'enum': ['start_date']}

sort_direction (string, query, optional)

Sort direction

Constraints: {'enum': ['ascending', 'descending']}

start_from (string, query, optional)

filter for subset of broadcasts that start on or later than the specified datetime

start_to (string, query, optional)

filter for subset of broadcasts that start on or earlier than the specified datetime

version (array, query, optional)

filter for subset of broadcasts with given PID as their parent version

No probe data for this endpoint yet.