crawlora-imdb 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +39 -2
- data/lib/crawlora/imdb/client.rb +26 -4
- data/lib/crawlora/imdb/version.rb +1 -1
- metadata +6 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: b7ada8664197141873fce12ec9f8d4eea2b2d17ac93cd238e32c23a948971f21
|
|
4
|
+
data.tar.gz: d316ea422ab090b00a8c0322631b79d1648f648b0015437253dd75a69448845d
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 045747fbfe332fc37b0058171cef28654912cf1c366726d41a9cd74767757ce19fb442652481744995ff31d364d3661259395e822c69282b80ae91d93d923afa
|
|
7
|
+
data.tar.gz: 2f11d18cb6225adbf82f81f9fbb6fd9916108caa51daf06694aa98da4b53b4a39747c55cf8d0d205cb549a1e88ac8d3f604e51464b07729f2aa93b7c39757a6f
|
data/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# Crawlora IMDb Ruby
|
|
1
|
+
# Crawlora IMDb API client for Ruby (`crawlora-imdb`)
|
|
2
2
|
|
|
3
|
-
This gem calls
|
|
3
|
+
This Ruby gem calls Crawlora's hosted IMDb API at `https://api.crawlora.net/api/v1`. It exposes 30 endpoints covering title and name search, charts, ratings, credits, awards, episodes, reviews, images, and title metadata; it does not call or scrape IMDb directly. Requests require your Crawlora API key and use your account's service plan.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
@@ -30,4 +30,41 @@ client.close
|
|
|
30
30
|
|
|
31
31
|
Client options include `api_key`, `base_url`, and `timeout`. Ruby stdlib provides the HTTP and JSON support.
|
|
32
32
|
|
|
33
|
+
## Supported IMDb API endpoints
|
|
34
|
+
|
|
35
|
+
Browse every route included in this gem. The [endpoint reference](https://github.com/Crawlora-org/crawlora-imdb/blob/main/docs/usage.md) includes parameter and response details.
|
|
36
|
+
|
|
37
|
+
| Method | Endpoint | API operation | Description |
|
|
38
|
+
| --- | --- | --- | --- |
|
|
39
|
+
| `GET` | `/imdb/charts` | `imdb-charts` | IMDb title charts |
|
|
40
|
+
| `GET` | `/imdb/image-types` | `imdb-image-types` | IMDb image types |
|
|
41
|
+
| `GET` | `/imdb/name` | `imdb-name` | IMDb name detail |
|
|
42
|
+
| `GET` | `/imdb/name/awards` | `imdb-name-awards` | IMDb name awards |
|
|
43
|
+
| `GET` | `/imdb/name/credits` | `imdb-name-credits` | IMDb name credits |
|
|
44
|
+
| `GET` | `/imdb/name/images` | `imdb-name-images` | IMDb name images |
|
|
45
|
+
| `GET` | `/imdb/name/videos` | `imdb-name-videos` | IMDb name video metadata |
|
|
46
|
+
| `GET` | `/imdb/search` | `imdb-search` | IMDb title search |
|
|
47
|
+
| `GET` | `/imdb/search/title` | `imdb-search-title` | IMDb advanced title search |
|
|
48
|
+
| `GET` | `/imdb/title` | `imdb-title` | IMDb title detail |
|
|
49
|
+
| `GET` | `/imdb/title/awards` | `imdb-title-awards` | IMDb title awards |
|
|
50
|
+
| `GET` | `/imdb/title/box-office` | `imdb-title-box-office` | IMDb title box office summary |
|
|
51
|
+
| `GET` | `/imdb/title/company-credits` | `imdb-title-company-credits` | IMDb title company credits |
|
|
52
|
+
| `GET` | `/imdb/title/connections` | `imdb-title-connections` | IMDb title connections |
|
|
53
|
+
| `GET` | `/imdb/title/credits` | `imdb-title-credits` | IMDb title credits |
|
|
54
|
+
| `GET` | `/imdb/title/episodes` | `imdb-title-episodes` | IMDb title episodes |
|
|
55
|
+
| `GET` | `/imdb/title/filming-locations` | `imdb-title-filming-locations` | IMDb title filming locations |
|
|
56
|
+
| `GET` | `/imdb/title/goofs` | `imdb-title-goofs` | IMDb title goofs |
|
|
57
|
+
| `GET` | `/imdb/title/images` | `imdb-title-images` | IMDb title images |
|
|
58
|
+
| `GET` | `/imdb/title/keywords` | `imdb-title-keywords` | IMDb title keywords |
|
|
59
|
+
| `GET` | `/imdb/title/parental-guide` | `imdb-title-parental-guide` | IMDb title parental guide |
|
|
60
|
+
| `GET` | `/imdb/title/public-facts-analysis` | `imdb-title-public-facts-analysis` | IMDb title public facts analysis |
|
|
61
|
+
| `GET` | `/imdb/title/quotes` | `imdb-title-quotes` | IMDb title quotes |
|
|
62
|
+
| `GET` | `/imdb/title/ratings` | `imdb-title-ratings` | IMDb title ratings breakdown |
|
|
63
|
+
| `GET` | `/imdb/title/release-info` | `imdb-title-release-info` | IMDb title release info |
|
|
64
|
+
| `GET` | `/imdb/title/reviews` | `imdb-title-reviews` | IMDb title user reviews |
|
|
65
|
+
| `GET` | `/imdb/title/similar` | `imdb-title-similar` | IMDb similar titles |
|
|
66
|
+
| `GET` | `/imdb/title/technical-specs` | `imdb-title-technical-specs` | IMDb title technical specs |
|
|
67
|
+
| `GET` | `/imdb/title/trivia` | `imdb-title-trivia` | IMDb title trivia |
|
|
68
|
+
| `GET` | `/imdb/title/videos` | `imdb-title-videos` | IMDb title video metadata |
|
|
69
|
+
|
|
33
70
|
See [Crawlora](https://crawlora.net/?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=imdb-ruby-homepage), the [API documentation](https://crawlora.net/docs?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=imdb-ruby-api-docs), and [the package repository](https://github.com/Crawlora-org/crawlora-imdb) for account setup, the API operation reference, and release history.
|
data/lib/crawlora/imdb/client.rb
CHANGED
|
@@ -19,7 +19,7 @@ module Crawlora
|
|
|
19
19
|
end
|
|
20
20
|
|
|
21
21
|
OPERATIONS = JSON.parse(<<~'JSON').freeze
|
|
22
|
-
{"imdb-charts": {"id": "imdb-charts", "method": "GET", "params": [{"default": "top_rated_movies", "description": "IMDb chart", "enum": ["top_rated_movies", "top_rated_tv_shows", "most_popular_movies", "most_popular_tv_shows", "top_rated_english_movies", "lowest_rated_movies"], "in": "query", "name": "chart", "type": "string"}, {"default": 25, "description": "Rows to return, default 25, max 250", "in": "query", "name": "limit", "type": "integer"}], "path": "/imdb/charts", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["top_rated_movies", "top_rated_tv_shows", "most_popular_movies", "most_popular_tv_shows", "top_rated_english_movies", "lowest_rated_movies"], "in": "query", "name": "chart", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-image-types": {"id": "imdb-image-types", "method": "GET", "params": [], "path": "/imdb/image-types", "pathParams": [], "produces": ["application/json"], "queryParams": [], "security": ["ApiKeyAuth"]}, "imdb-name": {"id": "imdb-name", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0634240"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0634240/"}], "path": "/imdb/name", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-name-awards": {"id": "imdb-name-awards", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0634240"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0634240/"}], "path": "/imdb/name/awards", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-name-credits": {"id": "imdb-name-credits", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0634240"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0634240/"}], "path": "/imdb/name/credits", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-name-images": {"id": "imdb-name-images", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0000151"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0000151/"}, {"description": "Image type filter, single value or comma-separated list", "enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string", "x-example": "still_frame"}, {"description": "Rows to return, default 50, max 1000", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/name/images", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-name-videos": {"id": "imdb-name-videos", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0000151"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0000151/"}, {"description": "Rows to return, default 50, max 100", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/name/videos", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-search": {"id": "imdb-search", "method": "GET", "params": [{"description": "Search query", "in": "query", "name": "query", "required": true, "type": "string", "x-example": "inception"}, {"description": "Rows to return, default 10, max 20", "in": "query", "name": "limit", "type": "integer", "x-example": 10}], "path": "/imdb/search", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "query", "required": true, "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-search-title": {"id": "imdb-search-title", "method": "GET", "params": [{"description": "Title-name substring match", "in": "query", "name": "title", "type": "string", "x-example": "matrix"}, {"description": "Comma-separated title types: `feature`, `tvSeries`, `short`, `tvEpisode`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `tvShort`, `videoGame`, `video`, `musicVideo`, `podcastSeries`, `podcastEpisode`", "in": "query", "name": "title_type", "type": "string", "x-example": "feature"}, {"description": "Comma-separated genres (include-only): `Action`, `Adventure`, `Animation`, `Biography`, `Comedy`, `Crime`, `Documentary`, `Drama`, `Family`, `Fantasy`, `Film-Noir`, `Game-Show`, `History`, `Horror`, `Music`, `Musical`, `Mystery`, `News`, `Reality-TV`, `Romance`, `Sci-Fi`, `Short`, `Sport`, `Talk-Show`, `Thriller`, `War`, `Western`", "in": "query", "name": "genres", "type": "string", "x-example": "Action,Adventure"}, {"description": "Release date lower bound: YYYY, YYYY-MM, or YYYY-MM-DD", "in": "query", "name": "release_date_from", "type": "string", "x-example": "2020-01-01"}, {"description": "Release date upper bound: YYYY, YYYY-MM, or YYYY-MM-DD", "in": "query", "name": "release_date_to", "type": "string", "x-example": "2021-12-31"}, {"description": "Minimum IMDb user rating, 0-10", "in": "query", "name": "min_user_rating", "type": "number", "x-example": 7}, {"description": "Maximum IMDb user rating, 0-10", "in": "query", "name": "max_user_rating", "type": "number", "x-example": 9.5}, {"description": "Minimum number of user rating votes", "in": "query", "name": "min_votes", "type": "integer", "x-example": 25000}, {"description": "Maximum number of user rating votes", "in": "query", "name": "max_votes", "type": "integer"}, {"description": "Minimum IMDb popularity rank (1 is most popular)", "in": "query", "name": "min_popularity", "type": "integer"}, {"description": "Maximum IMDb popularity rank", "in": "query", "name": "max_popularity", "type": "integer"}, {"description": "Minimum runtime in minutes", "in": "query", "name": "min_runtime", "type": "integer"}, {"description": "Maximum runtime in minutes", "in": "query", "name": "max_runtime", "type": "integer"}, {"description": "Comma-separated awards/curated-list groups: `oscar_winner`, `oscar_nominee`, `emmy_winner`, `emmy_nominee`, `golden_globe_winner`, `golden_globe_nominee`, `best_picture_winner`, `best_director_winner`, `razzie_winner`, `razzie_nominee`, `top_100`, `top_250`, `top_1000`, `bottom_100`, `bottom_250`, `bottom_1000`", "in": "query", "name": "groups", "type": "string"}, {"description": "Comma-separated plot keywords", "in": "query", "name": "keywords", "type": "string", "x-example": "superhero"}, {"description": "Comma-separated IMDb company ids, format `co########`", "in": "query", "name": "companies", "type": "string", "x-example": "co0000756"}, {"description": "Comma-separated `COUNTRY:RATING` certificate pairs, e.g. `US:PG-13`", "in": "query", "name": "certificates", "type": "string", "x-example": "US:PG-13"}, {"description": "Comma-separated color info: `color`, `black_and_white`, `colorized`, `aces`", "in": "query", "name": "colors", "type": "string"}, {"description": "Comma-separated ISO country codes", "in": "query", "name": "countries", "type": "string", "x-example": "US"}, {"description": "Comma-separated ISO language codes", "in": "query", "name": "languages", "type": "string", "x-example": "en"}, {"description": "Comma-separated sound mix names: `12-Track Digital Sound`, `3 Channel Stereo`, `4-Track Stereo`, `6-Track Stereo`, `70 mm 6-Track`, `AGA Sound System`, `Auro 11.1`, `CDS`, `Chronophone`, `Cinematophone`, `Cinephone`, `Cinerama 7-Track`, `Cinesound`, `D-Cinema 48kHz 5.1`, `Datasat`, `De Forest Phonofilm`, `Digitrac Digital Audio System`, `Dolby`, `Dolby Atmos`, `Dolby Digital`, `Dolby Digital EX`, `Dolby SR`, `Dolby Stereo`, `Dolby Surround 7.1`, `DTS`, `DTS 70 mm`, `DTS Stereo`, `DTS-ES`, `IMAX 6-Track`, `Kinoplasticon`, `LC-Concept Digital Sound`, `Matrix Surround`, `Mono`, `Perspecta Stereo`, `Phono-Kinema`, `SDDS`, `Sensurround`, `Silent`, `Sonics-DDP`, `Sonix`, `Stereo`, `Ultra Stereo`, `Vitaphone`", "in": "query", "name": "sound_mixes", "type": "string"}, {"description": "Comma-separated cast/crew IMDb name ids, format `nm########`", "in": "query", "name": "role", "type": "string", "x-example": "nm0634240"}, {"description": "Comma-separated character names", "in": "query", "name": "characters", "type": "string", "x-example": "Neo"}, {"description": "Plot text search term", "in": "query", "name": "plot", "type": "string", "x-example": "hacker"}, {"default": false, "description": "Include adult titles. Defaults to excluded", "in": "query", "name": "include_adult", "type": "boolean"}, {"description": "One of `moviemeter`, `alpha`, `user_rating`, `num_votes`, `boxoffice_gross_us`, `runtime`, `year`, `release_date`", "in": "query", "name": "sort", "type": "string", "x-example": "user_rating"}, {"description": "`asc` or `desc`. Defaults to `asc` when sort is set", "in": "query", "name": "sort_order", "type": "string", "x-example": "desc"}, {"description": "Rows to return, default 25, max 50", "in": "query", "name": "limit", "type": "integer", "x-example": 25}], "path": "/imdb/search/title", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "title", "type": "string"}, {"in": "query", "name": "title_type", "type": "string"}, {"in": "query", "name": "genres", "type": "string"}, {"in": "query", "name": "release_date_from", "type": "string"}, {"in": "query", "name": "release_date_to", "type": "string"}, {"in": "query", "name": "min_user_rating", "type": "number"}, {"in": "query", "name": "max_user_rating", "type": "number"}, {"in": "query", "name": "min_votes", "type": "integer"}, {"in": "query", "name": "max_votes", "type": "integer"}, {"in": "query", "name": "min_popularity", "type": "integer"}, {"in": "query", "name": "max_popularity", "type": "integer"}, {"in": "query", "name": "min_runtime", "type": "integer"}, {"in": "query", "name": "max_runtime", "type": "integer"}, {"in": "query", "name": "groups", "type": "string"}, {"in": "query", "name": "keywords", "type": "string"}, {"in": "query", "name": "companies", "type": "string"}, {"in": "query", "name": "certificates", "type": "string"}, {"in": "query", "name": "colors", "type": "string"}, {"in": "query", "name": "countries", "type": "string"}, {"in": "query", "name": "languages", "type": "string"}, {"in": "query", "name": "sound_mixes", "type": "string"}, {"in": "query", "name": "role", "type": "string"}, {"in": "query", "name": "characters", "type": "string"}, {"in": "query", "name": "plot", "type": "string"}, {"in": "query", "name": "include_adult", "type": "boolean"}, {"in": "query", "name": "sort", "type": "string"}, {"in": "query", "name": "sort_order", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title": {"id": "imdb-title", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-awards": {"id": "imdb-title-awards", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/awards", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-box-office": {"id": "imdb-title-box-office", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}], "path": "/imdb/title/box-office", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-company-credits": {"id": "imdb-title-company-credits", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/company-credits", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-connections": {"id": "imdb-title-connections", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}, {"description": "Rows to return, default 50, max 250", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/title/connections", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-credits": {"id": "imdb-title-credits", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/credits", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-episodes": {"id": "imdb-title-episodes", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0944947"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0944947/"}, {"description": "Season number to request", "in": "query", "name": "season", "type": "integer", "x-example": 1}, {"description": "Rows to return, default 10, max 20", "in": "query", "name": "limit", "type": "integer", "x-example": 10}], "path": "/imdb/title/episodes", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "season", "type": "integer"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-filming-locations": {"id": "imdb-title-filming-locations", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/filming-locations", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-goofs": {"id": "imdb-title-goofs", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/goofs", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-images": {"id": "imdb-title-images", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0089753"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0089753/"}, {"description": "Image type filter, single value or comma-separated list", "enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string", "x-example": "still_frame"}, {"description": "Rows to return, default 50, max 1000", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/title/images", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-keywords": {"id": "imdb-title-keywords", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/keywords", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-parental-guide": {"id": "imdb-title-parental-guide", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/parental-guide", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-public-facts-analysis": {"id": "imdb-title-public-facts-analysis", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/public-facts-analysis", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-quotes": {"id": "imdb-title-quotes", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/quotes", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-ratings": {"id": "imdb-title-ratings", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute IMDb title URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}], "path": "/imdb/title/ratings", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-release-info": {"id": "imdb-title-release-info", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/release-info", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-reviews": {"id": "imdb-title-reviews", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}, {"description": "Rows to return, default 10, max 20", "in": "query", "name": "limit", "type": "integer", "x-example": 10}], "path": "/imdb/title/reviews", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-similar": {"id": "imdb-title-similar", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute IMDb title URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}], "path": "/imdb/title/similar", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-technical-specs": {"id": "imdb-title-technical-specs", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/technical-specs", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-trivia": {"id": "imdb-title-trivia", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/trivia", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-videos": {"id": "imdb-title-videos", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}, {"description": "Rows to return, default 50, max 100", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/title/videos", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}}
|
|
22
|
+
{"imdb-charts": {"bodyParam": null, "bodyRequired": false, "id": "imdb-charts", "method": "GET", "params": [{"default": "top_rated_movies", "description": "IMDb chart", "enum": ["top_rated_movies", "top_rated_tv_shows", "most_popular_movies", "most_popular_tv_shows", "top_rated_english_movies", "lowest_rated_movies"], "in": "query", "name": "chart", "type": "string"}, {"default": 25, "description": "Rows to return, default 25, max 250", "in": "query", "name": "limit", "type": "integer"}], "path": "/imdb/charts", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["top_rated_movies", "top_rated_tv_shows", "most_popular_movies", "most_popular_tv_shows", "top_rated_english_movies", "lowest_rated_movies"], "in": "query", "name": "chart", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-image-types": {"bodyParam": null, "bodyRequired": false, "id": "imdb-image-types", "method": "GET", "params": [], "path": "/imdb/image-types", "pathParams": [], "produces": ["application/json"], "queryParams": [], "security": ["ApiKeyAuth"]}, "imdb-name": {"bodyParam": null, "bodyRequired": false, "id": "imdb-name", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0634240"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0634240/"}], "path": "/imdb/name", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-name-awards": {"bodyParam": null, "bodyRequired": false, "id": "imdb-name-awards", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0634240"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0634240/"}], "path": "/imdb/name/awards", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-name-credits": {"bodyParam": null, "bodyRequired": false, "id": "imdb-name-credits", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0634240"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0634240/"}], "path": "/imdb/name/credits", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-name-images": {"bodyParam": null, "bodyRequired": false, "id": "imdb-name-images", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0000151"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0000151/"}, {"description": "Image type filter, single value or comma-separated list", "enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string", "x-example": "still_frame"}, {"description": "Rows to return, default 50, max 1000", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/name/images", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-name-videos": {"bodyParam": null, "bodyRequired": false, "id": "imdb-name-videos", "method": "GET", "params": [{"description": "IMDb name id", "in": "query", "name": "id", "type": "string", "x-example": "nm0000151"}, {"description": "Absolute https://www.imdb.com/name/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/name/nm0000151/"}, {"description": "Rows to return, default 50, max 100", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/name/videos", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-search": {"bodyParam": null, "bodyRequired": false, "id": "imdb-search", "method": "GET", "params": [{"description": "Search query", "in": "query", "name": "query", "required": true, "type": "string", "x-example": "inception"}, {"description": "Rows to return, default 10, max 20", "in": "query", "name": "limit", "type": "integer", "x-example": 10}], "path": "/imdb/search", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "query", "required": true, "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-search-title": {"bodyParam": null, "bodyRequired": false, "id": "imdb-search-title", "method": "GET", "params": [{"description": "Title-name substring match", "in": "query", "name": "title", "type": "string", "x-example": "matrix"}, {"description": "Comma-separated title types: `feature`, `tvSeries`, `short`, `tvEpisode`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `tvShort`, `videoGame`, `video`, `musicVideo`, `podcastSeries`, `podcastEpisode`", "in": "query", "name": "title_type", "type": "string", "x-example": "feature"}, {"description": "Comma-separated genres (include-only): `Action`, `Adventure`, `Animation`, `Biography`, `Comedy`, `Crime`, `Documentary`, `Drama`, `Family`, `Fantasy`, `Film-Noir`, `Game-Show`, `History`, `Horror`, `Music`, `Musical`, `Mystery`, `News`, `Reality-TV`, `Romance`, `Sci-Fi`, `Short`, `Sport`, `Talk-Show`, `Thriller`, `War`, `Western`", "in": "query", "name": "genres", "type": "string", "x-example": "Action,Adventure"}, {"description": "Release date lower bound: YYYY, YYYY-MM, or YYYY-MM-DD", "in": "query", "name": "release_date_from", "type": "string", "x-example": "2020-01-01"}, {"description": "Release date upper bound: YYYY, YYYY-MM, or YYYY-MM-DD", "in": "query", "name": "release_date_to", "type": "string", "x-example": "2021-12-31"}, {"description": "Minimum IMDb user rating, 0-10", "in": "query", "name": "min_user_rating", "type": "number", "x-example": 7}, {"description": "Maximum IMDb user rating, 0-10", "in": "query", "name": "max_user_rating", "type": "number", "x-example": 9.5}, {"description": "Minimum number of user rating votes", "in": "query", "name": "min_votes", "type": "integer", "x-example": 25000}, {"description": "Maximum number of user rating votes", "in": "query", "name": "max_votes", "type": "integer"}, {"description": "Minimum IMDb popularity rank (1 is most popular)", "in": "query", "name": "min_popularity", "type": "integer"}, {"description": "Maximum IMDb popularity rank", "in": "query", "name": "max_popularity", "type": "integer"}, {"description": "Minimum runtime in minutes", "in": "query", "name": "min_runtime", "type": "integer"}, {"description": "Maximum runtime in minutes", "in": "query", "name": "max_runtime", "type": "integer"}, {"description": "Comma-separated awards/curated-list groups: `oscar_winner`, `oscar_nominee`, `emmy_winner`, `emmy_nominee`, `golden_globe_winner`, `golden_globe_nominee`, `best_picture_winner`, `best_director_winner`, `razzie_winner`, `razzie_nominee`, `top_100`, `top_250`, `top_1000`, `bottom_100`, `bottom_250`, `bottom_1000`", "in": "query", "name": "groups", "type": "string"}, {"description": "Comma-separated plot keywords", "in": "query", "name": "keywords", "type": "string", "x-example": "superhero"}, {"description": "Comma-separated IMDb company ids, format `co########`", "in": "query", "name": "companies", "type": "string", "x-example": "co0000756"}, {"description": "Comma-separated `COUNTRY:RATING` certificate pairs, e.g. `US:PG-13`", "in": "query", "name": "certificates", "type": "string", "x-example": "US:PG-13"}, {"description": "Comma-separated color info: `color`, `black_and_white`, `colorized`, `aces`", "in": "query", "name": "colors", "type": "string"}, {"description": "Comma-separated ISO country codes", "in": "query", "name": "countries", "type": "string", "x-example": "US"}, {"description": "Comma-separated ISO language codes", "in": "query", "name": "languages", "type": "string", "x-example": "en"}, {"description": "Comma-separated sound mix names: `12-Track Digital Sound`, `3 Channel Stereo`, `4-Track Stereo`, `6-Track Stereo`, `70 mm 6-Track`, `AGA Sound System`, `Auro 11.1`, `CDS`, `Chronophone`, `Cinematophone`, `Cinephone`, `Cinerama 7-Track`, `Cinesound`, `D-Cinema 48kHz 5.1`, `Datasat`, `De Forest Phonofilm`, `Digitrac Digital Audio System`, `Dolby`, `Dolby Atmos`, `Dolby Digital`, `Dolby Digital EX`, `Dolby SR`, `Dolby Stereo`, `Dolby Surround 7.1`, `DTS`, `DTS 70 mm`, `DTS Stereo`, `DTS-ES`, `IMAX 6-Track`, `Kinoplasticon`, `LC-Concept Digital Sound`, `Matrix Surround`, `Mono`, `Perspecta Stereo`, `Phono-Kinema`, `SDDS`, `Sensurround`, `Silent`, `Sonics-DDP`, `Sonix`, `Stereo`, `Ultra Stereo`, `Vitaphone`", "in": "query", "name": "sound_mixes", "type": "string"}, {"description": "Comma-separated cast/crew IMDb name ids, format `nm########`", "in": "query", "name": "role", "type": "string", "x-example": "nm0634240"}, {"description": "Comma-separated character names", "in": "query", "name": "characters", "type": "string", "x-example": "Neo"}, {"description": "Plot text search term", "in": "query", "name": "plot", "type": "string", "x-example": "hacker"}, {"default": false, "description": "Include adult titles. Defaults to excluded", "in": "query", "name": "include_adult", "type": "boolean"}, {"description": "One of `moviemeter`, `alpha`, `user_rating`, `num_votes`, `boxoffice_gross_us`, `runtime`, `year`, `release_date`", "in": "query", "name": "sort", "type": "string", "x-example": "user_rating"}, {"description": "`asc` or `desc`. Defaults to `asc` when sort is set", "in": "query", "name": "sort_order", "type": "string", "x-example": "desc"}, {"description": "Rows to return, default 25, max 50", "in": "query", "name": "limit", "type": "integer", "x-example": 25}], "path": "/imdb/search/title", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "title", "type": "string"}, {"in": "query", "name": "title_type", "type": "string"}, {"in": "query", "name": "genres", "type": "string"}, {"in": "query", "name": "release_date_from", "type": "string"}, {"in": "query", "name": "release_date_to", "type": "string"}, {"in": "query", "name": "min_user_rating", "type": "number"}, {"in": "query", "name": "max_user_rating", "type": "number"}, {"in": "query", "name": "min_votes", "type": "integer"}, {"in": "query", "name": "max_votes", "type": "integer"}, {"in": "query", "name": "min_popularity", "type": "integer"}, {"in": "query", "name": "max_popularity", "type": "integer"}, {"in": "query", "name": "min_runtime", "type": "integer"}, {"in": "query", "name": "max_runtime", "type": "integer"}, {"in": "query", "name": "groups", "type": "string"}, {"in": "query", "name": "keywords", "type": "string"}, {"in": "query", "name": "companies", "type": "string"}, {"in": "query", "name": "certificates", "type": "string"}, {"in": "query", "name": "colors", "type": "string"}, {"in": "query", "name": "countries", "type": "string"}, {"in": "query", "name": "languages", "type": "string"}, {"in": "query", "name": "sound_mixes", "type": "string"}, {"in": "query", "name": "role", "type": "string"}, {"in": "query", "name": "characters", "type": "string"}, {"in": "query", "name": "plot", "type": "string"}, {"in": "query", "name": "include_adult", "type": "boolean"}, {"in": "query", "name": "sort", "type": "string"}, {"in": "query", "name": "sort_order", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-awards": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-awards", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/awards", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-box-office": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-box-office", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}], "path": "/imdb/title/box-office", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-company-credits": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-company-credits", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/company-credits", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-connections": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-connections", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}, {"description": "Rows to return, default 50, max 250", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/title/connections", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-credits": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-credits", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/credits", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-episodes": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-episodes", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0944947"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0944947/"}, {"description": "Season number to request", "in": "query", "name": "season", "type": "integer", "x-example": 1}, {"description": "Rows to return, default 10, max 20", "in": "query", "name": "limit", "type": "integer", "x-example": 10}], "path": "/imdb/title/episodes", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "season", "type": "integer"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-filming-locations": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-filming-locations", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/filming-locations", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-goofs": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-goofs", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/goofs", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-images": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-images", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0089753"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0089753/"}, {"description": "Image type filter, single value or comma-separated list", "enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string", "x-example": "still_frame"}, {"description": "Rows to return, default 50, max 1000", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/title/images", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"enum": ["behind_the_scenes", "event", "poster", "product", "production_art", "publicity", "still_frame", "unknown"], "in": "query", "name": "type", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-keywords": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-keywords", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/keywords", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-parental-guide": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-parental-guide", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/parental-guide", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-public-facts-analysis": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-public-facts-analysis", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/public-facts-analysis", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-quotes": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-quotes", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/quotes", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-ratings": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-ratings", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute IMDb title URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}], "path": "/imdb/title/ratings", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-release-info": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-release-info", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/release-info", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-reviews": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-reviews", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}, {"description": "Rows to return, default 10, max 20", "in": "query", "name": "limit", "type": "integer", "x-example": 10}], "path": "/imdb/title/reviews", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "imdb-title-similar": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-similar", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt0111161"}, {"description": "Absolute IMDb title URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt0111161/"}], "path": "/imdb/title/similar", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-technical-specs": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-technical-specs", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/technical-specs", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-trivia": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-trivia", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}], "path": "/imdb/title/trivia", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}], "security": ["ApiKeyAuth"]}, "imdb-title-videos": {"bodyParam": null, "bodyRequired": false, "id": "imdb-title-videos", "method": "GET", "params": [{"description": "IMDb title id", "in": "query", "name": "id", "type": "string", "x-example": "tt1375666"}, {"description": "Absolute https://www.imdb.com/title/<id>/ URL", "in": "query", "name": "url", "type": "string", "x-example": "https://www.imdb.com/title/tt1375666/"}, {"description": "Rows to return, default 50, max 100", "in": "query", "name": "limit", "type": "integer", "x-example": 50}], "path": "/imdb/title/videos", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "id", "type": "string"}, {"in": "query", "name": "url", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}}
|
|
23
23
|
JSON
|
|
24
24
|
OPERATION_IDS = JSON.parse(<<~'JSON').freeze
|
|
25
25
|
["imdb-charts", "imdb-image-types", "imdb-name", "imdb-name-awards", "imdb-name-credits", "imdb-name-images", "imdb-name-videos", "imdb-search", "imdb-search-title", "imdb-title", "imdb-title-awards", "imdb-title-box-office", "imdb-title-company-credits", "imdb-title-connections", "imdb-title-credits", "imdb-title-episodes", "imdb-title-filming-locations", "imdb-title-goofs", "imdb-title-images", "imdb-title-keywords", "imdb-title-parental-guide", "imdb-title-public-facts-analysis", "imdb-title-quotes", "imdb-title-ratings", "imdb-title-release-info", "imdb-title-reviews", "imdb-title-similar", "imdb-title-technical-specs", "imdb-title-trivia", "imdb-title-videos"]
|
|
@@ -29,7 +29,7 @@ module Crawlora
|
|
|
29
29
|
class Client
|
|
30
30
|
attr_reader :base_url
|
|
31
31
|
|
|
32
|
-
def initialize(api_key: ENV["CRAWLORA_API_KEY"], base_url: "https://api.crawlora.net/api/v1", timeout: 30, user_agent: "crawlora-imdb-ruby/0.1.
|
|
32
|
+
def initialize(api_key: ENV["CRAWLORA_API_KEY"], base_url: "https://api.crawlora.net/api/v1", timeout: 30, user_agent: "crawlora-imdb-ruby/0.1.2", transport: nil)
|
|
33
33
|
@api_key = api_key
|
|
34
34
|
@base_url = base_url.to_s.sub(%r{/+$}, "")
|
|
35
35
|
@timeout = Float(timeout)
|
|
@@ -45,15 +45,24 @@ module Crawlora
|
|
|
45
45
|
raise Errors::ClientError.new("unknown operation: #{operation_id}", operation_id: operation_id) unless operation
|
|
46
46
|
raise Errors::ClientError.new("Crawlora API key is required", operation_id: operation_id) if @api_key.nil? || @api_key.to_s.empty?
|
|
47
47
|
normalized = params.each_with_object({}) { |(key, value), out| out[key.to_s] = value }
|
|
48
|
+
payload = request_body(operation, normalized)
|
|
48
49
|
url = build_url(operation, normalized)
|
|
49
50
|
uri = URI.parse(url)
|
|
50
|
-
request = Net::HTTP::Get.new(uri)
|
|
51
|
+
request = operation["method"] == "POST" ? Net::HTTP::Post.new(uri) : Net::HTTP::Get.new(uri)
|
|
52
|
+
unless payload.nil?
|
|
53
|
+
request.body = payload
|
|
54
|
+
request["Content-Type"] = "application/json"
|
|
55
|
+
end
|
|
51
56
|
request["x-api-key"] = @api_key
|
|
52
57
|
request["User-Agent"] = @user_agent
|
|
53
58
|
request["Accept"] = operation["produces"].include?("text/plain") ? "application/json, text/plain" : "application/json"
|
|
54
59
|
begin
|
|
55
60
|
if @transport
|
|
56
|
-
response =
|
|
61
|
+
response = if operation["method"] == "POST"
|
|
62
|
+
@transport.call(url, request.to_hash, @timeout, "POST", payload)
|
|
63
|
+
else
|
|
64
|
+
@transport.call(url, request.to_hash, @timeout)
|
|
65
|
+
end
|
|
57
66
|
status = Integer(response.fetch(:status) { response.fetch("status") })
|
|
58
67
|
body = response.fetch(:body) { response.fetch("body", "") }
|
|
59
68
|
headers = response.fetch(:headers) { response.fetch("headers", {}) }
|
|
@@ -228,8 +237,21 @@ module Crawlora
|
|
|
228
237
|
|
|
229
238
|
private
|
|
230
239
|
|
|
240
|
+
# POST operations take their JSON body under the body parameter name or "body".
|
|
241
|
+
def request_body(operation, params)
|
|
242
|
+
name = operation["bodyParam"]
|
|
243
|
+
return nil if name.nil?
|
|
244
|
+
value = params.key?(name) ? params[name] : params["body"]
|
|
245
|
+
if value.nil?
|
|
246
|
+
raise Errors::ClientError.new("missing request body: #{name}", operation_id: operation["id"]) if operation["bodyRequired"]
|
|
247
|
+
return nil
|
|
248
|
+
end
|
|
249
|
+
value.is_a?(String) ? value : JSON.generate(value)
|
|
250
|
+
end
|
|
251
|
+
|
|
231
252
|
def build_url(operation, params)
|
|
232
253
|
known = operation["params"].map { |param| param["name"] }
|
|
254
|
+
known << "body" if operation["bodyParam"]
|
|
233
255
|
unknown = params.keys - known
|
|
234
256
|
raise Errors::ClientError.new("unknown parameters: #{unknown.join(', ')}", operation_id: operation["id"]) unless unknown.empty?
|
|
235
257
|
path = operation["path"].dup
|
metadata
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: crawlora-imdb
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1.
|
|
4
|
+
version: 0.1.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Crawlora
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2026-10-
|
|
11
|
+
date: 2026-10-12 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
|
-
description:
|
|
13
|
+
description: Ruby client for Crawlora's hosted IMDb API. Covers title and name search,
|
|
14
|
+
charts, ratings, credits, awards, episodes, reviews, images, and title metadata
|
|
15
|
+
across 30 endpoints.
|
|
14
16
|
email:
|
|
15
17
|
executables: []
|
|
16
18
|
extensions: []
|
|
@@ -47,5 +49,5 @@ requirements: []
|
|
|
47
49
|
rubygems_version: 3.4.19
|
|
48
50
|
signing_key:
|
|
49
51
|
specification_version: 4
|
|
50
|
-
summary: IMDb client for
|
|
52
|
+
summary: IMDb API client for Crawlora (30 endpoints)
|
|
51
53
|
test_files: []
|