A category through the years
One award category across every ceremony.
GEThttps://api.uractor.com/award/name={name}/apikey={apikey}
Returns every ceremony at which a category matching this name was presented. Unlike the person and film endpoints, matching here is a case-sensitive substring, which matters because category names have been renamed repeatedly — the leading acting award has been called both "Best Actor in a Leading Role" and "Best Performance by an Actor in a Leading Role". Searching for "Actor in a Leading Role" finds both.
Parameters
| Name | Type | Description |
|---|---|---|
name required | string substring match | The category name, URL-encoded. Matched as a substring of the full category name. Example: Actor in a Leading Role |
apikey required | string | Your API key. Issued from the developer portal. Example: YOUR_API_KEY |
Request
curl "https://api.uractor.com/award/name=Actor%20in%20a%20Leading%20Role/apikey=YOUR_API_KEY"Resolved path: /award/name=Actor%20in%20a%20Leading%20Role/apikey=YOUR_API_KEY
Response
An array of matches, each carrying the year and the full nomination list for that category.
[
{
"year": "1929",
"category": "Best Actor in a Leading Role",
"nominations": [
{
"primary": ["Emil Jannings"],
"secondary": ["The Last Command", "The Way of All Flesh"],
"won": true,
"notes": "Emil Jannings received his award early due to the fact that he was going home to Europe before the ceremony."
}
]
}
]Errors
| 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" } |