Programme Information: Digiguide.tv API Documentation

Programme Information

Programme

Use this API to get all available meta data, including any generic images, for the requested programme.

End Point	http://api.digiguide.tv/1.2/tv/programme/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	Optional If the user is not subscribed to any Digiguide services then the cast is limited to the main 3 actors, the main director and main writer and the description and image properties are not returned.

Required Parameters

appid=<yourappid>	Your unique and secret Application ID
id=<unsigned integer>	Valid programme ID as returned from the "Schedules" API.

Successful Response

{
  "success": true
  "programme": { 
      "id": 767775,
      "title": "The Walking Dead",
      "year": 2010,
      "blackAndWhite": false,
      "rating": 4,
      "durationMinutes": 60,
      "hashTagsOfficial": [ 
          {
            "tag": "twd"
          }
        ],
      "hashTags": [ 
          {
            "tag": "twd"
          },
          {
            "tag": "walkingdead"
          }
        ],
      "tags": [ 
          {
            "name": "Zombie",
            "nameFlat": "zombie"
          },
          { 
            "name": "Post-Apocalyptic",
            "nameFlat": "postapocalyptic"
          },
          { 
            "name": "Based-on-Comic",
            "nameFlat": "basedoncomic"
          },
          { 
            "name": "Drama Series",
            "nameFlat": "dramaseries"
          },
          { 
            "name": "Drama",
            "nameFlat": "drama"
          },
          { 
            "name": "4 Star",
            "nameFlat": "4star"
          }
        ],
      "categoryID": 6,
      "category": "Drama",
      "description": "US drama series. After waking up from a coma in an abandoned Atlanta hospital, Officer Rick Grimes embarks on a survivalist adventure in a world overrun by zombies.",
      "facebookPage": "https://www.facebook.com/TheWalkingDeadAMC",
      "twitterPage": "https://twitter.com/WalkingDead_AMC",
      "imageMain": {
          "height": 188,
          "url": "http://i.digiguide.tv/up/1209/1350680400-767775-TheWalkin-13485681940.jpg",
          "width": 350
        },
      "imageThumb": {
          "height": 150,
          "url": "http://i.digiguide.tv/up/1209/tn-1350680400-767775-TheWalkin-13485681940.jpg",
          "width": 150
        },
      "imageTinyThumb": {  
          "height": 75,
          "url": "http://i.digiguide.tv/up/1209/ttn-1350680400-767775-TheWalkin-13485681940.jpg",
          "width": 75
        },
      "writers": [ 
          { "id": 12384,
            "name": "Frank Darabont"
          },
          { "id": 291244,
            "name": "Robert Kirkman"
          },
          { "id": 291245,
            "name": "Tony Moore"
          },
          { "id": 298231,
            "name": "Charlie Adlard"
          },
          { "id": 197256,
            "name": "Glen Mazzara"
          },
          { "id": 248801,
            "name": "Scott M. Gimple"
          },
          { "id": 190290,
            "name": "Evan T. Reilly"
          },
          { "id": 312946,
            "name": "Angela Kang"
          },
          { "id": 312937,
            "name": "Nichole Beattie"
          },
          { "id": 30913,
            "name": "David Johnson"
          },
          { "id": 83861,
            "name": "Charles H. Eglee"
          },
          { "id": 297882,
            "name": "Sang Kyu Kim"
          },
          { "id": 320632,
            "name": "Ryan C. Coleman"
          },
          { "id": 18875,
            "name": "Frank Renzulli"
          },
          { "id": 197336,
            "name": "Adam Fierro"
          },
          { "id": 289826,
            "name": "Jack LoGiudice"
          }
        ],
      "directors": [
          { "id": 41424,
            "name": "Ernest R. Dickerson"
          },
          { "id": 1760,
            "name": "Guy Ferland"
          },
          { "id": 149495,
            "name": "Gregory Nicotero"
          },
          { "id": 293365,
            "name": "Bill Gierhart"
          },
          { "id": 69012,
            "name": "David Boyd"
          },
          { "id": 213357,
            "name": "Phil Abraham"
          },
          { "id": 197444,
            "name": "Gwyneth Horder-Payton"
          },
          { "id": 214973,
            "name": "Seith Mann"
          },
          { "id": 4147,
            "name": "Lesli Linka Glatter"
          },
          { "id": 27428,
            "name": "Daniel Sackheim"
          },
          { "id": 91556,
            "name": "Michelle MacLaren"
          },
          { "id": 8956,
            "name": "Stefan Schwartz"
          },
          { "id": 203384,
            "name": "Michelle Maxwell MacLaren"
          },
          { "id": 264949,
            "name": "Johan Renck"
          },
          { "id": 1523,
            "name": "Daniel Attias"
          },
          { "id": 160554,
            "name": "Tricia Brock"
          },
          { "id": 9861,
            "name": "Clark Johnson"
          }
        ],
      "cast": [
          { "id": 472,
            "name": "Andrew Lincoln",
            "role": "Rick Grimes"
          },
          { "id": 99155,
            "name": "Sarah Wayne Callies",
            "role": "Lori Grimes"
          },
          { "id": 20942,
            "name": "Laurie Holden",
            "role": "Andrea"
          },
          { "id": 291241,
            "name": "Steven Yeun",
            "role": "Glenn Rhee"
          },
          { "id": 291236,
            "name": "Chandler Riggs",
            "role": "Carl Grimes"
          },
          { "id": 19513,
            "name": "Norman Reedus",
            "role": "Daryl Dixon"
          },
          { "id": 55943,
            "name": "Melissa Suzanne McBride",
            "role": "Carol Peletier"
          },
          { "id": 214786,
            "name": "Lauren Cohan",
            "role": "Maggie Greene"
          },
          { "id": 3710,
            "name": "Scott Wilson",
            "role": "Hershel Greene"
          },
          { "id": 312929,
            "name": "Emily Kinney",
            "role": "Beth Greene"
          },
          { "id": 99161,
            "name": "Jon Bernthal",
            "role": "Shane Walsh"
          },
          { "id": 278619,
            "name": "IronE Singleton",
            "role": "Theodore 'T-Dog' Douglas"
          },
          { "id": 3589,
            "name": "Jeffrey DeMunn",
            "role": "Dale Horvath"
          },
          { "id": 1614,
            "name": "Michael Rooker",
            "role": "Merle Dixon"
          },
          { "id": 250577,
            "name": "Danai Jekesai Gurira",
            "role": "Michonne"
          },
          { "id": 7873,
            "name": "David Morrissey",
            "role": "The Governor"
          },
          { "id": 291232,
            "name": "Madison Lintz",
            "role": "Sophia, Sophia Peletier"
          },
          { "id": 121089,
            "name": "Dallas Roberts",
            "role": "Milton Mamet"
          },
          { "id": 312956,
            "name": "Jane McNeill",
            "role": "Patricia"
          },
          { "id": 306126,
            "name": "James Allen McCune",
            "role": "Jimmy"
          },
          { "id": 159919,
            "name": "Jose Pablo Cantillo",
            "role": "Caesar Martinez"
          },
        ... <snip> ...
        ]
    },
  "responseRestricted": false,
}

