Category № 01

The complete archive

Every ceremony from 1929 to 2026.

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

Returns the entire archive as a single object keyed by ceremony year. This is a large response — several megabytes — so prefer a narrower endpoint when you can, and cache the result if you genuinely need all of it.

Parameters

All parameters are path segments, not query parameters.
Name	Type	Description
`apikey` required	string	Your API key. Issued from the developer portal. Example: `YOUR_API_KEY`

Request

cURL

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

Resolved path: /oscars/apikey=YOUR_API_KEY

Response

An object whose keys are ceremony years and whose values are arrays of categories.

200 OK

{
  "1929": [
    {
      "category": "Best Actor in a Leading Role",
      "nominations": [ … ]
    }
  ],
  "2026": [
    {
      "category": "Best Picture",
      "nominations": [ … ]
    }
  ]
}

Errors

Failure modes for this endpoint.
Status	When	Body
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" }`