Category № 06

A category at one ceremony

One award category at a single ceremony.

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

The same substring matching as the previous endpoint, narrowed to one ceremony. Use this to get a category’s full slate of nominees for a given year.

Parameters

All parameters are path segments, not query parameters.
Name	Type	Description
`name` required	string substring match	The category name, URL-encoded. Matched as a substring of the full category name. Example: `Directing`
`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/award/name=Directing/year=2026/apikey=YOUR_API_KEY"

Resolved path: /award/name=Directing/year=2026/apikey=YOUR_API_KEY

Response

An array of matches, each carrying the full nomination list for that category.

200 OK

[
  {
    "category": "Best Achievement in Directing",
    "nominations": [
      {
        "primary": ["Paul Thomas Anderson"],
        "secondary": ["One Battle after Another"],
        "won": true
      }
    ]
  }
]

Errors

Failure modes for this endpoint.
Status	When	Body
404	No award matched the values you supplied.	`{ "error": "Award not found" }`
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" }`