Or, for an example of a film:

{
  "success": true,
  "programme": {
    "id": 794407,
    "name": "Harry Potter and the Deathly Hallows: Part 1",
    "year": 2010,
    "certificate": "12A",
    "madeForTV": false,
    "blackAndWhite": false,
    "starRating": 4,
    "durationMinutes": 146,
    "countryOfOrigin": "UK\/USA",
    "tags": [
      {
        "tag": "BasedonNovel"
      },
      {
        "tag": "Family"
      },
      {
        "tag": "Mystery"
      },
      {
        "tag": "Fantasy"
      },
      {
        "tag": "Adventure"
      },
      {
        "tag": "Film"
      },
      {
        "tag": "Movie"
      },
      {
        "tag": "Movies"
      },
      {
        "tag": "Films"
      },
      {
        "tag": "4Star"
      }
    ],
    "categoryID": 2,
    "category": "Film",
    "description": "The seventh adventure of the Harry Potter series. Following Dumbledore's (Michael Gambon) death, Lord Voldemort (Ralph Fiennes) and his cronies have taken over the Ministry of Magic and are hellbent on killing Harry Potter (Daniel Radcliffe).\r\n\r\nAs a result, the good wizards of the Order of the Phoenix arrive at Harry's home and whisk him to safety, but the Death Eaters are hot on his trail.\r\nRealising that the only way to defeat Voldemort is to destroy all the horcruxes - objects that contain pieces of the dark wizard's malevolent soul - Harry, Hermione (Emma Watson) and Ron (Rupert Grint) set out on an epic quest to locate them and end his vile reign forever.\r\n\r\nLearning from Xenophilios Lovegood (Ifans) of the legend of the Deathly Hallows, Harry, Hermione and Ron realise that Voldemort could be on the verge of becoming invincible, and the scene is set for a desperate battle to prevent this.",
    "writers": [
      {
        "name": "Steven Kloves",
        "id": 131964
      },
      {
        "name": "J.K. Rowling",
        "role": "Novel",
        "id": 131963
      }
    ],
    "directors": [
      {
        "name": "David Yates",
        "id": 35535
      }
    ],
    "cast": [
      {
        "name": "Daniel Radcliffe",
        "role": "Harry Potter",
        "id": 23921
      },
      {
        "name": "Rupert Grint",
        "role": "Ron Weasley",
        "id": 72471
      },
      {
        "name": "Emma Watson",
        "role": "Hermione Granger",
        "id": 26696
      },
      {
        "name": "Ralph Fiennes",
        "role": "Lord Voldemort",
        "id": 70
      },
      {
        "name": "Michael Gambon",
        "role": "Albus Dumbledore",
        "id": 264
      },
      {
        "name": "Alan Rickman",
        "role": "Professor Severus Snape",
        "id": 3244
      },
      {
        "name": "Helena Bonham Carter",
        "role": "Bellatrix Lestrange",
        "id": 19917
      },
      {
        "name": "Tom Felton",
        "role": "Draco Malfoy",
        "id": 18124
      },
      {
        "name": "Bill Nighy",
        "role": "Minister Rufus Scrimgeour",
        "id": 7888
      },
      {
        "name": "Bonnie Wright",
        "role": "Ginny Weasley",
        "id": 62179
      },
      {
        "name": "Jason Isaacs",
        "role": "Lucius Malfoy",
        "id": 3874
      },
      {
        "name": "John Hurt",
        "role": "Mr. Ollivander",
        "id": 4337
      },
      {
        "name": "Julie Walters",
        "role": "Molly Weasley",
        "id": 10092
      },
      {
        "name": "Carolyn Pickles",
        "role": "Charity Burbage",
        "id": 19840
      },
      {
        "name": "Ian Kelly",
        "role": "Mr. Granger",
        "id": 95888
      },
      {
        "name": "Michelle Fairley",
        "role": "Mrs. Granger",
        "id": 3215
      },
      {
        "name": "Richard Griffiths",
        "role": "Vernon Dursley",
        "id": 2410
      },
      {
        "name": "Harry Melling",
        "role": "Dudley Dursley",
        "id": 72472
      },
      {
        "name": "Fiona Shaw",
        "role": "Petunia Dursley",
        "id": 8224
      }
    ],
    "imageMain": {
      "url": "http:\/\/i.digiguide.tv\/up\/1105\/794407-HarryPott-13044519849.37.jpg",
      "width": 350,
      "height": 214
    },
    "imageThumb": {
      "url": "http:\/\/i.digiguide.tv\/up\/1105\/\/tn-794407-HarryPott-13044519849.37.jpg",
      "width": 150,
      "height": 150
    },
    "imageTinyThumb": {
      "url": "http:\/\/i.digiguide.tv\/up\/1105\/\/ttn-794407-HarryPott-13044519849.37.jpg",
      "width": 75,
      "height": 75
    }
  }
}

