atlas - media data router

Schedule

GET /schedule.json

Returns a schedule for the specified channel and period.

Parameter	Value	Type	Description
channel_id	Please Select cbbh (BBC One) cbbG (BBC Two) cbbP (BBC Three) cbbQ (BBC Four) cbbV (BBC HD) cbbW (CBBC) cbcQ (BBC Radio 1) cbcS (BBC Radio 2)	string	The id of the required channel. Available from /channels.json
from		multiple	The beginning of the schedule period. Can be an ISO date, number of seconds since 1 Jan 1970 or a relative duration, e.g. 'now'.
to		multiple	The end of the schedule period. Can be an ISO date, number of seconds since 1 Jan 1970 or a relative duration., e.g. 'now.plus.6h'.
publisher		string	The publisher of the schedule
annotations		list	List of annotations that describe the data to be output

Valid Annotations: description, extended_description, brand_summary, series_summary, people, topics, segment_events, related_links, key_phrases, broadcasts, locations, first_broadcast, next_broadcast, available_locations, plus channel.

Request

Channels and Channel groups

GET /channels.json

Returns a paginated list of all channels.

Parameter	Type	Description
broadcaster	string	Optionally filter by the broadcaster that owns the channel
media_type	string	Optionally filter by the type of channel (audio or video)
available_from	string	Optionally filter by a publisher that publishes data for the channel
order_by	string	Optionally order the list of channels
limit	integer	The number of channels to return per page
offset	integer	The offset from the start of the list.
annotations	list	List of annotations that describe the data to be output

Valid annotations: channel_groups, history, parent, variations

Request

GET /channels/:id.json

Returns the data for a particular channel.

Parameter	Value	Type	Description
id		string	The id of the channel
annotations		list	List of annotations that describe the data to be output

Valid annotations: channel_groups, history, parent, variations

Request

GET /channel_groups.json

Returns a paginated list of all channel groups.

Parameter	Value	Type	Description
type	Please Select (Not set) region platform	string	Optional filter for regions or television platforms
limit		integer	The number of channel groups to return per page
offset		integer	The offset from the start of the list.
annotations		list	List of annotations that describe the data to be output

Valid annotations: channels, history

Request

GET /channel_groups/:id.json

Returns the data for a particular channel group.

Parameter	Value	Type	Description
id		string	The id of the channel group
annotations		list	List of annotations that describe the data to be output

Valid annotations: channels

Request

Content

GET /content.json

Returns a list of content that matches the supplied uri. Used to look up content.

Parameter	Value	Type	Description
uri		string	The uri of a specific piece of content
annotations		list	List of annotations that describe the data to be output.

Valid annotations: description, extended_description, brand_summary, series_summary, people, topics, products, related_links, key_phrases, broadcasts, locations, first_broadcasts, next_broadcasts, available_locations, upcoming, sub_items

Request

Content Groups

GET /content_groups.json

Returns a paginated list of all content groups.

Parameter	Value	Type	Description
limit		integer	The number of content groups to return per page
offset		integer	The offset from the start of the list.

Valid annotations: none

Request

GET /content_groups/:id.json

Returns the data for a particular content group.

Parameter	Value	Type	Description
id		string	The id of the content group

Valid annotations: none

Request

GET /content_groups/:id/content.json

Returns a paginated list of the content for a content group.

Parameter	Type	Description
id	string	The id of the content group
limit	integer	The number of pieces of content to return per page
offset	integer	The offset from the start of the list
annotations	list	List of annotations that describe the data to be output

Valid annotations: all content annotations, plus filtering_resource

Request

Topics

GET /topics.json

Returns a paginated list of all topics.

Parameter	Type	Description
namespace	string	Optionally filter by the specified topic namespace
value	string	Optionally filter by the specified topic value.
limit	integer	The number of topics to return per page.
offset	integer	The offset from the start of the list.

Valid annotations: none

Request

GET /topics/:id.json

Returns the data for a particular topic.

Parameter	Value	Type	Description
id		string	The id of the topic

Valid annotations: none

Request

GET /topics/:id/content.json

Returns a paginated list of the content for a topic.

Parameter	Type	Description
id	string	The id of the topic
limit	integer	The number of pieces of content to return per page
offset	integer	The offset from the start of the list
annotations	list	List of annotations that describe the data to be output

Valid annotations: all content annotations, plus filtering_resource

Request

Products

All products data is currently restricted, please enter your API key above.

GET /products.json

Returns a paginated list of all products.

Parameter	Value	Type	Description
limit		integer	The number of products to return per page
offset		integer	The offset from the start of the list.

Valid annotations: none

Request

GET /products/:id.json

Returns a paginated list of the content related to a product.

Parameter	Value	Type	Description
id		string	The id of the product

Valid annotations: none

Request

GET /products/:id/content.json

Returns a paginated list of the content related to a product.

Parameter	Type	Description
id	string	The id of the product
limit	integer	The number of products to return per page
offset	integer	The offset from the start of the list.
annotations	list	List of annotations that describe the data to be output.

Valid annotations: all content annotations, plus filtering_resource

Request

Search

GET /search.json

Returns a list of content that matches the specified search criteria.

Parameter	Type	Description
q	string	The title of a container or item
limit	integer	The number of items to return (max 50).
publisher	string	The publisher of the content.

Valid annotations: none

Schedule

GET /schedule.json

Request

Response

Channels and Channel groups

GET /channels.json

Request

Response

GET /channels/:id.json

Request

Response

GET /channel_groups.json

Request

Response

GET /channel_groups/:id.json

Request

Response

Content

GET /content.json

Request

Response

Content Groups

GET /content_groups.json

Request

Response

GET /content_groups/:id.json

Request

Response

GET /content_groups/:id/content.json

Request

Response

Topics

GET /topics.json

Request

Response

GET /topics/:id.json

Request

Response

GET /topics/:id/content.json

Request

Response

Products

GET /products.json

Request

Response

GET /products/:id.json

Request

Response

GET /products/:id/content.json

Request

Response

Search

GET /search.json

Request

Response

Response