GET promotions

bbc.com

Summary: Discover metadata for content promotions
Operation ID: listPromotions
Auth: unknown
Description

Details of short-term editorially curated "promotions", for instance those programmes featured on iPlayer today

Parameters (11)

context (string, query, optional)

filter for subset of promotions belonging to a given context

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

mixin (array, query, optional)

Mixins: * related_links: mixin to return information about related links to a promotion

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 promotions by partner ID

partner_pid (array, query, optional)

filter for promotions by partner PID

pid (array, query, optional)

filter for subset of promotions having given PID

promoted_by (array, query, optional)

filter for subset of promotions having given promoted by

promoted_for (array, query, optional)

filter for subset of promotions having given promoted for

q (string, query, optional)

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

status (array, query, optional)

filter for subset of promotions with status

No probe data for this endpoint yet.