• Register

New shows aired last week

/programs/newShowsLastWeek

Returns program information for television shows and episodes that aired new or live for a given date up to 7 days back. Only shows and episodes will be returned; movies and sports are excluded from response. This API could be used together with Online Video Data APIs to find original programming material from past week and offer alternative online viewing options.

Response data will be sorted by original air date, descending. 

Request Parameters

Parameter Mandatory? Description
startDate Yes Start date, must be current day or within past 7 days.
Format yyyy-mm-dd.
endDate No End date, must be no more than 7 days after start date.
Defaults to startDate. Format yyyy-mm-dd.
includeAdult No Boolean indicating whether to include adult TV shows in response. 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

Description

tmsId TMS-generated 14-character alphanumeric identifier for program record; first 2 characters generally identify program type (SH=show/series, EP=episode)
title program title; for episode records, this is series title
titleLang 2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish)
shortDescription
program description, maximum 100 characters
longDescription
program description, maximum 1000 characters
descriptionLang
2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish)
genres comma-separated list of program genres (e.g., Romance, Comedy, News)
topCast comma-separated list of top 3 cast member names, in billing order
origAirDate also known as OAD, date of original TV airing; format is yyyy-mm-dd
preferredImage program image, if available; see Image Metadata for details
episodeTitle episodes only; episode-specific title
seasonNum episodes only; season number; will not be provided for non-seasonal shows such as soap operas
episodeNum episodes only; episode number within season
entityType type of program: show, episode, special

Sample Request

Return information for lineupId acquired by calling /lineups.

http://data.tmsapi.com/v1.1/programs/newShowsLastWeek?startDate=2015-02-05&api_key=1234567890

Sample Response

[
  {
    "tmsId":"EP020992600001",
    "rootId":"11392042",
    "seriesId":"11392041",
    "subType":"Series",
    "title":"Match Made in Heaven",
    "episodeTitle":"The Garden of Eden",
    "origAirDate":"2015-02-04",
    "titleLang":"en",
    "descriptionLang":"en",
    "entityType":"Episode",
    "genres":[
      "Reality",
      "Romance"
    ],
    "longDescription":"Pastor Ken Johnson helps Shawn to find \"the one\"; a woman's secret lifestyle is discovered.",
    "shortDescription":"Pastor Ken Johnson helps Shawn to find \"the one\"; a woman's secret lifestyle is discovered.",
    "episodeNum":1,
    "seasonNum":1,
    "cast":[
      {
        "billingOrder":"01",
        "role":"Host",
        "name":"Ken Johnson"
      },
      {
        "billingOrder":"02",
        "role":"Contestant",
        "name":"Shawn Bullard"
      }
    ],
    "crew":[
      {
        "billingOrder":"01",
        "role":"Executive Producer",
        "name":"Andrew Glassman"
      },
      {
        "billingOrder":"02",
        "role":"Executive Producer",
        "name":"Jeff Gaspin"
      },
      {
        "billingOrder":"03",
        "role":"Executive Producer",
        "name":"Lauren Gellert"
      },
      {
        "billingOrder":"04",
        "role":"Executive Producer",
        "name":"Suzanne Murch"
      }
    ],
    "preferredImage":{
      "width":"240",
      "height":"360",
      "uri":"assets/p11392041_b_v5_aa.jpg",
      "category":"Banner-L1",
      "text":"yes",
      "primary":"true",
      "tier":"Series"
    }
  },
  {
    "tmsId":"EP012984510093",
    "rootId":"11369974",
    "seriesId":"8186015",
    "subType":"Series",
    "title":"Melissa & Joey",
    "episodeTitle":"Failure to Communicate",
    "origAirDate":"2015-02-04",
    "titleLang":"en",
    "descriptionLang":"en",
    "entityType":"Episode",
    "genres":[
      "Sitcom"
    ],
    "longDescription":"When Joe insists he can fix the family's ailing computer, Mel hires an expert to secretly repair the device in time for a birthday video chat with Ryder.",
    "shortDescription":"Mel hires an expert to repair the family's computer, despite Joe's claims he can fix the machine.",
    "episodeNum":4,
    "seasonNum":4,
    "cast":[
      {
        "billingOrder":"01",
        "role":"Actor",
        "name":"Melissa Joan Hart",
        "characterName":"Mel Burke"
      },
      {
        "billingOrder":"02",
        "role":"Actor",
        "name":"Joey Lawrence",
        "characterName":"Joe Longo"
      },
      {
        "billingOrder":"03",
        "role":"Actor",
        "name":"Taylor Spreitler",
        "characterName":"Lennox Scanlon"
      },
      {
        "billingOrder":"04",
        "role":"Actor",
        "name":"Nick Robinson",
        "characterName":"Ryder Scanlon"
      }
    ],
    "crew":[
      {
        "billingOrder":"01",
        "role":"Executive Producer",
        "name":"Bob Young"
      },
      {
        "billingOrder":"02",
        "role":"Executive Producer",
        "name":"David Kendall"
      },
      {
        "billingOrder":"03",
        "role":"Executive Producer",
        "name":"Paula Hart"
      },
      {
        "billingOrder":"04",
        "role":"Executive Producer",
        "name":"Melissa Joan Hart"
      },
      {
        "billingOrder":"05",
        "role":"Executive Producer",
        "name":"Joey Lawrence"
      }
    ],
    "ratings":[
      {
        "code":"TV14",
        "body":"USA Parental Rating"
      }
    ],
    "preferredImage":{
      "width":"240",
      "height":"360",
      "uri":"assets/p8186015_b_v5_ac.jpg",
      "category":"Banner-L1",
      "text":"yes",
      "primary":"true",
      "tier":"Series"
    }
  },
  ... additional programs ...
]