Updated on Aug 23, 2023

2

min read

Oscar winners

GET

Discover the exceptional actors who have earned the highest recognition in the film industry with Oscars (Academy Awards). The "Oscar-Winning Actors" query allows you to retrieve a list of actors who have received this prestigious accolade for their outstanding performances.

Endpoint

To retrieve the Oscar-winning actors, make a GET request to the following endpoint:

GET /actors/oscar-winners

Request

Here's an example of how to make a GET request to retrieve Oscar-winning actors using JavaScript:

const apiUrl = "https://api.moviesapi.com/v1/actors/oscar-winners";

fetch(apiUrl)
  .then(response => response.json())
  .then(data => {
    console.log("Oscar-Winning Actors:", data);
  })
  .catch(error => {
    console.error("Error:", error);
  });

In this example, we use the fetch function to make an HTTP GET request to the /actors/oscar-winners endpoint, which provides a list of actors who have won Oscars for their exceptional contributions to cinema.

Response

The API will respond with a list of Oscar-winning actors in JSON format. Each actor object includes details such as the actor's name, birthdate, nationality, and a list of movies they have won Oscars for.

Here's an example response with a list of Oscar-winning actors:

[
  {
    "id": 123,
    "name": "Meryl Streep",
    "birthdate": "1949-06-22",
    "nationality": "American",
    "movies": [
      {
        "id": 54321,
        "title": "Sophie's Choice",
        "year": 1982
      },
      {
        "id": 98765,
        "title": "The Iron Lady",
        "year": 2012
      }
    ]
  },
  {
    "id": 456,
    "name": "Daniel Day-Lewis",
    "birthdate": "1957-04-29",
    "nationality": "English",
    "movies": [
      {
        "id": 23456,
        "title": "My Left Foot",
        "year": 1990
      },
      {
        "id": 78901,
        "title": "There Will Be Blood",
        "year": 2008
      }
    ]
  }
]

Response Explanation

Each actor object in the response includes the following properties:

  • id: The unique identifier of the actor.

  • name: The full name of the actor.

  • birthdate: The birthdate of the actor.

  • nationality: The nationality of the actor.

  • movies: An array of movies for which the actor has won Oscars. Each movie object includes details such as the movie's title and the year in which the Oscar was won.

Explore the world of Oscar-winning actors and their remarkable contributions to cinema with the Movies API's "Oscar-Winning Actors" query.