CloudObjects / Directory / The New York Times / Movie Reviews API
Sign in

Movie Reviews API

a wa:WebAPI in The New York Times

With the Movie Reviews API, you can search New York Times movie reviews by keyword and get lists of NYT Critics' Picks.

Base URL

The API endpoint is located at the following URL:
https://api.nytimes.com/svc/movies/v2

Authentication
API Methods

These are the methods supported by the API:

  • GET /reviews/{resource-type}.json
    Required parameters:
    resource-type Specify all to retrieve all reviews, including NYT Critics' Picks. Specify picks to get NYT Critics' Picks currently in theaters.
    Optional parameters:
    offset Positive integer, multiple of 20
    order Sets the sort order of the results. Results ordered by-title are in ascending alphabetical order. Results ordered by one of the date parameters are in reverse chronological order. If you do not specify a sort order, the results will be ordered by publication-date.
    Success response:

    An array of Movies

    Status Code 200
    
    
  • GET /reviews/search.json
    Optional parameters:
    query Search keywords; matches movie title and indexed terms To limit your search to exact matches only, surround your search string with single quotation marks (e.g., query='28+days+later'). Otherwise, responses will include partial matches ("head words") as well as exact matches (e.g., president will match president, presidents and presidential). If you specify multiple terms without quotation marks, they will be combined in an OR search. If you omit the query parameter, your request will be equivalent to a reviews and NYT Critics' Picks request.
    critics-pick Set this parameter to Y to limit the results to NYT Critics' Picks. To get only those movies that have not been highlighted by Times critics, specify critics-pick=N. (To get all reviews regardless of critics-pick status, simply omit this parameter.)
    reviewer Include this parameter to limit your results to reviews by a specific critic. Reviewer names should be formatted like this: Manohla Dargis.
    publication-date Single date: YYYY-MM-DD Start and end date: YYYY-MM-DD;YYYY-MM-DD The publication-date is the date the review was first published in The Times.
    opening-date Single date: YYYY-MM-DD Start and end date: YYYY-MM-DD;YYYY-MM-DD The opening-date is the date the movie's opening date in the New York region.
    offset Positive integer, multiple of 20
    order Sets the sort order of the results. Results ordered by-title are in ascending alphabetical order. Results ordered by one of the date parameters are in reverse chronological order. If you do not specify a sort order, the results will be ordered by publication-date.
    Success response:

    An array of Movies

    Status Code 200
    
    
  • GET /critics/{resource-type}.json
    Required parameters:
    resource-type all | full-time | part-time | [reviewer-name] Specify all to get all Times reviewers, or specify full-time or part-time to get that subset. Specify a reviewer's name to get details about a particular reviewer.
    Success response:

    An array of Movie Critics

    Status Code 200
    
    
Meta
URI / COID
coid://nytimes.cloudobjects.io/MovieReviewsAPI/V2
Revision
1-73f10032a3a038dbc242b82e3b7ec46f
Created at
2017-05-28 15:47 (UTC)
Usage permission
co:Public