Getting started
This API serves Academy Awards data: 97 ceremonies from 1929 to 2026, every nominee and every winner. It is free, read-only, and returns plain JSON.
1. Take a key
Go to the key page, sign in with an email address, and a key is issued to you on the spot. There is no application form and nothing to approve.
2. Put the key in the path
This is the one genuinely unusual thing about this API, so it is worth saying plainly: the key goes in the path, not in a query string and not in a header. Every route ends with a apikey= segment.
https://api.uractor.com/{resource}/apikey=YOUR_API_KEYYour key will appear in server logs, browser history and referrer headers like any other part of a URL. Treat it as a low-value credential: it grants read-only access to public awards data and nothing else. If it leaks, rotate it.
3. Ask for a ceremony
The most useful starting point is a single ceremony, which returns every category presented that year.
curl "https://api.uractor.com/oscars/year=2026/apikey=YOUR_API_KEY"You get back an array of categories, each holding its nominations. A nomination records who or what was nominated (primary), the context it was nominated for (secondary), and whether it won.
[
{
"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
}
]
}
]Looking something up
If you already know the name you are after, go straight to it. Names are matched exactly, so spell them as the Academy does.
curl "https://api.uractor.com/person/name=Michael%20B.%20Jordan/apikey=YOUR_API_KEY"Where to go next
- The data model — what
primaryandsecondaryactually mean, and why it changes by category. - Authentication — keys, rotation, and what a 403 means.
- The reference — all six endpoints in detail.
- Limits and fair use — please cache.