📖 Note: imdb-api.tprojects.workers.dev is redirected to imdb-api.projects.thetuhin.com. Please update your api url to improve latency.
- Search titles
- Search by IMDB ID
- Cacheable Result
- High Performance
- Get episode information
- Get all reviews with full pagination supported
If you anticipate sending a large number of requests, it is recommended that you deploy your own Cloudflare worker. Installation is pretty easy and straight forward. Click the button below to get started.
After deployed, map the worker to a Domain Name to configure cache. Only Workers deployed to custom domains have access to functional cache operations.
- Clone this repository
- Build the image
docker build -t imdb-api . - Start the process (Deatached)
docker run -p 3000:3000 -it -d imdb-api
| Endpoint | Method | Description | Example |
|---|---|---|---|
/search?query={query} |
GET | Search titles by title | Try It |
/title/{imdb_id} |
GET | Get details of a title | Try It |
/reviews/{imdb_id}?option={helpfulness|date|votes|rating}&sortOrder={asc|desc} |
GET | Get reviews of a title | Try It |
/title/{imdb_id}/season/{season_id} |
GET | (New) Fetch a single season of a series | Try It |
/user/{user_id} |
GET | (New) Fetch an user's info | Try It |
/user/{user_id}/ratings?ratingFilter={1-10}&sort={most_recent|oldest|top_rated|worst_rated} |
GET | (New) Fetch an user's ratings and reviews | Try It |
- Licensed under Apache-2.0
- Made by Tuhin Kanti Pal