People Information
Person
Use this API to get all available meta data including any images for the requested person.
| End Point | http://api.digiguide.tv/1.2/tv/person/ |
| Supported Responses | JSON |
| Supported Methods | GET |
| URI Scheme | Either HTTP or HTTPS requests are supported. |
| User Authentication | Optional If the user is not subscribed to any Digiguide services then the dateOfBirth, dateOfDeath, gender and description properties are not returned. |
Required Parameters
| appid=<yourappid> | Your unique and secret Application ID |
One of the following parameters are also required: |
|
| id=<unsigned integer> | Valid person ID as returned from the "Programme" API. |
| Or | |
| name=<string> | Valid person name as returned from the "Programme" API. |
Successful Response
{
"success" : true,
"person" : {
"name" : "Brad Pitt",
"dateOfBirth" : "December 18, 1963",
"description" : "William Bradley \"Brad\" Pitt, an American actor and film producer; was born in Shawnee, Oklahoma, and is the son of Jane Etta (née Hillhouse), a high school counselor, and William Alvin Pitt, a truck company owner.\r\n\r\nBorn into a conservative household, he was raised as Southern Baptist, although he has since described himself as oscillating between atheism and agnosticism. Pitt has stated that his family's ancestry consists of \"probably... Irish-Scots-Germans who settled in the area... I know we have some Seminole, and some Cherokee Indian, in us\".\r\n\r\nThe family moved to Springfield, Missouri, where he lived together with his younger siblings, Doug (born 1966) and Julie Neal (born 1969). Pitt has described Springfield as \"Mark Twain country, Jesse James country\", having grown up with \"a lot of hills, a lot of lakes\".\r\n\r\nPitt attended Kickapoo High School, where he was a member of the golf, swimming, tennis, and wrestling teams. He participated in the school's Key and Forensics clubs, in school debates, and in musicals.\r\n\r\nFollowing his graduation from high school, Pitt enrolled in the University of Missouri in 1982, majoring in journalism with a focus on advertising. As a member of the Sigma Chi fraternity, he acted in several fraternity shows. As graduation approached, Pitt did not feel ready to settle down. He loved films - \"a portal into different worlds for me\" - and, since films were not made in Missouri, he decided to go to where they were made. Two weeks before earning his degree, Pitt left the university and moved to Los Angeles, where he took acting lessons and worked odd jobs.\r\n\r\nPitt has since received four Academy Award nominations and five Golden Globe Award nominations, winning one Golden Globe and has been described as one of the world's most attractive men, a label for which he has received substantial media attention.",
"gender" : "male",
"id" : 3791,
"imageMain" :
{
"url" : "http://i.digiguide.tv/p/0808/3791-BradPitt-12198307230.jpg",
"height" : 350,
"width" : 262
},
"imageThumb" : {
"url" : "http://i.digiguide.tv/p/0808/tn-3791-BradPitt-12198307230.jpg",
"height" : 150,
"width" : 150
},
"imageTinyThumb" : {
"url" : "http://i.digiguide.tv/p/0808/ttn-3791-BradPitt-12198307230.jpg",
"height" : 75,
"width" : 75
}
}
}
Person Images
Use this API to get an image for a specific person, if there is one.
| End Point | http://api.digiguide.tv/1.2/tv/personimage/ |
| Supported Responses | JSON |
| Supported Methods | GET |
| URI Scheme | Either HTTP or HTTPS requests are supported. |
| User Authentication | None |
Required Parameters
| appid=<yourappid> | Your unique and secret Application ID |
| id=<unsigned int> | Valid person ID as returned by "Person", "Programme" or "Search" APIs. |
Successful Response
{
"success": true,
"image": {
"imageMain": {
"url": "http:\/\/i.digiguide.tv\/p\/0808\/3791-BradPitt-12198307230.jpg",
"width": 262,
"height": 350
},
"imageThumb": {
"url": "http:\/\/i.digiguide.tv\/p\/0907\/\/tn-3791-BradPitt-12198307230.jpg",
"width": 150,
"height": 150
},
"imageTinyThumb": {
"url": "http:\/\/i.digiguide.tv\/p\/0907\/\/ttn-3791-BradPitt-12198307230.jpg",
"width": 75,
"height": 75
}
}
}