Programme Show Times

Use this API to get the current show times for the given programme within a date range.

End Point	http://api.digiguide.tv/1.2/tv/programmeshowtimes/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	Optional If no authenticated user then only schedules for the current day are returned and the synopsis, qualifiers, episodeTitle, seasonNumber, episodeNumber and specialEpisode properties are also not returned If user is authenticated then only the schedules for the user's selected channels will be returned.

Required Parameters

appid=<yourappid>	Your unique and secret Application ID
id=<unsigned integer>	Valid programme ID as returned from the "Programme", "Schedules" or "Search" APIs

Optional Parameters

from=<utcjulian>	Valid UTC Julian time as represented by number of milliseconds since the Epoch. This value is the standard value returned by the JavaScript "getTime()" method of Date object
to=<utcjulian>	Valid UTC Julian time as represented by number of milliseconds since the Epoch. This value is the standard value returned by the JavaScript "getTime()" method of Date object

Successful Response

{
  "success": true,
  "responseRestricted": false,
  "programme": {
    "id": 37691,
    "name": "Breakfast",
    "category": "Magazine Programme",
    "categoryID": 18
  },
  "schedules": [
    {
      "id": 14167,
      "startUTC": 1305176400,
      "endUTC": 1305188100,
      "episodeTitle": "",
      "seriesNum": 0,
      "episodeNum": 0,
      "synopsis": "",
      "qualifiers": "Subtitles, High Definition",
      "channel": {
        "id": 1010,
        "name": "BBC1 HD",
        "epg": "101"
      }
    }
  ]
}

