# Movie & Series API

**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"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://santech.gitbook.io/docs/movie-and-series-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.