CloudObjects / Directory / The New York Times / Times Newswire API
Sign in

Times Newswire API

a wa:WebAPI in The New York Times

With the Times Newswire API, you can get links and metadata for Times articles and blog posts as soon as they are published on NYTimes.com. The Times Newswire API provides an up-to-the-minute stream of published items.

Base URL

The API endpoint is located at the following URL:
https://api.nytimes.com/svc/news/v3/content

Authentication
API Methods

These are the methods supported by the API:

  • GET /{source}/{section}.json
    Required parameters:
    source Limits the set of items by originating source all = items from both The New York Times and The International New York Times nyt = New York Times items only iht = International New York Times items only
    section Limits the set of items by one or more sections all | One or more section names, separated by semicolons To get all sections, specify all. To get a particular section or sections, use the section names returned by this request: http://api.nytimes.com/svc/news/v3/content/section-list.json
    Optional parameters:
    limit Limits the number of results, between 1 and 20
    offset Sets the starting point of the result set
    Success response:

    An array of Articles

    Status Code 200
    
    
  • GET /{source}/{section}/{time-period}.json
    Required parameters:
    source Limits the set of items by originating source all = items from both The New York Times and The International New York Times nyt = New York Times items only iht = International New York Times items only
    section Limits the set of items by one or more sections all | One or more section names, separated by semicolons To get all sections, specify all. To get a particular section or sections, use the section names returned by this request: http://api.nytimes.com/svc/news/v3/content/section-list.json
    time-period Limits the set of items by time published, integer in number of hours
    Optional parameters:
    limit Limits the number of results, between 1 and 20
    offset Sets the starting point of the result set
    Success response:

    An array of Articles

    Status Code 200
    
    
  • GET /content.json
    Required parameters:
    url The complete URL of a specific news item, URL-encoded or backslash-escaped
    Success response:

    An array of Articles

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