Movie Reviews API

1

• Movie Reviews API

2
About the Content

• Over 22,000 movie reviews in the archive are
  available to the API
• Reviews stretch back to 1924
• On average, about 12 reviews per week
• Three full-time reviewers

3
About Our APIs

• Movie Reviews service uses a RESTful style
• All requests use HTTP GET
• Developers must have API keys to access
• Results are returned in XML, JSON, or sPHP
  format based on the extension of the file
  requested

4
Movies API Services in General

• Four services are available
• Search for reviews by keywords
• Get lists of reviews and NYT Critics' Picks
• Get reviews by reviewer
• Get information about the reviewers

5
Search for "Punisher"

• http//api.nytimes.com/svc/movies/v2/reviews/searc
  h.xml?querypunisher

6
Limit by Critics' Pick

• http//api.nytimes.com/svc/movies/v2/reviews/searc
  h.xml?querycasablancacritics-pickY

7
Limit by Thousand Best

• http//api.nytimes.com/svc/movies/v2/reviews/searc
  h.xml?querycasablanca
• thousand-bestY

8
Limit Results to Movies on DVD

• http//api.nytimes.com/svc/movies/v2/reviews/searc
  h.xml?querythe-goonies
• dvd-picksY

9
Search for "love"

• Loop through a long result set by using the
  offset parameter.  The value
• must be a positive integer and a multiple of 20.
•  
• http//api.nytimes.com/svc/movies/v2/reviews/searc
  h.xml?querylove
• offset40

10
Ordering

• Sort result sets by
• Movie title
• Publication date (the date the review was
  published)
• Opening date (the date the movie opened in NYC)
• DVD release date

11
Additional Fields to Limit By

• Publication date
• Opening date
•  
•  http//api.nytimes.com/svc/movies/v2/reviews/sear
  ch.xml
• ?querylovepublication-date2008-02-14
•  
• Or use a date range
• http//api.nytimes.com/svc/movies/v2/reviews/searc
  h.xml?querylove
• opening-date2008-01-012008-12-31

12
Standard Review Services

• Get all reviewshttp//api.nytimes.com/svc/movies/
  v2/reviews/all.xml
• Get all Critics' Pickshttp//api.nytimes.com/svc/
  movies/v2/reviews/picks.xml
• Get all Critics' Picks on DVDhttp//api.nytimes.c
  om/svc/movies/v2/reviews/dvd-picks.xml

13
Information About NYT Reviewers

• Get a list of all the reviewershttp//api.nytimes
  .com/svc/movies/v2/critics/all.xml
• Get a list of full-time reviewershttp//api.nytim
  es.com/svc/movies/v2/critics/full-time.xml
• Get a list of part-time reviewershttp//api.nytim
  es.com/svc/movies/v2/critics/part-time.xml

14
Get Reviews By a Specific Reviewer

• Put all this together and get all reviews by a
  specific reviewer
• http//api.nytimes.com/svc/movies/v2/reviews/revie
  wer/stephen.holden/all.xml

15
Real-world Uses of the Movie Reviews API
16
Real-world Uses of the Movie Reviews API
17
Real-world Uses of the Movie Reviews API
http//springpadit.com