Skip to content
A simple API for IMDB (free and unlimited access - no API key needed)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A simple API for IMDB (no-api-key, no fee, fully free and unlimited access for lifetime).

API Documentation

This is a lightweight web service, (REST interface), which provides an easy way to access the IMDB website. Our API works through simple commands, so there should not be a problem coding some nice applications.

If you find any bug, or have any questions, or any suggestions please shoot me a mail to

API Endpoints

All the API endpoints return the same data structure as below

Returned Key Description Example
error The returned status for the API call, can be either 'true' or 'false' true
message Either the error message or the successful message Movie found
data If 'error' is returned as 'false' the API query results will be inside 'data' data



End Point Description Returns the search result
Parameter Required Type Default Description
keyword true String null The keyword you want perform search against


URL Description Returns Ironman movie details

Further examples





  "data": {
    "plot": "A seventeen-year-old aristocrat falls in love with a kind but poor artist aboard the luxurious, ill-fated R.M.S. Titanic.",
    "name": "Titanic",
    "rating": "7.7",
    "genre": "Drama,Romance",
    "poster_url": ",0,182,268_AL_.jpg"
  "error_code": 0,
  "error": false,
  "message": "Movie found"

Please note that the keyword can be anything like character name, part of the movie name etc. For example if we search Tony Stark (Ironman's character name), We'll get the Ironman movie.



  "data": {
    "plot": "After being held captive in an Afghan cave, billionaire engineer Tony Stark creates a unique weaponized suit of armor to fight evil.",
    "name": "Iron Man",
    "rating": "7.9",
    "genre": "Action,Adventure,Sci-Fi",
    "poster_url": ",0,182,268_AL_.jpg"
  "error_code": 0,
  "error": false,
  "message": "Movie found"

As of now, the API only provides basic details like name, plot, rating, genre and posterUrl. If you need more details, shoot me a mail to and i'll implement it. :)

Found an issue?

Open an issue (y)


Please don't use this API for commericial purposes, as it is just a proof of concept and could be shutdown any moment. If you want commercial copy of this API for permanent usage, feel free to contact me.

You can’t perform that action at this time.