New York Times API

With the New York Times Article Search API, you can search New York Times articles from 1981 to today, retrieving headlines, abstracts, lead paragraphs, links to associated multimedia, and other article metadata.

Configuring New York Times API as a Connection

  1. Click the + (plus) button and select Connection or right-click in the browser and select Create new > Connection.     
  2. Choose New York Times Api from the drop-down list.
  3. To connect to The New York Times Article Search API, enter the API key you register for at the NY Times development site. Then check that you understand the terms and conditions at http://developer.nytimes.com/Api_terms_of_use.
  4. If required, add a description and click Save.

Importing Data with the New York Times Article Search API Connector 

  1. Click the + (plus) button and select Connection or right-click in the browser and select Create new > Connection.     
  2. Click Select Connector, choose the New York Times API connector, and click Next.
  3. Enter the query, begin/end dates, and how you want to rank the search and click Next.
  4. Review the defined fields and click Next.
  5. Review the schedule and advanced properties for the job and click Next.
  6. Create a description for the import job and click Save.

The article search API limits requests beyond the 1000th result for performance reasons. This limit comes from the New York Times, not Datameer. If a job appears with Completed with Warnings, it has reached this limit. The best way to advance past the 1000th result is to make import jobs with shorter publication date ranges, so that you have fewer results.