Programme Seasons

Use this API to get a list of series with episode counts for the given programme ID

End Point	http://api.digiguide.tv/1.2/tv/seasonlist/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	None

Required Parameters

appid=<yourappid>	Your unique and secret Application ID
id=<unsigned int>	Valid programme ID as returned by "Programme", "Schedules" or "Search" APIs.

Successful Response

{
  "success" : true,
	"seasons" : [
		{
			"episodeCount" : 21,
			"seasonNumber" : -1,
			"specialEpisodes" : true
		},
		{
			"episodeCount" : 9,
			"seasonNumber" : 1,
			"specialEpisodes" : false
		},
		{
			"episodeCount" : 10,
			"seasonNumber" : 2,
			"specialEpisodes" : false
		},
		{
			"episodeCount" : 11,
			"seasonNumber" : 3,
			"specialEpisodes" : false
		},
		{
			"episodeCount" : 11,
			"seasonNumber" : 4,
			"specialEpisodes" : false
		},
		{
			"episodeCount" : 8,
			"seasonNumber" : 5,
			"specialEpisodes" : false
		},
		{
			"episodeCount" : 6,
			"seasonNumber" : 6,
			"specialEpisodes" : false
		},
		{
			"episodeCount" : 6,
			"seasonNumber" : 7,
			"specialEpisodes" : false
		}
	]
}

Programme Season Episodes

Use this API to get a list of episodes for the given programme ID and season number

End Point	http://api.digiguide.tv/1.2/tv/episodelist/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	None

Required Parameters

appid=<yourappid>	Your unique and secret Application ID
id=<unsigned int>	Valid programme ID as returned by "Programme", "Schedules" or "Search" APIs.
seasonnumber=<int>	Valid season number as returned by "Programme Seasons", "Programme", "Schedules" or "Search" APIs. Pass in "-1" if you wish to retrieve a list of 'special episodes (e.g. Christmas Specials)

Successful Response

