Complete Academy Awards data from 1929 to present. Every nomination, winner, film, and filmmaker — queryable in milliseconds.

ENDPOINTS →EXAMPLES →
api.oscarbase.com
GET /api/nominations?nominee=Meryl+Streep&winner=true
// Response 200 OK
{
  "data": [{ "id": 4821, "ceremony_year": 2012, "category": "Best Actress", "winner": true }],
  "pagination": { "total": 3, "page": 1, "totalPages": 1 }
}
16K+
NOMINATIONS
8K+
NOMINEES
5k+
MOVIES
97
CEREMONIES
FREE
OPEN ACCESS
DATABASE SCHEMA
SIX RESOURCES
🎬
Nominations
16,000+ NOMINATIONS
Central fact table. Every nomination ever made at the individual level, filterable by year, category, winner, and more.
⭐
Nominees
8,000+ NOMINEES
Person metadata with biographies, birthdays, profile photos, and full Oscar history.
🎥
Movies
5,000+ MOVIES
Film metadata with posters, backdrops, genres, runtime, and IMDB/TMDB IDs.
🏆
Categories
109 CATEGORIES
All award categories with historical accuracy and definitions, history, and groupings.
🎵
Songs
500+ SONGS
Nominated original songs with Spotify links, artist names, and album data.
🏛️
Ceremonies
97 CEREMONIES
Full ceremony metadata including venue, date, overview, and highlight moments.
COMPLETE REFERENCE
ALL ENDPOINTS
AI / LLM REFERENCE
llms.txt
Plain-text API reference optimized for Claude, ChatGPT, and other AI assistants.
OPENAPI SPEC
openapi.json
OpenAPI 3.0 spec for Cursor, GitHub Copilot, and other developer tools.
GET/api/nominationsList & filter nominations
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
year(integer)Filter by exact ceremony year
yearStart(integer)Start of year range
yearEnd(integer)End of year range
nominee(string)Partial match on nominee name
movie(string)Partial match on movie title
category(string)Partial match on category name
winner(boolean)Filter winners (true) or losers (false)
is_song(boolean)Filter song nominations only
ids(string)Comma-separated nomination IDs
ceremony_ids(string)Filter by ceremony IDs
category_ids(string)Filter by category IDs
movie_ids(string)Filter by movie IDs
nominee_ids(string)Filter by nominee IDs
page(integer)Page number (default: 1)
limit(integer)Results per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDDESCRIPTION
id(bigint)Nomination ID
ceremony_id(integer)FK → ceremonies
ceremony_year(integer)Ceremony year (denormalized)
category_id(integer)FK → categories
category(text)Award category name
movie_id(integer)FK → movies
movie(text)Film title
nominee_id(integer)FK → nominees
nominee(text)Nominee name
song_id(integer)FK → songs (nullable)
song_title(text)Song title if applicable
is_song(boolean)True if song category
winner(boolean)True if won
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/nominations?nominee=Meryl+Streep&winner=true
GET/api/nominations/{id}Single nomination with full detail

No query parameters — just pass the ID in the URL path.

RESPONSE FIELDS
FIELDDESCRIPTION
id(bigint)Nomination ID
ceremony_year(integer)Ceremony year
category(text)Award category name
movie(text)Film title
nominee(text)Nominee name
winner(boolean)True if won
movie(object)Full embedded movie record
ceremony(object)Full embedded ceremony record
category(object)Full embedded category record
nominee(object)Full embedded nominee record
song(object)Full embedded song record (if applicable)
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/nominations/4821
GET/api/ceremoniesAll 97 ceremonies
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
ids(string)Comma-separated ceremony IDs
RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Ceremony ID
ceremony_year(integer)Year of ceremony
date(date)Ceremony date
show_title(text)e.g. "97th Academy Awards"
venue(text)Venue name
overview(text)Summary of the ceremony
movies_eligible(text)Eligibility window description
wikiurl(text)Wikipedia URL
moment_1_caption(text)Highlight moment caption
moment_1_img_url(text)Highlight moment image URL
moment_2_caption(text)Highlight moment caption
moment_2_img_url(text)Highlight moment image URL
moment_3_caption(text)Highlight moment caption
moment_3_img_url(text)Highlight moment image URL
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/ceremonies?ids=95,96,97
GET/api/moviesSearch nominated films
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
title(string)Partial match on film title
tmdb_id(integer)TMDB movie ID
imdb_id(string)IMDB ID e.g. tt1234567
genre(string)Filter by genre
ids(string)Comma-separated IDs
page(integer)Page number (default: 1)
limit(integer)Results per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Movie ID
title(text)Film title
tagline(text)Film tagline
overview(text)Plot summary
release_date(date)Release date
runtime(integer)Runtime in minutes
genres(text[])Array of genre names
origin_country(text[])Array of ISO country codes
tmdb_id(integer)TMDB movie ID
imdb_id(text)IMDB ID
poster_path(text)Full poster image URL
backdrop_path(text)Full backdrop image URL
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/movies?genre=Drama&limit=50
GET/api/movies/{id}Single movie with nominations

No query parameters — just pass the ID in the URL path.

RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Movie ID
title(text)Film title
overview(text)Plot summary
release_date(date)Release date
runtime(integer)Runtime in minutes
genres(text[])Array of genre names
poster_path(text)Full poster image URL
backdrop_path(text)Full backdrop image URL
tmdb_id(integer)TMDB movie ID
imdb_id(text)IMDB ID
nominations(array)All nominations for this film
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/movies/3011
GET/api/nomineesSearch nominees & filmmakers
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
name(string)Partial match on name
tmdb_person_id(integer)TMDB person ID
imdb_id(string)IMDB person ID
known_for_department(string)e.g. Acting, Directing
ids(string)Comma-separated IDs
page(integer)Page number (default: 1)
limit(integer)Results per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Nominee ID
name(text)Full name
biography(text)Biographical text
birthday(date)Date of birth
deathday(date)Date of death (if applicable)
place_of_birth(text)City/country of birth
known_for_department(text)e.g. Acting, Directing
homepage(text)Official website URL
tmdb_person_id(integer)TMDB person ID
imdb_id(text)IMDB person ID
profile_path(text)Full profile photo URL
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/nominees?known_for_department=Directing
GET/api/nominees/{id}Single nominee with Oscar history

No query parameters — just pass the ID in the URL path.

RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Nominee ID
name(text)Full name
biography(text)Biographical text
birthday(date)Date of birth
deathday(date)Date of death (if applicable)
place_of_birth(text)City/country of birth
profile_path(text)Full profile photo URL
nominations(array)Full Oscar nomination history
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/nominees/1
GET/api/categoriesAll 29 award categories
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
category_name(string)Partial match on category name
category_group(string)e.g. Acting, Craft, Direction
ids(string)Comma-separated IDs
RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Category ID
category_name(text)e.g. "Best Picture"
category_group(text)e.g. "Acting", "Craft"
definition(text)Official category definition
era(text)Era or time period active
history(text)History of the category
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/categories?category_group=Acting
GET/api/songsNominated original songs
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
title(string)Partial match on song title
artist(string)Partial match on artist name
year(integer)Filter by Spotify year
ids(string)Comma-separated IDs
page(integer)Page number (default: 1)
limit(integer)Results per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDDESCRIPTION
id(integer)Song ID
original_title(text)Original song title
artist_names(text)Artist name(s)
spotify_id(text)Spotify track ID
spotify_url(text)Spotify track URL
spotify_track_name(text)Track name on Spotify
spotify_album_name(text)Album name on Spotify
spotify_year(integer)Release year on Spotify
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/songs?artist=Billie+Eilish
GET/api/stats/top-moviesMost nominated films
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
sort(string)Sort by "nominations" (default) or "wins"
genre(string)Filter by genre e.g. Drama, Comedy, Horror
yearStart(integer)Start of year range
yearEnd(integer)End of year range
limit(integer)Number of results (default: 25, max: 100)
RESPONSE FIELDS
FIELDDESCRIPTION
movie_id(integer)Movie ID
movie(text)Film title
total_nominations(integer)Number of unique categories nominated
total_wins(integer)Number of unique categories won
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/stats/top-movies?genre=Drama&sort=wins&limit=10
GET/api/stats/top-nomineesMost nominated people
QUERY PARAMETERS (all optional unless noted)
PARAMDESCRIPTION
sort(string)Sort by "nominations" (default) or "wins"
known_for_department(string)e.g. Acting, Directing, Writing
category(string)Partial match on category name
category_group(string)e.g. Acting, Craft, Direction
yearStart(integer)Start of year range
yearEnd(integer)End of year range
limit(integer)Number of results (default: 25, max: 100)
RESPONSE FIELDS
FIELDDESCRIPTION
nominee_id(integer)Nominee ID
nominee(text)Nominee name
total_nominations(integer)Total number of nominations
total_wins(integer)Total number of wins
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/stats/top-nominees?known_for_department=Directing&sort=wins
WRITE ACCESS
AUTHENTICATION

READ ENDPOINTS — NO AUTH REQUIRED

All GET endpoints are fully public. No API key needed. Rate limited to 100 requests per minute per IP.

WRITE ENDPOINTS — API KEY REQUIRED

POST and PATCH endpoints require an API key passed in the request header:

POST https://api.oscarbase.com/api/movies
x-api-key: your-secret-key
Content-Type: application/json

{
  "title": "Anora",
  "tmdb_id": 1234567
}
COMMON QUERIES
EXAMPLE REQUESTS
ALL OF MERYL STREEP'S WINS
GET https://api.oscarbase.com/api/nominations?nominee=Meryl+Streep&winner=true
BEST PICTURE WINNERS 1990s
GET https://api.oscarbase.com/api/nominations?category=Best+Picture&winner=true&yearStart=1990&yearEnd=1999
FIND A MOVIE BY IMDB ID
GET https://api.oscarbase.com/api/movies?imdb_id=tt15398776
SEARCH FOR SPIELBERG NOMINATIONS
GET https://api.oscarbase.com/api/search?q=spielberg&winner=true
ALL NOMINATED SONGS BY BILLIE EILISH
GET https://api.oscarbase.com/api/songs?artist=Billie+Eilish
FULL CEREMONY DETAIL
GET https://api.oscarbase.com/api/ceremonies/97
MOST NOMINATED FILMS OF ALL TIME
GET https://api.oscarbase.com/api/stats/top-movies?limit=10
MOST WINNING DIRECTORS
GET https://api.oscarbase.com/api/stats/top-nominees?known_for_department=Directing&sort=wins