• Register

New shows airing by day

/programs/newShowAirings

Returns schedule information for new television shows and episodes. New show airings can be requested up to 14 days in advance, for a maximum period of 24 hours from start date. This can be used to exclude reruns and show only new programming material, including live shows. 

Response data will be sorted by airing dateTime. Metadata will vary based upon program types. See Program metadata for listing of possible program types and associated detailed metadata.

Request Parameters

Parameter

Mandatory?

Description

lineupId

Yes

LineupId, which can be retrieved by calling /lineups API.

startDateTime

Yes

DateTime to begin schedule information, specified in ISO 8601 format.
Must be no more than 14 days after current dateTime.
See DateTime documentation for tips on formatting.

endDateTime

No

DateTime to end schedule information, specified in ISO 8601 format.
Must be no more than 24 hours after startDateTime.
If not specified, defaults to 3 hours after startDateTime.
See DateTime documentation for tips on formatting.

includeAdult

No

Specifies whether adult-only content should be included.
Valid values are: true, false
Defaults to false

imageSize

No

Valid values are: Sm, Md, Lg, Ms. See Image Sizing for details.
If not specified, defaults to Md.
If requested image size is not available, generic image will be returned.

imageAspectTV

No

Requested aspect ratio (horizontal by vertical) for TV show images
Valid values are: 2x3, 3x4, 4x3, 16x9
If not specified, defaults to 2x3
If requested aspect ratio is not available, generic image will be returned.

imageText No

Boolean indicating preference for image types with text (banners) or without text (iconics). If requested preference is not available, image selection will continue to next type (banner/iconic), before finally returning generic if no image found. Defaults to true for text preference.

api_key

Yes

24-character key obtained during application registration

Response Body

Response

Type

Description

Progam airings

Airing [ ]

Schedule and program information for new airings, up to a 24-hour period, on any station in specified lineup.

Sample Request

Return information for lineupId acquired by calling /lineups.

http://data.tmsapi.com/v1.1/programs/newShowAirings?lineupId=USA-NC32461-X&startDateTime=2015-02-10T16:00Z&api_key=1234567890

Sample Response

