New Shows (series/new_shows)

New Shows are represented as objects with the following fields. (NOTE: All fields are read-only)

Field

Type

Description

series_id

int

Unique identifier for the series this new show information is associated with (See Series)

start_date

string

First broadcast date for program (or if not in the schedule as yet it will be listed as "Coming Soon")

channel_id

int

Channel that the program will be broadcast on, if known. (See Channel)

Get all new shows

URL

https://api.icetv.com.au/new_shows

Method

GET

Query String

 

Returns

200 OK & Document (XML or JSON)

 

401 Unauthorized

 

404 Not Found

 

503 Service Unavailable

Request - URL
GET https://api.icetv.com.au/new_shows?api_key=API_KEY&application_version=APPLICATION_VERSION&email_address=EMAIL_ADDRESS&token=TOKEN
XML - Example of response
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE series SYSTEM "http://iceguide.icetv.com.au/iceguide/series.dtd">
<series>
<series_info id="25772" episode_count="40">
<title lang="en">Offspring</title>
<desc lang="en">Nina Proudman is better at ushering the offspring of other people into the world than creating an ordered existence for her own family. </desc>
<credits>
<actor>Asher Keddie</actor>
<actor>Kat Stewart</actor>
<actor>Deborah Mailman</actor>
<actor>John Waters</actor>
<actor>Eddie Perfect</actor>
<actor>Linda Cropper</actor>
</credits>
<date>2010</date>
<category lang="en">Drama</category>
<language lang="en">English</language>
<country>Australia</country>
<video>
<aspect>16:9</aspect>
</video>
<rating>
<value>M</value>
</rating>
</series_info>
 
--- truncated ---
<new_show series_id="25772" start_date="Wed, 22 May 2013" channel_id="0" />
 
--- truncated ---
</series>

JSON - Structure of the response

Name

Type

Description

Comment

series_info

array

Contains the series info for all the new shows

For some series some info may be missing

new_shows

array

Contains the new shows' series id and start date

 

JSON - Example of response
{
"series_info": [
{
"id": "40516",
"episode_count": "2",
"title": "Why Don't You Speak English?",
"desc": "Almost one million immigrants in the UK don't speak English. Polish is officially the second most commonly spoken language in the UK and the translation costs are over 125 million pounds a year. This series follows four first-generation immigrants as they try to learn English, with each of them being taught by British host families who they live with for a week.",
date: "2013",
category: [
{
name: "Documentary",
eit: "0x23",
}
]
"language": "English",
"country:: "United Kingdom",
"video": {
"aspect": "16:9",
}
subtitles: {
onscreen: "English",
teletex: "YES"
}
rating: "M",
},
 
--- truncated ---
 
],
"new_shows": [
{
"series_id": "40466",
"start_date": "Fri, 13 Mar 2015"
},
{
"series_id": "35280",
"start_date": ""
},
 
--- truncated ---
]
}