-
Notifications
You must be signed in to change notification settings - Fork 5
API 20141201 Celebrity metadata
Robert Kulagowski edited this page Aug 8, 2025
·
3 revisions
Your code must be able to process UTF-8 characters.
You can obtain additional information about a celebrity by accessing the celebrity endpoint:
GET https://json.schedulesdirect.org/20141201/celebrity/{personId}
Token: Required
For example:
GET https://json.schedulesdirect.org/20141201/celebrity/68293
Response:
{
"personId": "68293",
"updateDate": "2025-01-07T04:25:21Z",
"type": "Person",
"gender": "Female",
"birthPlace": "Honolulu, Hawaii, USA",
"birthDate": "1967-03-16",
"names": [
{
"firstName": "Lauren",
"lastName": "Graham",
"isPrimary": true,
"nameId": "68293"
}
],
"mediography": [
{
"programID": "MV008961210000",
"title": "Joshy",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Katee"
}
],
"year": "2016"
},
{
"programID": "MV001923680000",
"title": "Evan Almighty",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Joan Baxter"
}
],
"year": "2007"
},
{
"programID": "MV004013250000",
"title": "The Life Coach",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Dr. Sue Pegasus"
}
],
"year": "2005"
},
{
"programID": "MV000623130000",
"title": "One True Thing",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Jules"
}
],
"year": "1998"
},
{
"programID": "MV000584290000",
"title": "Nightwatch",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Marie"
}
],
"year": "1998"
},
{
"programID": "MV001555950000",
"title": "The Pacifier",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Principal Claire"
}
],
"year": "2005"
},
{
"programID": "MV006404640000",
"title": "Max",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Pamela"
}
],
"year": "2015"
},
{
"programID": "MV002464230000",
"title": "Cloudy With a Chance of Meatballs",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Voice",
"characterName": "Fran Lockwood"
}
],
"year": "2009"
},
{
"programID": "MV000805540000",
"title": "Confessions of a Sexist Pig",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Tracy"
}
],
"year": "1998"
},
{
"programID": "MV022366040000",
"title": "The Best Christmas Pageant Ever",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Adult Beth"
}
],
"year": "2024"
},
{
"programID": "MV001482880000",
"title": "Seeing Other People",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Claire"
}
],
"year": "2004"
},
{
"programID": "MV002166000000",
"title": "Birds of America",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Betty Tanager"
}
],
"year": "2008"
},
{
"programID": "MV001811280000",
"title": "Because I Said So",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Maggie"
}
],
"year": "2007"
},
{
"programID": "MV002231510000",
"title": "Flash of Genius",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Phyllis Kearns"
}
],
"year": "2008"
},
{
"programID": "MV002459690000",
"title": "The Answer Man",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Elizabeth"
}
],
"year": "2009"
},
{
"programID": "MV006358390000",
"title": "A Merry Friggin' Christmas",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Luann Mitchler"
}
],
"year": "2014"
},
{
"programID": "MV000767850000",
"title": "Dill Scallion",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Kristie Sue"
}
],
"year": "1999"
},
{
"programID": "MV002812660000",
"title": "It's Kind of a Funny Story",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Lynn"
}
],
"year": "2010"
},
{
"programID": "MV001807330000",
"title": "The Moguls",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Peggy"
}
],
"year": "2005"
},
{
"programID": "MV001411120000",
"title": "Bad Santa",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Sue"
}
],
"year": "2003"
},
{
"programID": "MV001037580000",
"title": "Sweet November",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Angelica"
}
],
"year": "2001"
},
{
"programID": "MV001054130000",
"title": "Chasing Destiny",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Jessy James"
}
],
"year": "2000"
},
{
"programID": "MV001893080000",
"title": "Lucky 13",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Abbey"
}
],
"year": "2005"
},
{
"programID": "MV008600720000",
"title": "Middle School: The Worst Years of My Life",
"programTitleLanguage": "en",
"programType": "Movie",
"credits": [
{
"role": "Actor",
"characterName": "Jules"
}
],
"year": "2016"
}
],
"awards": [
{
"awardName": "Screen Actors Guild Awards",
"awardCategory": "Outstanding Performance by a Female Actor in a Drama Series",
"awardYear": "2001",
"wonAward": true
}
],
"images": [
{
"width": "135",
"height": "180",
"uri": "e53fb7db63d15a6ab32df864205a1d2e407906cffc2e5688db2ff9971d34e328.jpg",
"ratio": "3:4",
"aspect": "3x4",
"category": "Photo - headshot",
"lastUpdate": "2022-10-12T17:06:56Z"
},
{
"width": "270",
"height": "360",
"uri": "bb89e3c58395a8e98e1b62f241a39bd36e41dabf4224564739c402d5a0e3ada3.jpg",
"ratio": "3:4",
"aspect": "3x4",
"category": "Photo - headshot",
"lastUpdate": "2022-10-12T17:06:56Z"
},
{
"width": "540",
"height": "720",
"uri": "95bc1a2960f437c4271a9084c297a6172ea8673daa1efe4cff929d2f5635b487.jpg",
"ratio": "3:4",
"aspect": "3x4",
"category": "Photo - headshot",
"lastUpdate": "2022-10-12T17:06:56Z"
}
]
}
If you make a request like this:
GET https://json.schedulesdirect.org/20141201/celebrity/68923/
And the response is:
{
"response": "INCORRECT_REQUEST",
"code": 1008,
"serverID": "20141201.web.1",
"message": "The request is improperly formatted.",
"datetime": "2025-01-14T23:31:49Z"
}
Then your request is incorrectly formatted; check to ensure that you don't have a trailing slash after the personId.
If your request is:
GET https://json.schedulesdirect.org/20141201/celebrity/1
And the response is:
{
"response": "INVALID_PERSONID",
"code": 2109,
"serverID": "20141201.web.1",
"message": "Could not find personId:1",
"datetime": "2025-01-14T23:34:50Z"
}
Then there is no data for that personId; the error message will indicate which personId you requested; in this case the data for personId "1" isn't available on the server.
personId: stringified number. Mandatory. Do not convert this to an integer.
updateDate: The date that the record was updated. Mandatory.
type: string. [Group|Other|Person]. Mandatory.
gender: [Male|Female|Non-Binary]. Optional.
birthPlace: string. Optional.
birthDate: string. Optional.
deathDate: string. Optional.
deathPlace: string. Optional.
deathCause: string. Optional.
names: array containing names that this person is known as. Mandatory to have at least one entry. Each name element consists of the following fields:
- firstName: string. Mandatory.
- middleName: string. Optional.
- lastName: string. Optional.
- namePrefix: string. Optional.
- nameSuffix: string. Optional.
- nameLanguage: string. Optional.
- isPrimary: boolean. Optional.
- nameId: stringified number. Mandatory. One personId may have multiple nameIds. See personId 314 ("Cher") as an example. Do not convert this to an integer.
mediography: array containing the programs that this person has been in. Optional. Each mediography element consists of the following fields:
- programID: string, 14 characters. Mandatory.
- title: string. Mandatory.
- programTitleLanguage: string.
- programType: string. Optional. [Movie|Show]
- credits: array containing the credits for this particular mediography element. Each credit element consists of the following fields:
- role: string. Mandatory.
- characterName: string. Optional.
- year: string. The year of this mediography element. Optional.
awards: array containing awards that this person has been nominated for / won. Optional. Each awards element consists of the following fields:
- awardName: string. Mandatory.
- awardCategory: string. Mandatory.
- awardYear: string. Mandatory.
- wonAward: boolean. Mandatory.
images: array containing images for this celebrity. Optional. Each image element consists of the following fields:
- width: stringified number. Mandatory.
- height: stringified number. Mandatory.
- uri: string. Mandatory.
- ratio: string. Mandatory.
- aspect: string. Mandatory.
- category: string. Mandatory.
- lastUpdate: string. Mandatory.