Celebrities

Celebrity airings

/celebs//airings

Returns up to 2 weeks of TV schedule information for a specified celebrity and channel lineup. Schedule information can be requested up to 14 days in advance. Response data will be sorted by airing dateTime.

Request Parameters

Parameter	Mandatory?	Description
personId	Yes	PersonId for specific celebrity; found in cast/crew metadata
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 14 days 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
Celebrity airings	Airing [ ]	Schedule and program information for celebrity event airings, up to a 24-hour period, on any station in specified lineup.

Sample Request

http://data.tmsapi.com/v1.1/celebs/1474/airings?lineupId=USA-NC32461-X&startDateTime=2012-08-11T12:00Z&api_key=1234567890

Sample Response


Code
 
[{
    "startTime": "2015-02-10T18:00Z",
    "endTime": "2015-02-10T19:00Z",
    "duration": 60,
    "qualifiers": ["Stereo", "HDTV", "CC"],
    "channels": ["634"],
    "program": {
        "tmsId": "EP006883590072",
        "rootId": "3056264",
        "seriesId": "185044",
        "subType": "Series",
        "title": "House",
        "episodeTitle": "Human Error",
        "releaseYear": 2007,
        "releaseDate": "2007-05-29",
        "origAirDate": "2007-05-29",
        "titleLang": "en",
        "descriptionLang": "en",
        "entityType": "Episode",
        "genres": ["Drama", "Mystery", "Medical"],
        "longDescription": "The team takes on the case of a woman who was rescued at sea en route from Cuba in her desperate bid to get a diagnosis from Dr. House.",
        "shortDescription": "A woman escapes from Cuba in order to get a diagnosis from House.",
        "episodeNum": 24,
        "seasonNum": 3,
        "topCast": ["Hugh Laurie", "Lisa Edelstein", "Omar Epps"],
        "preferredImage": {
            "width": "240",
            "height": "360",
            "uri": "assets/p185044_b_v5_aa.jpg",
            "category": "Banner-L1",
            "text": "yes",
            "primary": "true",
            "tier": "Series"
        }
    },
    "stationId": "34763",
    "station": {
        "stationId": "34763",
        "callSign": "UHD",
        "preferredImage": {
            "width": "360",
            "height": "270",
            "uri": "h3/NowShowing/34763/s34763_h3_aa.png",
            "category": "Logo",
            "primary": "true"
        },
        "channel": "634"
    }
}]

Last modified on November 13, 2025

Celebrities on talk shows by day Celebrity details

/celebs//airings

Request Parameters

Parameter

Mandatory?

Description

personId

Yes

PersonId for specific celebrity; found in cast/crew metadata

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 14 days 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

Celebrity airings

Airing [ ]

Schedule and program information for celebrity event airings, 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", "HDTV", "CC"],
    "channels": ["634"],
    "program": {
        "tmsId": "EP006883590072",
        "rootId": "3056264",
        "seriesId": "185044",
        "subType": "Series",
        "title": "House",
        "episodeTitle": "Human Error",
        "releaseYear": 2007,
        "releaseDate": "2007-05-29",
        "origAirDate": "2007-05-29",
        "titleLang": "en",
        "descriptionLang": "en",
        "entityType": "Episode",
        "genres": ["Drama", "Mystery", "Medical"],
        "longDescription": "The team takes on the case of a woman who was rescued at sea en route from Cuba in her desperate bid to get a diagnosis from Dr. House.",
        "shortDescription": "A woman escapes from Cuba in order to get a diagnosis from House.",
        "episodeNum": 24,
        "seasonNum": 3,
        "topCast": ["Hugh Laurie", "Lisa Edelstein", "Omar Epps"],
        "preferredImage": {
            "width": "240",
            "height": "360",
            "uri": "assets/p185044_b_v5_aa.jpg",
            "category": "Banner-L1",
            "text": "yes",
            "primary": "true",
            "tier": "Series"
        }
    },
    "stationId": "34763",
    "station": {
        "stationId": "34763",
        "callSign": "UHD",
        "preferredImage": {
            "width": "360",
            "height": "270",
            "uri": "h3/NowShowing/34763/s34763_h3_aa.png",
            "category": "Logo",
            "primary": "true"
        },
        "channel": "634"
    }
}]

Last modified on November 13, 2025