Queries

The "Queries" section of the Movies API documentation allows you to access specialized queries that provide valuable insights and data from the extensive Monolito Movies database. These queries enable you to uncover unique information about movies, actors, and more. Whether you're building a movie recommendation system or conducting in-depth cinematic research, these specialized queries will be a valuable resource for your project.

Featured Movies

The "Featured Movies" query is designed to help you discover the latest and most popular movies in the Monolito Movies database. It provides a list of movies that are currently trending or highly rated by users. This query is ideal for showcasing the hottest films on your application or website, keeping your audience engaged with the latest cinematic releases.

Endpoint: /queries/featured-movies

Parameters: None

Example Request:

GET /queries/featured-movies

Example Response:

{
  "movies": [
    {
      "title": "Example Movie 1",
      "release_year": 2023,
      "rating": 9.2,
      "genre": "Drama"
    },
    {
      "title": "Example Movie 2",
      "release_year": 2023,
      "rating": 8.8,
      "genre": "Action"
    }
    // Additional movies
  ]
}

Oscar Winners

The "Oscar Winners" query allows you to access a list of movies and actors who have been honored with prestigious Academy Awards. Whether you want to create a dedicated section on your platform to celebrate these cinematic achievements or you're just curious about the Oscar winners, this query provides a comprehensive list of accolades.

Endpoint: /queries/oscar-winners

Parameters:

• category (optional): Specify whether you want to retrieve movies or actors who have won Oscars. Possible values are "movies" and "actors."

Example Request:

GET /queries/oscar-winners?category=movies

Example Response:

{
  "movies": [
    {
      "title": "Oscar-Winning Movie 1",
      "year": 2022,
      "categories": ["Best Picture", "Best Director", "Best Actor"]
    },
    {
      "title": "Oscar-Winning Movie 2",
      "year": 2022,
      "categories": ["Best Original Screenplay", "Best Supporting Actor"]
    }
    // Additional movies
  ]
}

Top Movies of The Week

The "Top Movies of The Week" query is perfect for keeping your users up-to-date with the latest box office hits and critically acclaimed films. It provides a weekly ranking of the most popular movies, making it easy to curate a list of must-watch titles on your platform.

Endpoint: /queries/top-movies-of-the-week

Parameters: None

Example Request:

GET /queries/top-movies-of-the-week

Example Response:

{
  "movies": [
    {
      "title": "Top Movie of the Week 1",
      "release_year": 2023,
      "rating": 8.9,
      "genre": "Thriller"
    },
    {
      "title": "Top Movie of the Week 2",
      "release_year": 2023,
      "rating": 8.7,
      "genre": "Comedy"
    }
    // Additional movies
  ]
}

These specialized queries provide you with the flexibility to access the most relevant movie data for your application or research. Use them to create engaging features, highlight cinematic achievements, and keep your users informed about the latest trends in the world of movies.