nytimes-api
  • Welcome!
  • Documentation
    • Popular - mostEmailed
    • Popular - mostViewed
    • Popular - mostShared
    • Movies - allCritics
    • Movies - criticsPick
    • Movies - searchCritics
    • Movies - searchReviews
    • Books - bestSellersLists
    • Books - bestSellers
    • Books - overview
    • Books - searchReviews
    • TopStories - sections
    • TopStories - randomSection
    • TopStories - topStories
  • Examples
  • Changelogs
    • 1.0
    • 1.1
    • 1.2
    • 1.2.1
    • 1.3
Powered by GitBook
On this page
  • Example
  • What does it do?
  • Example Response
  1. Documentation

Movies - criticsPick

Example

example.js
const { Movies } = require('nytimes-api');
const movies = new Movies('your-super-secret-api-key');

movies.criticsPick(data => console.log(data);

What does it do?

criticsPick gets today's critic's picks from the New York Times' website. The code example above does the same.

Example Response

example-response.json
  [ { display_title: 'The Competition',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'GLENN KENNY',
      headline:
       '‘The Competition’ Review: Vying for a Slot in an Elite Film School',
      summary_short:
       'In Claire Simon’s engaging, provocative documentary, future filmmakers go through a grueling process.',
      publication_date: '2019-02-21',
      opening_date: '2019-02-22',
      date_updated: '2019-02-21 12:04:06',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/21/movies/the-competition-review.html',
         suggested_link_text: 'Read the New York Times Review of The Competition' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/22/arts/22competition/22competition-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Wrestle',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'JEANNETTE CATSOULIS',
      headline: '‘Wrestle’ Review: On the Mat, Fighting for a Future',
      summary_short:
       'Raw and empathetic, Suzannah Herbert and Lauren Belfer’s vérité portrait of four high-school wrestlers disdains forced uplift.',
      publication_date: '2019-02-21',
      opening_date: '2019-02-22',
      date_updated: '2019-02-21 12:04:03',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/21/movies/wrestle-review.html',
         suggested_link_text: 'Read the New York Times Review of Wrestle' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/19/arts/wrestle1/wrestle1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'A Tuba to Cuba',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'JEANNETTE CATSOULIS',
      headline:
       '‘A Tuba to Cuba’ Review: A New Orleans Jazz Band Makes a Caribbean Connection',
      summary_short:
       'This joyous documentary follows the Preservation Hall Jazz Band to Cuba for a celebration of musical history and common bonds.',
      publication_date: '2019-02-14',
      opening_date: '2019-02-15',
      date_updated: '2019-02-21 03:44:22',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/14/movies/a-tuba-to-cuba-review.html',
         suggested_link_text: 'Read the New York Times Review of A Tuba to Cuba' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/15/arts/15tuba1/tuba1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Fighting with My Family',
      mpaa_rating: 'PG-13',
      critics_pick: 1,
      byline: 'MANOHLA DARGIS',
      headline:
       '‘Fighting With My Family’ Review: They Body Slam You, Your Mum and Dad. Lovingly.',
      summary_short:
       'Dwayne Johnson helped produce this charming comedy about a family of professional wrestlers, their chops, drops and drama.',
      publication_date: '2019-02-13',
      opening_date: '2019-02-14',
      date_updated: '2019-02-21 03:44:20',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/13/movies/fighting-with-my-family-review.html',
         suggested_link_text: 'Read the New York Times Review of Fighting with My Family' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/15/arts/15fightingwith-1/merlin_150317973_37f88b4b-da96-4fb4-b48f-905888f1e4e0-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Clara\'s Ghost',
      mpaa_rating: 'Not Rated',
      critics_pick: 1,
      byline: 'TEO BUGBEE',
      headline:
       '‘Clara’s Ghost’ Review: A Family of Performers, a Night of Hysteria',
      summary_short:
       'This unhinged comedy shines a spotlight on a family’s maladjusted dynamics.',
      publication_date: '2019-02-13',
      opening_date: '2018-12-06',
      date_updated: '2019-02-13 21:24:03',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/13/movies/claras-ghost-review.html',
         suggested_link_text: 'Read the New York Times Review of Clara\'s Ghost' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/12/movies/clara1/clara1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Sorry Angel',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'GLENN KENNY',
      headline:
       '‘Sorry Angel’ Review: A Love Affair Two Men Start, Knowing the End',
      summary_short:
       'Set in early 1990s Paris, Christophe Honoré’s new film presents us with a middle-aged, H.I.V.-stricken writer falling, wearily, for a bookish 20-something.',
      publication_date: '2019-02-12',
      opening_date: '2019-02-15',
      date_updated: '2019-02-21 03:44:19',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/12/movies/sorry-angel-review.html',
         suggested_link_text: 'Read the New York Times Review of Sorry Angel' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/15/arts/15sorryangel/15sorryangel-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Birds of Passage',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'A.O. SCOTT',
      headline:
       '‘Birds of Passage’ Review: An Epic Narco Tale That Will Open Your Eyes',
      summary_short:
       'Cristina Gallego and Ciro Guerra follow their Oscar-nominated “Embrace of the Serpent” with a saga of the drug trade set amid the Wayuu of northern Colombia.',
      publication_date: '2019-02-12',
      opening_date: '2019-02-13',
      date_updated: '2019-02-21 03:44:18',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/12/movies/birds-of-passage-review.html',
         suggested_link_text: 'Read the New York Times Review of Birds of Passage' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/13/arts/13birdsofpassage3-dress/13birdsofpassage3-dress-mediumThreeByTwo210-v2.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'High Flying Bird',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'A.O. SCOTT',
      headline: '‘High Flying Bird’ Review: A Thrilling Dunk on Capitalism',
      summary_short:
       'The director Steven Soderbergh teams up with Tarell Alvin McCraney and André Holland to take on the contradictions of modern sports culture.',
      publication_date: '2019-02-07',
      opening_date: '2019-02-08',
      date_updated: '2019-02-15 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/07/movies/high-flying-bird-review.html',
         suggested_link_text: 'Read the New York Times Review of High Flying Bird' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/08/arts/08high-flying-2/08high-flying-2-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'One Million American Dreams',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'GLENN KENNY',
      headline:
       '‘One Million American Dreams’ Review: Stories From New York’s Potter’s Field',
      summary_short:
       'This haunting documentary guides viewers through heartbreaking tales of the lost souls buried on Hart Island.',
      publication_date: '2019-02-07',
      opening_date: '2019-02-08',
      date_updated: '2019-02-15 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/07/movies/one-million-american-dreams-review.html',
         suggested_link_text:
          'Read the New York Times Review of One Million American Dreams' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/08/arts/08onemillion/08onemillion-mediumThreeByTwo210-v2.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'The Oscar Nominated Short Films 2019: Animation',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'BILGE EBIRI',
      headline:
       '‘The 2019 Oscar Nominated Short Films’ Review: Heartbreak, Abbreviated',
      summary_short:
       'This year’s Oscar-nominated shorts will make you cry, laugh, cry, think, cry, wonder, and cry some more. Have we mentioned they might also make you cry?',
      publication_date: '2019-02-06',
      opening_date: null,
      date_updated: '2019-02-08 16:24:03',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/06/movies/2019-oscar-nominated-short-films-review.html',
         suggested_link_text:
          'Read the New York Times Review of The Oscar Nominated Short Films 2019: Animation' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/08/arts/08oscarshorts1/08oscarshorts1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'The Oscar Nominated Short Films 2019: Documentary',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'BILGE EBIRI',
      headline:
       '‘The 2019 Oscar Nominated Short Films’ Review: Heartbreak, Abbreviated',
      summary_short:
       'This year’s Oscar-nominated shorts will make you cry, laugh, cry, think, cry, wonder, and cry some more. Have we mentioned they might also make you cry?',
      publication_date: '2019-02-06',
      opening_date: null,
      date_updated: '2019-02-08 16:24:04',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/02/06/movies/2019-oscar-nominated-short-films-review.html',
         suggested_link_text:
          'Read the New York Times Review of The Oscar Nominated Short Films 2019: Documentary' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/08/arts/08oscarshorts1/08oscarshorts1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Daughter of Mine',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'JEANNETTE CATSOULIS',
      headline: '‘Daughter of Mine’ Review: Lessons in Imperfect Parenting',
      summary_short:
       'Ardent and primal, Laura Bispuri’s drama addresses complicated ideas with head-clearing simplicity.',
      publication_date: '2019-01-31',
      opening_date: '2019-02-01',
      date_updated: '2019-02-15 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/31/movies/daughter-of-mine-review.html',
         suggested_link_text: 'Read the New York Times Review of Daughter of Mine' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/01/arts/01daughter1/daughter1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Velvet Buzzsaw',
      mpaa_rating: 'R',
      critics_pick: 1,
      byline: 'GLENN KENNY',
      headline: '‘Velvet Buzzsaw’ Review: Art Snobs Get a Gory Comeuppance',
      summary_short:
       'In this bilious satire, Jake Gyllenhaal plays an art critic on the edge of sanity as the paintings he covets turn murderous.',
      publication_date: '2019-01-30',
      opening_date: '2019-02-01',
      date_updated: '2019-02-15 03:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/30/movies/velvet-buzzsaw-review.html',
         suggested_link_text: 'Read the New York Times Review of Velvet Buzzsaw' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/02/01/arts/01velvet/01velvet-mediumThreeByTwo210-v2.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Never Fear',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'MANOHLA DARGIS',
      headline:
       'Review: Revisiting a Film from Ida Lupino, Hollywood Star Turned Director',
      summary_short:
       '“Never Fear,” a 1949 movie directed by Lupino that has been superbly restored, tells the story of a dancer felled by polio.',
      publication_date: '2019-01-24',
      opening_date: '1950-01-01',
      date_updated: '2019-02-01 17:44:02',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/24/movies/never-fear-the-young-lovers-review.html',
         suggested_link_text: 'Read the New York Times Review of Never Fear' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/25/arts/25neverfear/25neverfear-mediumThreeByTwo210-v2.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'The Image Book',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'A.O. SCOTT',
      headline:
       '‘The Image Book’ Review: Godard Looks at Violence, and Movies',
      summary_short:
       'Jean-Luc Godard’s latest film is a gloomy, lively essay on some disturbing history, cinema and himself.',
      publication_date: '2019-01-23',
      opening_date: '2019-01-25',
      date_updated: '2019-02-18 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/23/movies/review-the-image-book.html',
         suggested_link_text: 'Read the New York Times Review of The Image Book' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/25/arts/25theimagebook1/merlin_149292291_281bb838-6d4b-40b0-a418-111dadf88c9b-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'The 5 Browns',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'GLENN KENNY',
      headline:
       '‘The 5 Browns’ Review: United by Music and Scarred by Sexual Abuse',
      summary_short:
       'A new documentary tells the painful but ultimately hopeful story of a classical music quintet of siblings, three of whom were molested by their father.',
      publication_date: '2019-01-22',
      opening_date: '2019-01-23',
      date_updated: '2019-01-22 14:24:02',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/22/movies/the-5-browns-digging-through-the-darkness-review.html',
         suggested_link_text: 'Read the New York Times Review of The 5 Browns' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/23/arts/23thefivebrowns1/23thefivebrowns1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Who Will Write Our History',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'KEN JAWOROWSKI',
      headline:
       '‘Who Will Write Our History’ Review: A Vital Holocaust Documentary',
      summary_short:
       'The film, directed by Roberta Grossman, tells the story of Oyneg Shabes, a group of Jews imprisoned in the Warsaw Ghetto who worked to document their culture.',
      publication_date: '2019-01-17',
      opening_date: '2018-07-21',
      date_updated: '2019-02-17 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/17/movies/who-will-write-our-history-review.html',
         suggested_link_text:
          'Read the New York Times Review of Who Will Write Our History' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/18/arts/18whowill1/whowill1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Don\'t Come Back from the Moon',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'JEANNETTE CATSOULIS',
      headline:
       '‘Don’t Come Back From the Moon’ Review: When Men Leave, Children Grow Up.',
      summary_short:
       'Blending shimmering photography and a compassionate tone, Bruce Thierry Cheung’s wistful tale of abandoned children is unexpectedly haunting.',
      publication_date: '2019-01-17',
      opening_date: '2019-01-18',
      date_updated: '2019-01-25 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/17/movies/dont-come-back-from-the-moon-review.html',
         suggested_link_text:
          'Read the New York Times Review of Don\'t Come Back from the Moon' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/18/arts/18dont1/dont1-mediumThreeByTwo210-v2.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'The Heiresses',
      mpaa_rating: '',
      critics_pick: 1,
      byline: 'A.O. SCOTT',
      headline:
       '‘The Heiresses’ Review: A Surprising Drama of Status and Sexuality',
      summary_short:
       'Marcelo Martinessi’s debut feature from Paraguay will probably defy your initial expectations about the story.',
      publication_date: '2019-01-15',
      opening_date: null,
      date_updated: '2019-02-15 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/15/movies/the-heiresses-review.html',
         suggested_link_text: 'Read the New York Times Review of The Heiresses' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/16/arts/16theheiresses/16theheiresses-mediumThreeByTwo210-v3.jpg',
         width: 210,
         height: 140 } },
    { display_title: 'Grave of the Fireflies',
      mpaa_rating: 'Not Rated',
      critics_pick: 1,
      byline: 'GLENN KENNY',
      headline:
       '‘Grave of the Fireflies’ Review: A Pioneering Animated Classic',
      summary_short:
       'Isao Takahata’s 1988 masterpiece finally gets a proper theatrical run in New York.',
      publication_date: '2019-01-03',
      opening_date: '1989-07-26',
      date_updated: '2019-01-18 17:44:01',
      link:
       { type: 'article',
         url:
          'http://www.nytimes.com/2019/01/03/movies/grave-of-the-fireflies-review.html',
         suggested_link_text: 'Read the New York Times Review of Grave of the Fireflies' },
      multimedia:
       { type: 'mediumThreeByTwo210',
         src:
          'https://static01.nyt.com/images/2019/01/04/arts/04grave1/grave1-mediumThreeByTwo210.jpg',
         width: 210,
         height: 140 } } ]
PreviousMovies - allCriticsNextMovies - searchCritics

Last updated 6 years ago