I/O Docs: API Documentation

Test our API services using I/O Docs. You can also view our written documentation.

Select an Interactive Documentation
Channel 4 API

OAuth 2.0 Flow:

Existing Client Credentials:

API Key:

App/Key: Manually provide key information

Shared Secret:

Client ID:

Client Secret:

Client ID:

Client Secret:

Username:

Password:

Client ID:

Client Secret:

Authorization Code:

Access Token:

Username:

Password:

Username:

Binary Security Token:

Username:

Password:

Discovery Methods

List Methods

Expand Methods

GET A to Z /atoz.atom

List of letters available.

GET A to Z Letter /atoz/:letter:filter.atom

List of Brands for a particular letter.

Parameter	Value	Type	Description
:letter		string	Letter to define list.
:filter		string	Filter list to only include Brands with 4oD.

GET Category /categories/:category:filter:sort.atom

All Channel 4 programmes associated with the specified category

Parameter	Type	Description
:category	string	All Channel 4 programmes associated with the specified category
:filter	string	Filter list to only include Brands with 4oD.
:sort	string	Sort by date (default), title or popular (only with 4oD filter)

GET TV Listings /tv-listings/daily/:year/:month/:day/:channel.atom

EPG Information of daily broadcast content aired per channels, according to broadcast date. Note EPG data is only available for 30 days behind and 14 days ahead of the current date.

Parameter	Type	Description
:year	number	Year
:month	number	Month
:day	number	Day
:channel	string	Year

GET Coming Soon /coming-soon:category.atom

Coming Soon feed display a list of episodes coming soon to linear TV so that I can promote new Channel 4 content.

Parameter	Value	Type	Description
:category		string	To filter coming soon to selected categroy

GET Search /search.atom

List of letters available.

Parameter	Value	Type	Description
q		string	Query term, must be at least 2 chars

GET 4oD by Date /4od/episode-list/date/:year/:month/:day.atom

Information of daily broadcast content available on 4oD, according to broadcast date

Parameter	Type	Description
:year	number	Year
:month	number	Month
:day	number	Day

Metadata Methods

List Methods

Expand Methods

GET Brand Hub Feed /:brand.atom

Brand Information

Parameter	Value	Type	Description
:brand		string	The Brand Web Safe Title, that can be found in the discovery methods

GET 4oD Feed /:brand/4od.atom

A feed containing all available on-demand long-form content for a specified brand.

Parameter	Value	Type	Description
:brand		string	The Brand Web Safe Title, that can be found in the discovery methods

GET Episode Guide Feed /:brand/episode-guide:series:episode.atom

A feed containing all available on-demand long-form content for a specified brand.

Parameter	Type	Description
:brand	string	The Brand Web Safe Title, that can be found in the discovery methods
:series	string	Drill down into the series NOTE not all Brands have multiple series
:episode	string	Drill down into the episodes NOTE not all Brands have multiple series

GET Brand EPG /:brand/epg.atom

This feed contains metadata about upcoming electronic programme guide (EPG) information for a brand.

Parameter	Value	Type	Description
:brand		string	The Brand Web Safe Title, that can be found in the discovery methods

GET Clip Feeds /:brand/video:series:episode.atom

A feed containing metadata about all the short-form (clip) videos. The clips feed can be accessed at different levels: the content is then filtered depending on the level, but the structure is identical

Parameter	Type	Description
:brand	string	The Brand Web Safe Title, that can be found in the discovery methods
:series	string	Drill down into the series NOTE not all Brands have multiple series
:episode	string	Drill down into the episodes NOTE not all Brands have multiple series

GET Programme /programme/:programmeID.atom

A feed containing all long-form content currently or previously available for a specified Programme Id. The entries for the Programme feed contain references to long-form assets for each platform.

Parameter	Value	Type	Description
:programmeID		string	The websafe programme identifier for the episode for which you seek on-demand content

Interactive API

I/O Docs: API Documentation

Discovery Methods List Methods Expand Methods

Metadata Methods List Methods Expand Methods

Discovery Methods

List Methods

Expand Methods

Metadata Methods

List Methods

Expand Methods