{
  "success" : true,
	"episodes" : [
		{
			"id" : 65084,
			"seasonNumber" : -1,
			"episodeNumber" : 1,
			"specialEpisode" : true,
			"title" : "Christmas Crackers",
			"originalAirDate" : "December 28, 1981"
		},
		{
			"id" : 65085,
			"seasonNumber" : -1,
			"episodeNumber" : 2,
			"specialEpisode" : true,
			"title" : "The Funny Side of Christmas"
		},
		{
			"id" : 58580,
			"seasonNumber" : -1,
			"episodeNumber" : 3,
			"specialEpisode" : true,
			"title" : "Diamonds Are for Heather",
			"originalAirDate" : "December 30, 1982"
		},
		{
			"id" : 1861,
			"seasonNumber" : -1,
			"episodeNumber" : 4,
			"specialEpisode" : true,
			"title" : "Thicker than Water"
		},
		{
			"id" : 3100,
			"seasonNumber" : -1,
			"episodeNumber" : 5,
			"specialEpisode" : true,
			"title" : "To Hull and Back",
			"originalAirDate" : "December 25, 1985"
		},
		{
			"id" : 58694,
			"seasonNumber" : -1,
			"episodeNumber" : 6,
			"specialEpisode" : true,
			"title" : "A Royal Flush",
			"originalAirDate" : "December 25, 1986"
		},
		{
			"id" : 5929,
			"seasonNumber" : -1,
			"episodeNumber" : 7,
			"specialEpisode" : true,
			"title" : "The Frog's Legacy",
			"originalAirDate" : "December 25, 1987"
		},
		{
			"id" : 58613,
			"seasonNumber" : -1,
			"episodeNumber" : 8,
			"specialEpisode" : true,
			"title" : "Dates",
			"originalAirDate" : "December 25, 1988"
		},
		{
			"id" : 4164,
			"seasonNumber" : -1,
			"episodeNumber" : 9,
			"specialEpisode" : true,
			"title" : "The Jolly Boys' Outing"
		},
		{
			"id" : 13024,
			"seasonNumber" : -1,
			"episodeNumber" : 10,
			"specialEpisode" : true,
			"title" : "Rodney Come Home",
			"originalAirDate" : "December 25, 1990"
		},
		{
			"id" : 65861,
			"seasonNumber" : -1,
			"episodeNumber" : 11,
			"specialEpisode" : true,
			"title" : "Miami Twice: The American Dream (Part 1 of 2)"
		},
		{
			"id" : 65863,
			"seasonNumber" : -1,
			"episodeNumber" : 12,
			"specialEpisode" : true,
			"title" : "Miami Twice: Oh, to Be in England (Part 2 of 2)"
		},
		{
			"id" : 47099,
			"seasonNumber" : -1,
			"episodeNumber" : 13,
			"specialEpisode" : true,
			"title" : "Mother Nature's Son",
			"originalAirDate" : "December 25, 1992"
		},
		{
			"id" : 47578,
			"seasonNumber" : -1,
			"episodeNumber" : 14,
			"specialEpisode" : true,
			"title" : "Fatal Extraction",
			"originalAirDate" : "December 25, 1993"
		},
		{
			"id" : 65079,
			"seasonNumber" : -1,
			"episodeNumber" : 15,
			"specialEpisode" : true,
			"title" : "It Could Happen to You"
		},
		{
			"id" : 6796,
			"seasonNumber" : -1,
			"episodeNumber" : 16,
			"specialEpisode" : true,
			"title" : "Heroes and Villains",
			"originalAirDate" : "December 25, 1996"
		},
		{
			"id" : 7589,
			"seasonNumber" : -1,
			"episodeNumber" : 17,
			"specialEpisode" : true,
			"title" : "Modern Men",
			"originalAirDate" : "December 27, 1996"
		},
		{
			"id" : 8409,
			"seasonNumber" : -1,
			"episodeNumber" : 18,
			"specialEpisode" : true,
			"title" : "Time on Our Hands",
			"originalAirDate" : "December 29, 1996"
		},
		{
			"id" : 250438,
			"seasonNumber" : -1,
			"episodeNumber" : 19,
			"specialEpisode" : true,
			"title" : "If They Could See Us Now...!"
		},
		{
			"id" : 175717,
			"seasonNumber" : -1,
			"episodeNumber" : 20,
			"specialEpisode" : true,
			"title" : "Strangers on the Shore",
			"originalAirDate" : "December 25, 2002"
		},
		{
			"id" : 250437,
			"seasonNumber" : -1,
			"episodeNumber" : 21,
			"specialEpisode" : true,
			"title" : "Sleepless in Peckham",
			"originalAirDate" : "December 25, 2003"
		}
	]
}

Programmes Liked

Use this API to get a list of programmes that the user may also like based on a given programme ID. The recommendations engine can be tuned to include/exclude editorial programmes or statistically based user recommendations.

End Point	http://api.digiguide.tv/1.2/tv/programmesalsolike/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	Optional If no authenticated user then only editor recommendations are used in the engine to discover programmes to return.

