CloudObjects / Directory / The New York Times / Top Stories
Sign in

Top Stories

a wa:WebAPI in The New York Times

The Top Stories API provides lists of articles and associated images by section.

Base URL

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

Authentication
API Methods

These are the methods supported by the API:

  • GET /{section}.{format} Top Stories

    The Top Stories API returns a list of articles and associated images currently on the specified section. Support JSON and JSONP.

    Required parameters:
    section The section the story appears in.
    format if this is JSONP or JSON
    Optional parameters:
    callback The name of the function the API call results will be passed to. Required when using JSONP. This parameter has only one valid value per section. The format is {section_name}TopStoriesCallback.
    Success response:

    An array of articles

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