@ifelix18/omdb

> [OMDb][omdb-link] API for userscripts

[![Version][version-badge]][jsdelivr-link]
[![Size][size-badge]][jsdelivr-link]
[![Minified Size][minified-size-badge]][jsdelivr-link]
[![Downloads][downloads-badge]][jsdelivr-link]
[![JavaScript Style Guide][style-guide-badge]][style-guide-link]
[![License][license-badge]][license-link]

Usage

$3

Include it in your script in the _Metadata Block_ via @require specifying the version, also specifying the required API to be granted (GM.getValue, GM.setValue, GM.xmlHttpRequest) via @grant, and the domain which can be allowed to be retrieved by GM.xmlHttpRequest via @connect, like this:

``JavaScript
// ...
// @require https://cdn.jsdelivr.net/npm/@ifelix18/omdb@4.0.0/lib/index.min.js
// @grant GM.getValue
// @grant GM.setValue
// @grant GM.xmlHttpRequest
// @connect omdbapi.com
// ...
`

Next, initialize the library:

`JavaScript
const omdb = new OMDb({
api_key: '', // - OMDb API Key [required]
api_url: 'https://www.omdbapi.com', // - OMDb API URL
debug: false, // - Debug
cache: { // Cache options
active: false, // - Cache status
time_to_live: 3600 // - Time to Live cache, in seconds
}
})
`

$3

#### Search by ID

> Returns infos related to a specific IMDb ID.

| Parameter | Required | Type | Description |
| --------- | -------- | ------- | ------------------------------------------ |
| id | Yes | string | IMDb ID |
| type | No | string | Type of result (movie, series, or episode) |
| year | No | number | Year of release |
| plot | No | string | Type of plot (short or full) |
| tomatoes | No | boolean | Include Rotten Tomatoes data |

`JavaScript
omdb.id({
id: 'tt0088763'
}).then((data) => {
console.log(data) //