Required Parameters

appid=<yourappid>	Your unique and secret Application ID
id=<unsigned integer>	Valid programme ID as returned from the "Programme", "Schedules" or "Search" APIs

Optional Parameters

what=<users>	If specified, the recommendations engine will skew the returned programmes based on statistical analysis of the authenticated user�s preferences
what=<editors>	If specified, the recommendations engine will skew the returned programmes based on editor created related programmes

Successful Response

{
  "success" : true,
  "responseRestricted" : false,
  "programmes" : [
    {
      "type" : "editor",
      "id" : 651487,
      "name" : "Renovation Nation",
      "basedOnID" : 11974,
      "basedOnName" : "Grand Designs",
      "category" : "DIY",
      "categoryID" : 27,
      "imageMain" : { "height" : 350,
          "url" : "http://i.digiguide.tv/up/0806/1215118800-651487-Renovation-12133647050.jpg",
          "width" : 262
        },
      "imageThumb" : { "height" : 150,
          "url" : "http://i.digiguide.tv/up/0806/tn-1215118800-651487-Renovation-12133647050.jpg",
          "width" : 150
        },
      "imageTinyThumb" : { "height" : 75,
          "url" : "http://i.digiguide.tv/up/0806/ttn-1215118800-651487-Renovation-12133647050.jpg",
          "width" : 75
        }
    },
    {
      "type" : "editor",
      "id" : 226793,
      "name" : "Superhomes",
      "basedOnID" : 11974,
      "basedOnName" : "Grand Designs",
      "category" : "Documentary",
      "categoryID" : 5
    },
    {
      "type" : "editor",
      "id" : 824887,
      "name" : "Seeking Salvage",
      "basedOnID" : 11974,
      "basedOnName" : "Grand Designs",
      "category" : "History Documentary",
      "categoryID" : 36,
      "imageMain" : { "height" : 315,
          "url" : "http://i.digiguide.tv/up/1111/1321394400-824887-SeekingSa-13207570130.jpg",
          "width" : 286
        },
      "imageThumb" : { "height" : 150,
          "url" : "http://i.digiguide.tv/up/1111/tn-1321394400-824887-SeekingSa-13207570130.jpg",
          "width" : 150
        },
      "imageTinyThumb" : { "height" : 75,
          "url" : "http://i.digiguide.tv/up/1111/ttn-1321394400-824887-SeekingSa-13207570130.jpg",
          "width" : 75
        }
    },
    {
      "type" : "editor",
      "id" : 579600,
      "name" : "Build, Buy or Restore Abroad",
      "basedOnID" : 11974,
      "basedOnName" : "Grand Designs",
      "category" : "Consumer",
      "categoryID" : 22
    },
    {
      "type" : "user",
      "id" : 98397,
      "name" : "CSI: Miami",
      "basedOnID" : 162149,
      "basedOnName" : "Taken",
      "category" : "Drama",
      "categoryID" : 6,
      "imageMain" : { "height" : 228,
          "url" : "http://i.digiguide.tv/up/0802/1185912000000-98397-CSIMiami-1185461623703.jpg",
          "width" : 350
        },
      "imageThumb" : { "height" : 150,
          "url" : "http://i.digiguide.tv/up/0802/tn-1185912000000-98397-CSIMiami-1185461623703.jpg",
          "width" : 150
        },
      "imageTinyThumb" : { "height" : 75,
          "url" : "http://i.digiguide.tv/up/0802/ttn-1185912000000-98397-CSIMiami-1185461623703.jpg",
          "width" : 75
        }
    }
  ]
}

Programme Images

Use this API to get the most relevant image given certain parameters. The API allows you to pass in a specific schedule id, programme, programme/episode or programme/channel/time ... returning you the most specific image if available or defaulting to one that is more 'generic' for the show, if there is one.

End Point	http://api.digiguide.tv/1.2/tv/programmeimage/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	None

Required Parameters

appid=<yourappid>	Your unique and secret Application ID
Then one of the following three set of parameters: 1. The following option will attempt to return an image that has been assigned to a specific broadcast schedule of a programme schedule event. For example, a specific episode of EastEnders. If a specific image is not found, it will attempt to find and return the best image for the programme
scheduleid=<unsigned int>	Valid schedule ID as returned by the "Schedules" API.

