Skip to content

A simple API for IMDB (free and unlimited access - no API key needed)

License

Notifications You must be signed in to change notification settings

theapache64/movie_db

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

movie_db (🚨 DEPRECATED)

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.

About

A simple API for IMDB (free and unlimited access - no API key needed)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages