Category № 02

A single ceremony

Every category and nomination for one ceremony.

GEThttps://api.uractor.com/oscars/year={year}/apikey={apikey}

Returns the categories presented at a single ceremony, in the order they appear in the archive. This is the endpoint most applications should start with.

Parameters

All parameters are path segments, not query parameters.
Name	Type	Description
`year` required	integer	Ceremony year, between 1929 and 2026. This is the year the ceremony was held, not the year the film was released. Example: `2026`
`apikey` required	string	Your API key. Issued from the developer portal. Example: `YOUR_API_KEY`

Request

cURL

curl "https://api.uractor.com/oscars/year=2026/apikey=YOUR_API_KEY"

Resolved path: /oscars/year=2026/apikey=YOUR_API_KEY

Response

An array of category objects.

200 OK

[
  {
    "category": "Best Picture",
    "nominations": [
      {
        "primary": ["One Battle after Another"],
        "secondary": ["Adam Somner", "Sara Murphy", "Paul Thomas Anderson"],
        "won": true
      },
      {
        "primary": ["Bugonia"],
        "secondary": ["Ed Guiney", "Andrew Lowe", "Yorgos Lanthimos"],
        "won": false
      }
    ]
  }
]

Errors

Failure modes for this endpoint.
Status	When	Body
404	No ceremony was held in that year, or the year is outside the archive.	`{ "error": "Data not found for the specified year" }`
403	The key is missing, unknown or has been revoked.	`{ "error": "Forbidden - Invalid API Key" }`
429	More than 60 requests in a minute from one key. Wait for the number of seconds in Retry-After.	`{ "error": "Too Many Requests", "limit": "60 requests per minute", "retryAfter": 42 }`
500	The archive could not be read. Safe to retry.	`{ "error": "Error fetching data" }`