Stories
Top Stories
The Top Stories API returns a list of articles and associated images currently on the specified section. Support JSON and JSONP.
get/{section}.{format}
Request
- Base URLhttp://api.nytimes.com/svc/topstories/v2
- AuthAPI key in query parameter api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
section'home' | 'opinion' | 'world' | 'national' | 'politics' | 'upshot' | 'nyregion' | 'business' | 'technology' | 'science' | 'health' | 'sports' | 'arts' | 'books' | 'movies' | 'theater' | 'sundayreview' | 'fashion' | 'tmagazine' | 'food' | 'travel' | 'magazine' | 'realestate' | 'automobiles' | 'obituaries' | 'insider' required
The section the story appears in.
format'json' | 'jsonp' required
if this is JSONP or JSON
Query parameters
callbackstring
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.
Response
An array of articles
Changes
No recorded changes to this operation across all 9 revisions of this API.