Important Update: Project Discontinued 🔔

IMDb has recently launched their official API, providing developers with authorized access to their database. Given this development, I've made the decision to discontinue maintenance of this project for the following reasons:

To avoid potential conflicts with IMDb's terms of service and intellectual property rights.
To encourage the use of officially supported and maintained data sources.

Recommendations for users of this project:

Transition to IMDb's official API for the most up-to-date and reliable movie data.
Consider using alternative sources like TMDB (The Movie Database) API as another robust option.

This repository will be archived to preserve the code for reference purposes. Thank you to all contributors and users for your support throughout this project's lifespan.

For any questions or concerns, please refer to IMDb's developer documentation or explore TMDB's API offerings.

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

Have a good day 🤘

Uh oh!

License

tuhinpal/imdb-api

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Sponsor this project

Uh oh!

Uh oh!

Contributors 3

Uh oh!

Languages

Error
Looks like something went wrong!