Movie & Series API

API to fetch movies and series details : titles and ratings

Movies & Series API Documentation

A Movie & Series API is like a personal movie concierge, providing you with a treasure trove of information about films and TV shows. It helps you discover new releases, find showtimes, and even build movie-related apps, making your movie experience richer and more enjoyable. Think of it as your go-to guide for all things movies and series!

Base URL

https://santechapi.vercel.app

Authentication

headers : {
"token" : {YOUR API KEY}
}

Endpoint: /movieandseries/movie/{:q}

Parameters:

• {q}: Random input text from the user

Example request:

GET /movieandseries/movie/John Q

Example Response:

400

{
	"Title": "John Q",
	"Year": "2002",
	"Rated": "PG-13",
	"Released": "15 Feb 2002",
	"Runtime": "116 min",
	"Genre": "Crime, Drama, Thriller",
	"Director": "Nick Cassavetes",
	"Writer": "James Kearns",
	"Actors": "Denzel Washington, Robert Duvall, Gabriela Oltean",
	"Plot": "John Quincy Archibald takes a hospital emergency room hostage when his insurance won't cover his son's heart transplant.",
	"Language": "English, Spanish",
	"Country": "United States",
	"Awards": "2 wins & 8 nominations",
	"Poster": "https://m.media-amazon.com/images/M/MV5BMTcxNTQ1MzAyOF5BMl5BanBnXkFtZTYwNDg0ODk4._V1_SX300.jpg",
	"Ratings": [
		{
			"Source": "Internet Movie Database",
			"Value": "7.1/10"
		},
		{
			"Source": "Rotten Tomatoes",
			"Value": "26%"
		},
		{
			"Source": "Metacritic",
			"Value": "30/100"
		}
	],
	"Metascore": "30",
	"imdbRating": "7.1",
	"imdbVotes": "145,309",
	"imdbID": "tt0251160",
	"Type": "movie",
	"DVD": "N/A",
	"BoxOffice": "$71,756,802",
	"Production": "N/A",
	"Website": "N/A",
	"Response": "True"
}

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

402

 {
message: "Movie Not Found"
}

Endpoint: /movieandseries/series/{:q}

HTTP Method: Get

Example request:

GET /movieandseries/series/Harry Potter

Example Response:

{
	"Title": "Harry Potter and the Deathly Hallows: Part 2",
	"Year": "2011",
	"Rated": "PG-13",
	"Released": "15 Jul 2011",
	"Runtime": "130 min",
	"Genre": "Adventure, Family, Fantasy",
	"Director": "David Yates",
	"Writer": "Steve Kloves, J.K. Rowling",
	"Actors": "Daniel Radcliffe, Emma Watson, Rupert Grint",
	"Plot": "Harry, Ron, and Hermione search for Voldemort's remaining Horcruxes in their effort to destroy the Dark Lord as the final battle rages on at Hogwarts.",
	"Language": "English, Latin",
	"Country": "United Kingdom, United States",
	"Awards": "Nominated for 3 Oscars. 49 wins & 95 nominations total",
	"Poster": "https://m.media-amazon.com/images/M/MV5BOTA1Mzc2N2ItZWRiNS00MjQzLTlmZDQtMjU0NmY1YWRkMGQ4XkEyXkFqcGc@._V1_SX300.jpg",
	"Ratings": [
		{
			"Source": "Internet Movie Database",
			"Value": "8.1/10"
		},
		{
			"Source": "Rotten Tomatoes",
			"Value": "96%"
		},
		{
			"Source": "Metacritic",
			"Value": "85/100"
		}
	],
	"Metascore": "85",
	"imdbRating": "8.1",
	"imdbVotes": "965,522",
	"imdbID": "tt1201607",
	"Type": "movie",
	"DVD": "N/A",
	"BoxOffice": "$381,447,587",
	"Production": "N/A",
	"Website": "N/A",
	"Response": "True"
}pl

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

402

 {
message: "Series Not Found"
}