/imdb-api

Serverless IMDB API powered by Cloudflare Worker

Primary LanguageJavaScriptApache License 2.0Apache-2.0

IMDB API

📖 Note: Please update the API URL from imdb-api.tprojects.workers.dev to imdb-api.projects.thetuhin.com. If you anticipate sending a large number of requests, it is recommended that you deploy your own Cloudflare worker. Note that imdb-api.tprojects.workers.dev will soon have a 301 redirect in place (effective date 26-02-2023).

Features 🪶

  • Search titles
  • Search by IMDB ID
  • Cacheable Result
  • High Performance
  • Get episode information
  • Get all reviews with full pagination supported

Installation 📦

Installation is pretty easy and straight forward. Click the button below to get started.

Deploy to Cloudflare Workers

After deployed, map the qorker with a Domain Name to configure cache.

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 📡

Run in Postman

  • /search?query={query} for search by title - Try It
  • /title/{imdb_id} get details of a title - Try It
  • /reviews/{imdb_id}?option={helpfulness|date|votes|rating}&sortOrder={asc|desc} get reviews of a title - Try It

License 🎯

Have a good day 🤘