What's After the Movie API
What's After the Movie API
What's After the Movie API

Awards

Ceremonies, nominations and winners.

Search award ceremonies

GET
https://whatsafterthemovie-main-0565fcb.zuplo.app
/v1/awards

Browse award ceremony editions by name, award type, year, or ceremony date. Each result identifies a specific edition and includes its image and source link. Use its ID to retrieve nominations and winners.

Search award ceremonies › query Parameters

limit
​integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20
cursor
​string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

q
​string · minLength: 1 · maxLength: 120

Match part of a ceremony name, ignoring case.

type
​string · enum

Award ceremony type.

Enum values:
OSCAR
GOLDEN_GLOBE
BAFTA
CANNES
BERLIN
VENICE
SUNDANCE
TIFF
year
​integer · min: 1800 · max: 2200

Award edition year to match exactly.

date_from
​string · pattern: ^\d{4}-\d{2}-\d{2}$

Earliest event or ceremony date to include (YYYY-MM-DD, inclusive).

date_to
​string · pattern: ^\d{4}-\d{2}-\d{2}$

Latest event or ceremony date to include (YYYY-MM-DD, inclusive).

sort
​string · enum

Order results by this field. A leading minus reverses the order.

Enum values:
id
year
-year
Default: id

Search award ceremonies › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search award ceremonies › Responses

The requested data. Examples use illustrative values.

ListAwardsResponse
​object[] · required
​object · required

Get nominations and winners

GET
https://whatsafterthemovie-main-0565fcb.zuplo.app
/v1/awards/{award}

Retrieve an award ceremony edition and its paginated nominations in data.nominations. Filter by category, movie, person, or winner status. Each nomination identifies the movie, the person when applicable, the category, and whether it won.

Get nominations and winners › path Parameters

award
​string · minLength: 1 · maxLength: 255 · required

Positive ATM numeric ID.

Get nominations and winners › query Parameters

limit
​integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20
cursor
​string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

category
​string · minLength: 1 · maxLength: 120

Exact award category.

winner
​string · enum

true returns wins only; false returns nominations that did not win. Omit to include both.

Enum values:
true
false
movie_id
​integer · min: 1 · max: 9007199254740991

Only nominations for this movie ID.

person_id
​integer · min: 1 · max: 9007199254740991

Only records associated with this person ID.

Get nominations and winners › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get nominations and winners › Responses

The requested data. Examples use illustrative values.

GetAwardResponse
​object · required
ConcertsBooks