OMDb API

https://www.omdbapi.com/
Admin
The OMDb API is a RESTful web service that provides movie information, with all content and images...
Tokens:5,998
Snippets:42
Trust Score:9.5
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### GET /?s=

Source: https://www.omdbapi.com/

Search for movies by title. This endpoint returns a list of search results with pagination support.

```APIDOC
## GET http://www.omdbapi.com/?apikey=[yourkey]&

### Description
Search for movies by title. This endpoint returns a list of search results with pagination support.

### Method
GET

### Endpoint
http://www.omdbapi.com/?apikey=[yourkey]&

### Parameters
#### Query Parameters
- **s** (string) - Required - Movie title to search for.
- **type** (string) - Optional - Type of result to return. Valid options: movie, series, episode.
- **y** (string) - Optional - Year of release.
- **r** (string) - Optional - The data type to return. Valid options: json, xml. Default: json.
- **page** (integer) - Optional - Page number to return. Valid options: 1-100. Default: 1.
- **callback** (string) - Optional - JSONP callback name.
- **v** (string) - Optional - API version (reserved for future use). Default: 1.

### Response
Response format depends on the `r` parameter (json or xml). The response includes a list of search results with fields such as Title, Year, imdbID, Type, and Poster, along with totalResults and Response status.

```

--------------------------------

### GET /

Source: https://www.omdbapi.com/

Search for movies by title or ID. This endpoint retrieves detailed movie information based on either an IMDb ID or a movie title.

```APIDOC
## GET http://www.omdbapi.com/?apikey=[yourkey]& 

### Description
Retrieve movie information by IMDb ID or title. At least one of the `i` or `t` parameters is required.

### Method
GET

### Endpoint
http://www.omdbapi.com/?apikey=[yourkey]&

### Parameters
#### Query Parameters
- **i** (string) - Optional* - A valid IMDb ID (e.g. tt1285016).
- **t** (string) - Optional* - Movie title to search for.
- **type** (string) - Optional - Type of result to return. Valid options: movie, series, episode.
- **y** (string) - Optional - Year of release.
- **plot** (string) - Optional - Return short or full plot. Valid options: short, full. Default: short.
- **r** (string) - Optional - The data type to return. Valid options: json, xml. Default: json.
- **callback** (string) - Optional - JSONP callback name.
- **v** (string) - Optional - API version (reserved for future use). Default: 1.

*Note: While both "i" and "t" are optional, at least one argument is required.

### Response
Response format depends on the `r` parameter (json or xml). The response includes movie information fields such as title, year, rated, released, runtime, genre, director, writer, actors, plot, language, country, awards, poster, ratings, metascore, imdbRating, imdbVotes, imdbID, type, DVD, boxOffice, production, website, and response status.

```

--------------------------------

### Base API request URL

Source: https://www.omdbapi.com/

Send all data requests to this URL with your API key.

```http
http://www.omdbapi.com/?apikey=[yourkey]&
```

--------------------------------

### Poster API request URL

Source: https://www.omdbapi.com/

Poster API requests are sent to this URL with your API key. Available only to patrons.

```http
http://img.omdbapi.com/?apikey=[yourkey]&
```
Tokens:
Raw