popcorn logo
WHATCHWatch movies online
popcorn logo

API

Requests

Get all movies: https://whatch.online/api/v1/movies.json
Get movie by imdbId: https://whatch.online/api/v1/movie/imdb/[imdbId].json
Get movie by tmdbId: https://whatch.online/api/v1/movie/tmdb/[tmdbId].json
Get movie by LBRY claimId: https://whatch.online/api/v1/movie/claimid/[claimId].json
Get movie by Rotten Tomatoes id: https://whatch.online/api/v1/movie/rottentomatoes/[id].json
Example: https://www.rottentomatoes.com/m/[id]

Example Request

curl https://whatch.online/api/v1/movie/imdb/tt0000273.json

Example Response

{"id":460,"title":"Attack on a China Mission","description":"The titles tell us this film is based on an incident in the Boxer Rebellion. A man tries to defend a woman and a large house against Chinese attackers. They attack with swords, guns, and paddles. He\u0027s over-matched. What will become of the mission, its defenders, and its occupants?","year":1900,"duration":77,"width":632,"height":480,"imdbId":"tt0000273","imdbRating":5.5,"rottenId":"","rottenRating":-1,"metaRating":-1,"whatchId":"attack_on_a_china_mission_1900","tmdbId":179546,"lbryId":"attack-on-a-china-mission/266ef4f661823592d030744f663984b75f8fd8fb","cast":[{"id":26983,"name":"Mr. James","character":"","tmdbId":142895},{"id":26984,"name":"Mr. Lepard","character":"","tmdbId":1470738},{"id":26985,"name":"Florence Williamson","character":"","tmdbId":1470739}],"director":[{"id":2430,"name":"James Williamson","tmdbId":1037369}]}

Movie object

id Number Unique identifier
title String Title of the movie
description String Short description of the movie
year Number Year of publication
duration Number Duration in seconds
width Number Width in pixels
height Number Height in pixels
imdbId String Empty if not available
imdbRating Number 0-10 ; -1 if not available
rottenId String Empty if not available
rottenRating Number 0-100 ; -1 if not available
metaRating Number 0-100 ; -1 if not available
whatchId String Id for https://whatch.online/movie/[watchId]
tmdbId Number Id for https://www.themoviedb.org/movie/[tmdbId] ; -1 if not available
lbryId String Id for https://odysee.com/[lbryId]
cast Array List of cast
director Array List of directors

Cast object

id Number Unique identifier
name String Full name
character String Character name in the movie ; empty if not available
tmdbId Number Id for https://www.themoviedb.org/person/[tmdbId]

Director object

id Number Unique identifier
name String Full name
tmdbId Number Id for https://www.themoviedb.org/person/[tmdbId]

Images

Movie poster

Take the imdbId from the Movie object and use the following url https://whatch.online/p/[imdbId].jpg
OR
Take the tmdbId from the Movie object and check out https://developers.themoviedb.org/3/movies/get-movie-images

People poster

Take the tmdbId from the Cast or Director object and use the following url https://whatch.online/people/[tmdbId].jpg
OR
Take the tmdbId from the Cast or Director object and check out https://developers.themoviedb.org/3/people/get-person-details

Embed movie

<iframe id="lbry-iframe" width="[Movie.width]" height="[Movie.height]" src="https://odysee.com/$/embed/[Movie.lbryId]" allowfullscreen></iframe>

Example

<iframe id="lbry-iframe" width="560" height="315" src="https://odysee.com/$/embed/TheGoldRush1925ClassicMovie/c37cf37dd33cc54a86c064c033b8c506847761b2" allowfullscreen></iframe>