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 ...
]