README
IMDb - API
The IMDb API allows developers to access a vast database of movie, TV show. It provides endpoints for searching and retrieving details about titles, as well as information about cast, episodes/seasons and more.
endpoints
GET /title/{titlename}
Example: /title/the%20walking%20dead
Response:
{
"status": 200,
"result": [
{
"_id": "tt1520211",
"title": "The Walking Dead",
"type": "TV show",
"poster": "https://m.media-amazon.com/images/M/MV5BNzI5MjUyYTEtMTljZC00NGI5LWFhNWYtYjY0ZTQ5YmEzMWRjXkEyXkFqcGdeQXVyMTY3MDE5MDY1._V1_QL75_UX3000.jpg",
"genres": [
"Drama",
"Horror",
"Thriller"
],
"creator": "Frank Darabont",
"producers": [
"American Movie Classics (AMC)",
"Circle of Confusion",
"Valhalla Motion Pictures"
],
"seasons": 11,
"episodes": 177,
"rating": "8.1/10",
"expiresAt": "2024-01-09T09:05:14.687Z"
},
{
"_id": "tt3743822",
"title": "Fear the Walking Dead",
"type": "TV show",
"poster": "https://m.media-amazon.com/images/M/MV5BZWQ2NGZhMTktMzJjZi00ZTNjLTljZjMtMzU0ODU1OWNhOTY1XkEyXkFqcGdeQXVyMTUzMTg2ODkz._V1_QL75_UX3000.jpg",
"genres": [
"Drama",
"Horror",
"Sci-Fi"
],
"creator": "Dave Erickson",
"producers": [
"American Movie Classics (AMC)",
"Circle of Confusion",
"Skybound Entertainment"
],
"seasons": 8,
"episodes": 113,
"rating": "6.8/10",
"expiresAt": "2024-01-09T09:05:17.080Z"
},
{
"_id": "tt13062500",
"title": "The Walking Dead: Daryl Dixon",
"type": "TV show",
"poster": "https://m.media-amazon.com/images/M/MV5BYmU2MGMyNzQtMmQ1Mi00ZjQ0LThhNDYtN2I3N2M4NTgyMDc3XkEyXkFqcGdeQXVyMTUzMTg2ODkz._V1_QL75_UX3000.jpg",
"genres": [
"Drama",
"Horror",
"Sci-Fi"
],
"creator": "David Zabel",
"producers": [],
"seasons": 2,
"episodes": 12,
"rating": "7.7/10",
"expiresAt": "2024-01-09T09:05:16.941Z"
},
loadmore - 3
}
GET /id/{imdb_id}
Example: /id/tt1520211
Response:
{
"status": 200,
"result": {
"_id": "tt1520211",
"title": "The Walking Dead",
"type": "TV show",
"poster": "https://m.media-amazon.com/images/M/MV5BNzI5MjUyYTEtMTljZC00NGI5LWFhNWYtYjY0ZTQ5YmEzMWRjXkEyXkFqcGdeQXVyMTY3MDE5MDY1._V1_QL75_UX3000.jpg",
"genres": [
"Drama",
"Horror",
"Thriller"
],
"creator": "Frank Darabont",
"producers": [
"American Movie Classics (AMC)",
"Circle of Confusion",
"Valhalla Motion Pictures"
],
"seasons": 11,
"episodes": 177,
"rating": "8.1/10",
"expiresAt": "2024-01-09T09:05:14.687Z"
}
}
GET /cast/{imdb_id}
Example: /cast/tt1520211
Response:
{
"status": 200,
"result": {
"_id": "tt1520211",
"cast": [
{
"name": "Norman Reedus",
"profile": "/name/nm0005342/?ref_=ttfc_fc_cl_t1",
"character": "Daryl Dixon",
"screentime": "175 episodes, 2010-2022"
},
{
"name": "Melissa McBride",
"profile": "/name/nm0564350/?ref_=ttfc_fc_cl_t2",
"character": "Carol Peletier",
"screentime": "174 episodes, 2010-2022"
},
{
"name": "Lauren Cohan",
"profile": "/name/nm1659348/?ref_=ttfc_fc_cl_t3",
"character": "Maggie Rhee",
"screentime": "144 episodes, 2011-2022"
},
{
"name": "Christian Serratos",
"profile": "/name/nm1589312/?ref_=ttfc_fc_cl_t4",
"character": "Rosita Espinosa",
"screentime": "130 episodes, 2014-2022"
},
{
"name": "Josh McDermitt",
"profile": "/name/nm3129311/?ref_=ttfc_fc_cl_t5",
"character": "Eugene Porter",
"screentime": "130 episodes, 2014-2022"
}
loadmore - 985
}
}
GET /episodes/{imdb_id}?season={season}
Example: /episodes/tt1520211?season=1
Response:
{
"status": 200,
"result": {
"_id": {
"imdb_id": "tt1520211",
"season": "1"
},
"episodes": [
{
"episode": "S1.E1 ∙ Days Gone Bye",
"overview": "Deputy Sheriff Rick Grimes awakens from a coma, and searches for his family in a world ravaged by the undead.",
"image": "https://m.media-amazon.com/images/M/MV5BMTYwMzIwODM3NF5BMl5BanBnXkFtZTcwNjE3MDQwNA@@._V1_QL75_UX3000.jpg",
"date": "Sun, Oct 31, 2010",
"rating": "9.2/10 (29K)"
},
{
"episode": "S1.E2 ∙ Guts",
"overview": "In Atlanta, Rick is rescued by a group of survivors, but they soon find themselves trapped inside a department store surrounded by walkers.",
"image": "https://m.media-amazon.com/images/M/MV5BMTgxNDQzNjQ2NV5BMl5BanBnXkFtZTcwODg2MDQwNA@@._V1_QL75_UX3000.jpg",
"date": "Sun, Nov 7, 2010",
"rating": "8.6/10 (18K)"
},
loadmore - 5
}
}
GET /storyline/{imdb_id}
Example: /storyline/tt1520211
Response:
{
"status": 200,
"result": {
"_id": "tt1520211",
"storyline": [
"Sheriff Deputy Rick Grimes wakes up from a coma to learn the world is in ruins and must lead a group of survivors to stay alive.",
"Sheriff Deputy Rick Grimes gets shot and falls into a zombie apocalypse. When awoken he finds himself in a Zombie Apocalypse. Not knowing what to do he sets out to find his family, after he's done that, he gets connected to a group to become the leader. He takes charge and tries to help this group of people survive, find a place to live and get them food. This show is all about survival, the risks and the things you'll have to do to survive.—jzirkle1",
"Sheriff Deputy Rick Grimes gets shot in combat and awakens to a zombie apocalypse. He meets a group on the outskirts of Atlanta and, soon, becomes their leader. The walkers (what they call zombies) feed on the living, so they try to move to different and safer locations to survive.",
"Rick Grimes was the sheriff at King County police office, until one day he and his partner Shane Walsh get a call about two men in a car with guns, during that call Rick gets shot and goes into a coma, he wakes up to a world where the dead come back to life.",
"Sherrif Deputy Rick Grimes has been shot. He falls into a coma and wakes up in a hospital, only to find that it is in ruins. He finds a group of survivors and adapts himself to the only survivors left in the city, then little did he know he soon becomes known as the leader. Sherrif Deputy Rick Grimes has to get the small group he attached himself to to safety, food and water. The only thing that stops them is the Walkers, also known as Zombies.",
"The Walking Dead, based on the comic book series written by Robert Kirkman and published by Image Comics, tells the story of the months and years that follow after a zombie apocalypse. It follows a group of survivors, led by police officer Rick Grimes, who travel in search of a safe and secure home. The comic goes on to explore the challenges of life in a world overrun by zombies who take a toll on the survivors, and sometimes the interpersonal conflicts present a greater danger to their continuing survival than the zombies that roam the country. Over time, the characters are changed by the constant exposure to death and some grow willing to do anything to survive. - Official AMC Publicity Description"
],
"expiresAt": "2024-01-09T09:20:18.178Z"
}
}
Node.js Example
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://imdb207.p.rapidapi.com/title/the%20walking%20dead',
headers: {
'X-RapidAPI-Key': 'api-key',
'X-RapidAPI-Host': 'imdb207.p.rapidapi.com'
}
};
try {
const response = await axios.request(options);
console.log(response.data);
} catch (error) {
console.error(error);
}
Followers: 0
API Creator:
SparrowXD
sparrowxdexe
Log In to Rate API
Rating: 5 - Votes: 1