ACADEMY AWARDS DATA API

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

⬡ BROWSE ENDPOINTSVIEW 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 }
}
97
CEREMONIES
16K+
NOMINATIONS
8K+
NOMINEES
6
ENDPOINTS
FREE
OPEN ACCESS
DATABASE SCHEMA
SIX RESOURCES
🎬
Nominations
~16,000 RECORDS
Central fact table. Every nomination ever made, filterable by year, category, winner, and more.
🏛️
Ceremonies
97 RECORDS
Full ceremony metadata including venue, date, overview, and highlight moments.
🎥
Movies
TMDB ENRICHED
Film metadata with posters, backdrops, genres, runtime, and IMDB/TMDB IDs.
⭐
Nominees
8,000+ RECORDS
Person metadata with biographies, birthdays, profile photos, and full Oscar history.
🏆
Categories
29 RECORDS
All award categories with definitions, history, and groupings.
🎵
Songs
SPOTIFY ENRICHED
Nominated original songs with Spotify links, artist names, and album data.
COMPLETE REFERENCE
ALL ENDPOINTS
GET/api/nominationsList & filter nominations
QUERY PARAMETERS
PARAMTYPEDESCRIPTION
yearintegeroptionalFilter by exact ceremony year
yearStartintegeroptionalStart of year range
yearEndintegeroptionalEnd of year range
nomineestringoptionalPartial match on nominee name
moviestringoptionalPartial match on movie title
categorystringoptionalPartial match on category name
winnerbooleanoptionalFilter winners (true) or losers (false)
is_songbooleanoptionalFilter song nominations only
idsstringoptionalComma-separated nomination IDs
ceremony_idsstringoptionalFilter by ceremony IDs
category_idsstringoptionalFilter by category IDs
movie_idsstringoptionalFilter by movie IDs
nominee_idsstringoptionalFilter by nominee IDs
pageintegeroptionalPage number (default: 1)
limitintegeroptionalResults per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDTYPEDESCRIPTION
idbigintNomination ID
ceremony_idintegerFK → ceremonies
ceremony_yearintegerCeremony year (denormalized)
category_idintegerFK → categories
categorytextAward category name
movie_idintegerFK → movies
movietextFilm title
nominee_idintegerFK → nominees
nomineetextNominee name
song_idintegerFK → songs (nullable)
song_titletextSong title if applicable
is_songbooleanTrue if song category
winnerbooleanTrue 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
FIELDTYPEDESCRIPTION
idbigintNomination ID
ceremony_yearintegerCeremony year
categorytextAward category name
movietextFilm title
nomineetextNominee name
winnerbooleanTrue if won
movieobjectFull embedded movie record
ceremonyobjectFull embedded ceremony record
categoryobjectFull embedded category record
nomineeobjectFull embedded nominee record
songobjectFull 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
PARAMTYPEDESCRIPTION
idsstringoptionalComma-separated ceremony IDs
RESPONSE FIELDS
FIELDTYPEDESCRIPTION
idintegerCeremony ID
ceremony_yearintegerYear of ceremony
datedateCeremony date
show_titletexte.g. "97th Academy Awards"
venuetextVenue name
overviewtextSummary of the ceremony
movies_eligibletextEligibility window description
wikiurltextWikipedia URL
moment_1_captiontextHighlight moment caption
moment_1_img_urltextHighlight moment image URL
moment_2_captiontextHighlight moment caption
moment_2_img_urltextHighlight moment image URL
moment_3_captiontextHighlight moment caption
moment_3_img_urltextHighlight 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
PARAMTYPEDESCRIPTION
titlestringoptionalPartial match on film title
tmdb_idintegeroptionalTMDB movie ID
imdb_idstringoptionalIMDB ID e.g. tt1234567
genrestringoptionalFilter by genre
idsstringoptionalComma-separated IDs
pageintegeroptionalPage number (default: 1)
limitintegeroptionalResults per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDTYPEDESCRIPTION
idintegerMovie ID
titletextFilm title
taglinetextFilm tagline
overviewtextPlot summary
release_datedateRelease date
runtimeintegerRuntime in minutes
genrestext[]Array of genre names
origin_countrytext[]Array of ISO country codes
tmdb_idintegerTMDB movie ID
imdb_idtextIMDB ID
poster_pathtextFull poster image URL
backdrop_pathtextFull 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
FIELDTYPEDESCRIPTION
idintegerMovie ID
titletextFilm title
overviewtextPlot summary
release_datedateRelease date
runtimeintegerRuntime in minutes
genrestext[]Array of genre names
poster_pathtextFull poster image URL
backdrop_pathtextFull backdrop image URL
tmdb_idintegerTMDB movie ID
imdb_idtextIMDB ID
nominationsarrayAll 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
PARAMTYPEDESCRIPTION
namestringoptionalPartial match on name
tmdb_person_idintegeroptionalTMDB person ID
imdb_idstringoptionalIMDB person ID
known_for_departmentstringoptionale.g. Acting, Directing
idsstringoptionalComma-separated IDs
pageintegeroptionalPage number (default: 1)
limitintegeroptionalResults per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDTYPEDESCRIPTION
idintegerNominee ID
nametextFull name
biographytextBiographical text
birthdaydateDate of birth
deathdaydateDate of death (if applicable)
place_of_birthtextCity/country of birth
known_for_departmenttexte.g. Acting, Directing
homepagetextOfficial website URL
tmdb_person_idintegerTMDB person ID
imdb_idtextIMDB person ID
profile_pathtextFull 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
FIELDTYPEDESCRIPTION
idintegerNominee ID
nametextFull name
biographytextBiographical text
birthdaydateDate of birth
deathdaydateDate of death (if applicable)
place_of_birthtextCity/country of birth
profile_pathtextFull profile photo URL
nominationsarrayFull 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
PARAMTYPEDESCRIPTION
category_namestringoptionalPartial match on category name
category_groupstringoptionale.g. Acting, Craft, Direction
idsstringoptionalComma-separated IDs
RESPONSE FIELDS
FIELDTYPEDESCRIPTION
idintegerCategory ID
category_nametexte.g. "Best Picture"
category_grouptexte.g. "Acting", "Craft"
definitiontextOfficial category definition
eratextEra or time period active
historytextHistory 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
PARAMTYPEDESCRIPTION
titlestringoptionalPartial match on song title
artiststringoptionalPartial match on artist name
yearintegeroptionalFilter by Spotify year
idsstringoptionalComma-separated IDs
pageintegeroptionalPage number (default: 1)
limitintegeroptionalResults per page (default: 25, max: 100)
RESPONSE FIELDS
FIELDTYPEDESCRIPTION
idintegerSong ID
original_titletextOriginal song title
artist_namestextArtist name(s)
spotify_idtextSpotify track ID
spotify_urltextSpotify track URL
spotify_track_nametextTrack name on Spotify
spotify_album_nametextAlbum name on Spotify
spotify_yearintegerRelease year on Spotify
EXAMPLE REQUEST — click URL to copy
GET https://api.oscarbase.com/api/songs?artist=Billie+Eilish
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