A simple API for IMDB (free and unlimited access - no API key needed)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.idea
src/com/theah64/movie_db
web
.gitignore
LICENSE
README.md
movie_db.iml
new_algo.png

README.md

movie_db

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 theapache64@gmail.com

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

/search

HTTP GET

End Point Description
http://theapache64.com/movie_db/search Returns the search result
Parameter Required Type Default Description
keyword true String null The keyword you want perform search against

Examples

URL Description
http://theapache64.com/movie_db/search?keyword=Ironman Returns Ironman movie details

Further examples

Syntax

http://theapache64.com/movie_db/search?keyword=[YOUR-KEYWORD]

Example

GET

http://theapache64.com/movie_db/search?keyword=Titanic

Response:

{
  "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": "https://images-na.ssl-images-amazon.com/images/M/MV5BMDdmZGU3NDQtY2E5My00ZTliLWIzOTUtMTY4ZGI1YjdiNjk3XkEyXkFqcGdeQXVyNTA4NzY1MzY@._V1_UX182_CR0,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.

GET

http://theapache64.com/movie_db/search?keyword=Tony+Stark

Response:

{
  "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": "https://images-na.ssl-images-amazon.com/images/M/MV5BMTczNTI2ODUwOF5BMl5BanBnXkFtZTcwMTU0NTIzMw@@._V1_UX182_CR0,0,182,268_AL_.jpg"
  },
  "error_code": 0,
  "error": false,
  "message": "Movie found"
}theapache64.com/movie_db/search?keyword=Ironman

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 theapache64@gmail.com and i'll implement it. :)

Found an issue?

Open an issue (y)

Note

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.