Category № 04

A film at one ceremony

Every category a film was nominated in at a given ceremony.

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

Searches a single ceremony for nominations naming this film. Matching is exact and case-sensitive. A film usually appears in the primary field for Best Picture and in the secondary field for the craft and performance categories, so this returns both.

Parameters

All parameters are path segments, not query parameters.
Name	Type	Description
`name` required	string exact match	The film title, URL-encoded. Matched exactly against the primary and secondary arrays. Example: `Sinners`
`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/movie/name=Sinners/year=2026/apikey=YOUR_API_KEY"

Resolved path: /movie/name=Sinners/year=2026/apikey=YOUR_API_KEY

Response

An array of matches, each carrying the category it came from.

200 OK

[
  {
    "category": "Best Performance by an Actor in a Leading Role",
    "nomination": {
      "primary": ["Michael B. Jordan"],
      "secondary": ["Sinners"],
      "won": true
    }
  }
]

Errors

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