GET items

bbc.com

Summary: Look inside programmes to find segments: chapters, tracks and more
Operation ID: listItems
Auth: unknown
Description

Look inside programmes to find segments: chapters, tracks and more

Parameters (16)

authority (string, query, optional)

filter for subset of items that have an ID issued by the given authority

id (array, query, optional)

filter for subset of items having given ID

id_type (string, query, optional)

filter for subset of items that have given an ID of the given type

item_type (array, query, optional)

filter for specific type(s) of items

mixin (array, query, optional)

Mixins: * contributions: mixin to return information about contributors to items * images: mixin to add image information for an item * offset: mixin to return programme segment offsets, works in conjunction with programme filter * play_event: mixin to return programme segment events, works in conjunction with programme or segment_event filters

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}

partner_id (array, query, optional)

filter for items by partner ID

partner_pid (array, query, optional)

filter for items by partner PID

people (string, query, optional)

filter for subset of items that have specified person involved

pid (array, query, optional)

filter for subset of items matching one of the given PIDs

programme (string, query, optional)

filter for subset of items that are part of the given programme

Constraints: {'minLength': 8, 'pattern': '^([0-9,a-d,f-h,j-n,p-t,v-z]){8,}$'}

q (string, query, optional)

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

segment_event (string, query, optional)

filter for item with the given segment_event

sort (string, query, optional)

Sorts: * pid: sort by pid, descending

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

sort_direction (string, query, optional)

Sort direction

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

No probe data for this endpoint yet.