[
  {
    "startTime":"2015-02-10T14:00Z",
    "endTime":"2015-02-10T19:00Z",
    "duration":300,
    "qualifiers":[ "New" ],
    "channels":[ "297" ],
    "program":{
      "tmsId":"SH015294730000",
      "rootId":"9074403",
      "seriesId":"9074403",
      "subType":"Series",
      "title":"Market Day Report",
      "releaseYear":2012,
      "releaseDate":"2012",
      "origAirDate":"2012-02-15",
      "titleLang":"en",
      "descriptionLang":"en",
      "entityType":"Show",
      "genres":[ "Public affairs" ],
      "longDescription":"Live Ag/rural news, weather, in-depth commodities reports featuring the Grains, Cattle & Pork Markets.",
      "preferredImage":{
        "width":"240",
        "height":"360",
        "uri":"assets/p9074403_st_v5_aa.jpg",
        "category":"Staple",
        "tier":"Series"
      }
    },
    "stationId":"25148",
    "station":{
      "stationId":"25148",
      "callSign":"RFDTV",
      "channel":"297",
      "preferredImage":{
        "width":"360",
        "height":"270",
        "uri":"h3/NowShowing/25148/s25148_h3_aa.png",
        "category":"Logo",
        "primary":"true"
      }
    }
  },
  {
    "startTime":"2015-02-10T14:30Z",
    "endTime":"2015-02-10T16:10Z",
    "duration":100,
    "qualifiers":[ "Stereo", "DD 5.1", "New", "CC", "Premiere" ],
    "channels":[ "535" ],
    "program":{
      "tmsId":"MV000888420000",
      "rootId":"25266",
      "subType":"Feature Film",
      "title":"Timecode",
      "releaseYear":2000,
      "releaseDate":"2000",
      "titleLang":"en",
      "descriptionLang":"en",
      "entityType":"Movie",
      "genres":[ "Drama" ],
      "longDescription":"A production company begins casting for its next feature, and an up-and-coming actress named Rose (Salma Hayek) tries to manipulate her filmmaker boyfriend, Alex, into giving her a screen test. Alex's wife, Emma (Saffron Burrows), knows about the affair and is considering divorce, while Rose's girlfriend secretly spies on her and attempts to sabotage the relationship. The four storylines in the film were each shot in one take and are shown simultaneously, each taking up a quarter of the screen.",
      "shortDescription":"Improvised stories center around a movie producer, his wife, an aspiring actress and murder.",
      "topCast":[ "Xander Berkeley", "Golden Brooks", "Saffron Burrows" ],
      "directors":[ "Mike Figgis" ],
      "qualityRating":{ "ratingsBody":"TMS", "value":"3" },
      "ratings":[ { "code":"15", "body":"British Board of Film Classification" },
                  { "code":"14A", "body":"Alberta's Film Classification Board" },
                  { "code":"R", "body":"Motion Picture Association of America" } ],
      "runTime":"PT01H37M",
      "preferredImage":{
        "width":"240",
        "height":"360",
        "caption":{ "content":"Timecode (2000)", "lang":"en" },
        "uri":"assets/p25266_d_v5_aa.jpg",
        "category":"Box Art",
        "text":"yes",
        "primary":"true"
      }
    },
    "stationId":"25622",
    "station":{
      "stationId":"25622",
      "callSign":"OMAX",
      "channel":"535",
      "preferredImage":{
        "width":"360",
        "height":"270",
        "uri":"h3/NowShowing/25622/s25622_h3_aa.png",
        "category":"Logo",
        "primary":"true"
      }
    }
  },
  {
    "startTime":"2015-02-10T14:50Z",
    "endTime":"2015-02-10T16:20Z",
    "duration":90,
    "qualifiers":[ "Stereo", "New", "CC", "Premiere", "Enhanced" ],
    "channels":[ "586" ],
    "program":{
      "tmsId":"MV000728520000",
      "rootId":"22895",
      "subType":"Feature Film",
      "title":"Foolish",
      "releaseYear":1999,
      "releaseDate":"1999-04-09",
      "titleLang":"en",
      "descriptionLang":"en",
      "entityType":"Movie",
      "genres":[ "Comedy drama" ],
      "longDescription":"Miles \"Foolish\" Waise (Eddie Griffin) is trying to get his career as a stand-up comic off the ground, while his older brother, Quentin (Master P), better known as the criminal \"Fifty Dollah,\" has his own problems. The siblings receive maternal advice from their caring grandma (Marla Gibbs) and try to improve their lives, but they conflict with each other when the lovely Desiree (Amy Petersen) appears on the scene, and they are both hopelessly attracted to her.",
      "shortDescription":"A comic (Eddie Griffin) and his brother (Master P) open a comedy club.",
      "topCast":[ "Eddie Griffin", "Master P", "Amy Petersen" ],
      "directors":[ "Dave Meyers" ],
      "qualityRating":{ "ratingsBody":"TMS", "value":"1.5" },
      "ratings":[ { "code":"R", "body":"Motion Picture Association of America" } ],
      "runTime":"PT01H36M",
      "preferredImage":{
        "width":"240",
        "height":"360",
        "caption":{ "content":"Foolish (1999)", "lang":"en" },
        "uri":"assets/p22895_p_v5_aa.jpg",
        "category":"Poster Art",
        "text":"yes",
        "primary":"true"
      }
    },
    "stationId":"34901",
    "station":{
      "stationId":"34901",
      "callSign":"STZC",
      "channel":"586",
      "preferredImage":{
        "width":"360",
        "height":"270",
        "uri":"h3/NowShowing/34901/s34901_h3_aa.png",
        "category":"Logo",
        "primary":"true"
      }
    }
  }
]