2. The following option will also attempt to return an image that has been assigned to a specific broadcast schedule of a programme on a channel date/time. For example, a specific episode of EastEnders. If a specific image is not found, it will attempt to find and return the best image for the programme
progid=<unsigned int>	Valid programme ID as returned by "Programme", "Schedules" or "Search" APIs.
channel=<unsigned int>	Valid channel ID as returned by "Schedules" or "Search" APIs.
datetimeutc=<utcjulian>	Valid schedule broadcast time as returned by "Schedules" or "Search" APIs. UTC Julian time is represented by number of milli-seconds since the Epoch as returned by the JavaScript "getTime()" method of Date object.

3. The following option will also attempt to return an image that has been assigned to a specific programme episode. For example, a specific episode of Frasier. If one is not found, it will attempt to find and return the best image for the programme
progid=<unsigned int>	Valid programme ID as returned by "Programme", "Schedules" or "Search" APIs.
episode=<string>	Episode title string as returned by "Schedules" or "Search" APIs.

Optional Parameters

what=nodefault

Force the response to only return a specific image and not return any generic image if a specific image cannot be found.

Successful Response

{
  "success": true,
  "image": {
    "imageMain": {
      "url": "http:\/\/i.digiguide.tv\/up\/0907\/1247864400-663898-TrueBlood-12471342240.jpg",
      "width": 350,
      "height": 192 
    },
    "imageThumb": {
      "url": "http:\/\/i.digiguide.tv\/up\/0907\/\/tn-1247864400-663898-TrueBlood-12471342240.jpg",
      "width": 150,
      "height": 150 
    },
    "imageTinyThumb": {
      "url": "http:\/\/i.digiguide.tv\/up\/0907\/\/ttn-1247864400-663898-TrueBlood-12471342240.jpg",
      "width": 75,
      "height": 75 
    } 
  } 
}

Popular Programmes

Use this API to get the currently most popular programmes based on total user preferences in the database. The response returns an array of programmes with the most popular programme first

End Point	http://api.digiguide.tv/1.2/tv/popularprogrammes/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	None

Required Parameters

appid=<yourappid>

Your unique and secret Application ID

Successful Response

{
  "success": true
  "programmes": [
    {
      "id": 74757,
      "title": "Doctor Who"
    },
    {
      "id": 8954,
      "title": "Top Gear"
    },
    {
      "id": 214538,
      "title": "NCIS"
    },
    {
      "id": 45343,
      "title": "The Big Bang Theory"
    },
    {
      "id": 199441,
      "title": "QI"
    },
    {
      "id": 10834,
      "title": "Have I Got News for You"
    }
  ]
}

TV Highlights

Use this API to get an array of programme highlights (TV Editor Picks), chosen and written by our in-house editors, for the selected date range.

End Point	http://api.digiguide.tv/1.2/tv/recommendations/
Supported Responses	JSON
Supported Methods	GET
URI Scheme	Either HTTP or HTTPS requests are supported.
User Authentication	Optional If no 'subscribed' authenticated user is passed, then only 2 recommendations are returned for the current day only.

Required Parameters

appid=<yourappid>

Your unique and secret Application ID

Optional Parameters

If 'from' or 'to' parameters are omitted, only the recommendations for the current day are returned.
from=<utcjulian>	Valid UTC Julian time as represented by number of seconds since the Epoch. If using JavaScript "getTime()" method of Date object, then divide the return value by 1000 as JavaScript returns number of milli-seconds since Epoch.
to=<utcjulian>	Valid UTC Julian time as represented by number of seconds since the Epoch. If using JavaScript "getTime()" method of Date object, then divide the return value by 1000 as JavaScript returns number of milli-seconds since Epoch.

Successful Response

