I/O Docs: API Documentation

OAuth 2.0 Flow: Select OAuth 2.0 Flow

Existing Client Credentials: Manual Input

API Key:

App/Key: Select Application Key Manually provide key information

Shared Secret:

Client ID:

Client Secret: Authorize

Client ID: Get Access Token

Client ID:

Client Secret:

---

Username:

Password: Get Access Token

Client ID:

Client Secret: Get Access Token

Authorization Code: Get Access Token

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	a b c d e z	string	Letter to define list.
    :filter	Default All Programmes Programmes on 4oD	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	Value	Type	Description
    :category	comedy documentaries drama entertainment	string	All Channel 4 programmes associated with the specified category
    :filter	Default All Programmes Programmes on 4oD	string	Filter list to only include Brands with 4oD.
    :sort	/title /popular	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	Value	Type	Description
    :year	2012 2013 2014	number	Year
    :month	01 02 03 04 05 06 07 08 09 10 11 12	number	Month
    :day	01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31	number	Day
    :channel	Channel 4 E4 More 4 Film 4 4 Music 4 Seven	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	/comedy /documentaries /drama /entertainment	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	Value	Type	Description
    :year	2012 2013 2014	number	Year
    :month	01 02 03 04 05 06 07 08 09 10 11 12	number	Month
    :day	01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31	number	Day

• Metadata Methods

  • List Methods
  • Expand Methods

  • GET Brand Hub Feed /:brand.atom

    Brand Information

    Parameter	Value	Type	Description
    :brand	shameless countdown peep-show grand-designs	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	shameless countdown peep-show grand-designs	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	Value	Type	Description
    :brand	shameless countdown peep-show grand-designs	string	The Brand Web Safe Title, that can be found in the discovery methods
    :series	/series-1 /series-2 /series-3	string	Drill down into the series NOTE not all Brands have multiple series
    :episode	/episode-1 /episode-2 /episode-3	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	shameless countdown peep-show grand-designs	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	Value	Type	Description
    :brand	shameless countdown peep-show grand-designs	string	The Brand Web Safe Title, that can be found in the discovery methods
    :series	/series-1 /series-2 /series-3	string	Drill down into the series NOTE not all Brands have multiple series
    :episode	/episode-1 /episode-2 /episode-3	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