Celebrities

Celebrities on talk shows by day

/celebs/talkShowAirings

Returns TV schedule information for talk shows with celebrity guests. Schedule information can be requested up to 14 days in advance, for a maximum period of 24 hours from start date. Response data will be sorted by airing dateTime.

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.
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 start dateTime.
imageSize	No	Valid values are: Sm, Md, Lg, Ms. 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.
api_key	Yes	24-character key obtained during application registration

Response Body

Response	Type	Description
Program airings	Airing [ ]	Schedule and program information for talk shows with celebrity guests, up to a 24-hour period, on any station in specified lineup.

Sample Request

http://data.tmsapi.com/v1/celebs/talkShowAirings?lineupId=USA-TX42500-X&startDateTime=2015-02-09T16:00Z&api_key=1234567890

Sample Response


Code
 
[{
    "startTime": "2015-02-10T18:00Z",
    "endTime": "2015-02-10T19:00Z",
    "duration": 60,
    "qualifiers": ["Stereo", "CC"],
    "channels": ["173"],
    "ratings": [{
        "body": "FCC-TVPG (USA)",
        "code": "TV-14"
    }],
    "program": {
        "tmsId": "EP005178511599",
        "rootId": "8568922",
        "seriesId": "184963",
        "subType": "Series",
        "title": "Dr. Phil",
        "episodeTitle": "Mini Mean Girls",
        "releaseYear": 2011,
        "releaseDate": "2011",
        "origAirDate": "2011-03-10",
        "titleLang": "en",
        "descriptionLang": "en",
        "entityType": "Episode",
        "genres": ["Talk"],
        "longDescription": "\"Mean Girls 2\" stars Maiara Walsh and Meaghan Martin discuss children's bullying and how to empower young women.",
        "shortDescription": "\"Mean Girls 2\" stars Maiara Walsh and Meaghan Martin discuss children and bullying.",
        "guests": [{
            "billingOrder": "02",
            "role": "Guest",
            "name": "Maiara Walsh"
        }, {
            "billingOrder": "03",
            "role": "Guest",
            "name": "Meaghan Martin"
        }],
        "preferredImage": {
            "width": "240",
            "height": "360",
            "uri": "assets/p184963_b_v5_aa.jpg",
            "category": "Banner-L1",
            "text": "yes",
            "primary": "true",
            "tier": "Series"
        }
    },
    "stationId": "70387",
    "station": {
        "stationId": "70387",
        "callSign": "OWN",
        "preferredImage": {
            "width": "360",
            "height": "270",
            "uri": "h3/NowShowing/70387/s70387_h3_aa.png",
            "category": "Logo",
            "primary": "true"
        },
        "channel": "173"
    }
}]

Last modified on November 13, 2025

Celebrities Celebrity airings

/celebs/talkShowAirings

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.

endDateTime

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 start dateTime.

imageSize

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

imageAspectTV

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.

api_key

Yes

24-character key obtained during application registration

Response Body

Response

Type

Description

Program airings

Airing [ ]

Schedule and program information for talk shows with celebrity guests, up to a 24-hour period, on any station in specified lineup.

Sample Request

Sample Response

Code

[{
    "startTime": "2015-02-10T18:00Z",
    "endTime": "2015-02-10T19:00Z",
    "duration": 60,
    "qualifiers": ["Stereo", "CC"],
    "channels": ["173"],
    "ratings": [{
        "body": "FCC-TVPG (USA)",
        "code": "TV-14"
    }],
    "program": {
        "tmsId": "EP005178511599",
        "rootId": "8568922",
        "seriesId": "184963",
        "subType": "Series",
        "title": "Dr. Phil",
        "episodeTitle": "Mini Mean Girls",
        "releaseYear": 2011,
        "releaseDate": "2011",
        "origAirDate": "2011-03-10",
        "titleLang": "en",
        "descriptionLang": "en",
        "entityType": "Episode",
        "genres": ["Talk"],
        "longDescription": "\"Mean Girls 2\" stars Maiara Walsh and Meaghan Martin discuss children's bullying and how to empower young women.",
        "shortDescription": "\"Mean Girls 2\" stars Maiara Walsh and Meaghan Martin discuss children and bullying.",
        "guests": [{
            "billingOrder": "02",
            "role": "Guest",
            "name": "Maiara Walsh"
        }, {
            "billingOrder": "03",
            "role": "Guest",
            "name": "Meaghan Martin"
        }],
        "preferredImage": {
            "width": "240",
            "height": "360",
            "uri": "assets/p184963_b_v5_aa.jpg",
            "category": "Banner-L1",
            "text": "yes",
            "primary": "true",
            "tier": "Series"
        }
    },
    "stationId": "70387",
    "station": {
        "stationId": "70387",
        "callSign": "OWN",
        "preferredImage": {
            "width": "360",
            "height": "270",
            "uri": "h3/NowShowing/70387/s70387_h3_aa.png",
            "category": "Logo",
            "primary": "true"
        },
        "channel": "173"
    }
}]

Last modified on November 13, 2025