Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sjlu/popular-movies
Tries to create a list of popular movies based on a series of heuristics
https://github.com/sjlu/popular-movies
heuristics movies
Last synced: about 1 month ago
JSON representation
Tries to create a list of popular movies based on a series of heuristics
- Host: GitHub
- URL: https://github.com/sjlu/popular-movies
- Owner: sjlu
- License: mit
- Created: 2013-12-07T15:06:19.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2023-10-27T17:20:04.000Z (about 1 year ago)
- Last Synced: 2024-08-02T01:26:28.025Z (4 months ago)
- Topics: heuristics, movies
- Language: JavaScript
- Homepage: https://popular-movies-data.stevenlu.com/movies.json
- Size: 1.87 MB
- Stars: 349
- Watchers: 11
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - sjlu/popular-movies - Tries to create a list of popular movies based on a series of heuristics (JavaScript)
README
# popular-movies
This tool makes a best guess at what popular movies are based on a
series of heuristics from multiple websites. This then returns a
list of movies with their posters and IMDB ID.
Popular movies are based on some general rules:
* Rating greater than the general sentiment of movies currently out
* Released less than a year ago
* At least 3 weeks old to generate a "stable" rating
* Does not consider tastes, categories or genres of movies
## Usage
> :warning: **The URL has changed from `https://s3.amazonaws.com/popular-movies/` to `https://popular-movies-data.stevenlu.com/` as of September 11, 2023.**
> Access via S3 using TLS 1.0 or 1.1 will be [deprecated by AWS](https://aws.amazon.com/blogs/security/tls-1-2-required-for-aws-endpoints/) on December 31, 2023.
> Access via S3 will be completely deprecated January 1, 2025.
You can poll the following JSON file for a list of movies.
```
https://popular-movies-data.stevenlu.com/movies.json
```
* This file is regenerated nightly so it is recommended that you
only poll this file once per day
* It is recommended that you take a snapshot of this list and not
remove based on the list no longer displaying a particular movie
* Subject to fair use; excessive usage will be rate limited
There are also several other variations of the main file:
| File | Description |
| -- | -- |
| [movies-metacritic-min50.json](https://popular-movies-data.stevenlu.com/movies-metacritic-min50.json) | Movies with a minimum score of 50 on Metacritic |
| [movies-metacritic-min60.json](https://popular-movies-data.stevenlu.com/movies-metacritic-min60.json) | Movies with a minimum score of 60 on Metacritic |
| [movies-metacritic-min70.json](https://popular-movies-data.stevenlu.com/movies-metacritic-min70.json) | Movies with a minimum score of 70 on Metacritic |
| [movies-metacritic-min80.json](https://popular-movies-data.stevenlu.com/movies-metacritic-min80.json) | Movies with a minimum score of 80 on Metacritic |
| [movies-imdb-min5.json](https://popular-movies-data.stevenlu.com/movies-imdb-min5.json) | Movies with a minimum score of 5 on IMDB |
| [movies-imdb-min6.json](https://popular-movies-data.stevenlu.com/movies-imdb-min6.json) | Movies with a minimum score of 6 on IMDB |
| [movies-imdb-min7.json](https://popular-movies-data.stevenlu.com/movies-imdb-min7.json) | Movies with a minimum score of 7 on IMDB |
| [movies-imdb-min8.json](https://popular-movies-data.stevenlu.com/movies-imdb-min8.json) | Movies with a minimum score of 8 on IMDB |
| [movies-rottentomatoes-min50.json](https://popular-movies-data.stevenlu.com/movies-rottentomatoes-min50.json) | Movies with a minimum score of 50 on Rotten Tomatoes |
| [movies-rottentomatoes-min60.json](https://popular-movies-data.stevenlu.com/movies-rottentomatoes-min60.json) | Movies with a minimum score of 60 on Rotten Tomatoes |
| [movies-rottentomatoes-min70.json](https://popular-movies-data.stevenlu.com/movies-rottentomatoes-min70.json) | Movies with a minimum score of 70 on Rotten Tomatoes |
| [movies-rottentomatoes-min80.json](https://popular-movies-data.stevenlu.com/movies-rottentomatoes-min80.json) | Movies with a minimum score of 80 on Rotten Tomatoes |
If you're looking for historical files, you can amend a date to the
main file like so:
```
https://popular-movies-data.stevenlu.com/movies-20191202.json
```
_This file is only available from December 2, 2019 onwards._
## Develop
* Make sure you are running Node.js and a local instance of Redis
* If you want to run it locally you can clone this repository and add a
`.env` file which includes the following lines
```
TMDB_KEY=
```
* https://www.themoviedb.org/documentation/api
* Then run `npm test` and you should see an output of movies showing on
your console and the grade it's gotten
## License
MIT