{
  "success" : true,
  "responseRestricted" : true,
  "recommendations" : [
    {
      "id" : 21068,
      "name" : "New Tricks",
      "guid" : "drama-new-tricks-the-rock-part-one",
      "progID" : 181247,
      "category" : "Drama",
      "categoryID" : 6,
      "channelID" : 1,
      "channelName" : "BBC 1",
      "dateTime" : "Tue, 30 Jul 2013 20:00:00 GMT",
      "startUTC" : 1375214400,
      "imageMain" :
        {
          "url" : "http://i.digiguide.tv/up/1307/1375214400-181247-NewTricks-13745911460.jpg",
          "height" : 196,
          "width" : 350
        },
      "imageThumb" :
        {
          "url" : "http://i.digiguide.tv/up/1307/tn-1375214400-181247-NewTricks-13745911460.jpg",
          "height" : 150,
          "width" : 150
        },
      "imageTinyThumb" :
        {
          "url" : "http://i.digiguide.tv/up/1307/ttn-1375214400-181247-NewTricks-13745911460.jpg",
          "height" : 75,
          "width" : 75
        },
      "imageCredit" : "BBC/Wall to Wall/Amanda Searle",
      "pickOfTheDay" : true,
      "pickOfTheWeek" : true,
      "review" : "In the first episode of series ten, Lane is suspended after assaulting an officer he suspects of covering up a death in custody which lead to his early retirement.\r\n\r\nThe assault triggers a disciplinary hearing which was Lane's intention all along. Meanwhile, a mysterious Argentinian pistol is recovered from the Thames. Not only does it appear to have been fired in the Falklands conflict but it was also used in the unsolved 1998 murder of a playboy shipping heir. When the pistol is linked to a second unsolved murder, a young boy, Danny Bossano on the Rock of Gibraltar in 1982, the team must face their most challenging case yet. Without Lane, they embark on a Mediterranean adventure that pushes them to their limits. Pullman's direct approach leads to tension with the MOD and local police, especially Superintendent Cruz and the surprise appearance of an old friend who has found a vital clue, leaves Standing in a very dangerous position.",
      "summary" : "Series ten of the drama following an eccentric group of ex-police officers who were brought out of retirement to investigate unsolved crimes.In this episode, Lane's future at UCOS is threatened by a death in custody which emerges from his past."
    },
    {
      "id" : 21102,
      "name" : "Kirstie's Fill Your House for Free",
      "guid" : "consumer-kirsties-fill-your-house-for-free-ii",
      "progID" : 919954,
      "category" : "Consumer",
      "categoryID" : 22,
      "channelID" : 4,
      "channelName" : "Channel 4",
      "dateTime" : "Tue, 30 Jul 2013 19:00:00 GMT",
      "startUTC" : 1375210800,
      "imageMain" :
        {
          "url" : "http://i.digiguide.tv/up/1307/1374606000-919954-Kirsties-13739710630.jpg",
          "height" : 196,
          "width" : 350
        },
      "imageThumb" :
        {
          "url" : "http://i.digiguide.tv/up/1307/tn-1374606000-919954-Kirsties-13739710630.jpg",
          "height" : 150,
          "width" : 150
        },
      "imageTinyThumb" :
        {
          "url" : "http://i.digiguide.tv/up/1307/ttn-1374606000-919954-Kirsties-13739710630.jpg",
          "height" : 75,
          "width" : 75
        },
      "pickOfTheDay" : false,
      "pickOfTheWeek" : false,
      "review" : "Curt and Nicola Marlow are a young married couple in need of help. They've recently bought their first flat together, near Bournemouth, but have been forced to refurnish from scratch after their previous home was flooded by raw sewage. Being in this predicament doesn't stop their pursuit of perfection. Can Kirstie and the team pull together to furnish their flat with a zero price tag? \r\n\r\nAlso in Kirstie's store is Jules Pritchard, also a victim of flooding, who wants help to breathe life back into her family snug - the room where she and her teenage sons hang out as a family. After seeing her furniture washed away not just once in 2007, but again in 2012, she's tired of buying new and wants simpler options to give the snug a transformation without breaking the bank. With plenty of practical tips, inspirational advice and some simple solutions, Kirstie wants to show second hand is not second best.",
      "summary" : "This week Kirstie helps a young married couple who are looking to refurnish their flat after their previous property suffered flooding."
    }
  ]
}