📖 Note: imdb-api.tprojects.workers.dev is redirected to imdb-api.projects.thetuhin.com. Please update your api url to improve latency.
Features 🪶
- Search titles
- Search by IMDB ID
- Cacheable Result
- High Performance
- Get episode information
- Get all reviews with full pagination supported
Installation 📦
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.
Run with docker 🐋
- Clone this repository
- Build the image
docker build -t imdb-api . - Start the process (Deatached)
docker run -p 3000:3000 -it -d imdb-api
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 |
License 🎯
- Licensed under Apache-2.0
- Made by Tuhin Kanti Pal