CloudObjects / Directory / The New York Times / Most Popular API
Sign in

Most Popular API

a wa:WebAPI in The New York Times

Get lists of NYT Articles based on shares, emails, and views.

Base URL

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

Authentication

No authentication methods were specified. Please contact the API provider to get this information!

API Methods

These are the methods supported by the API:

  • GET /mostshared/{section}/{time-period}.json Most Shared by Section & Time Period

    Optional parameters:
    section Limits the results by one or more sections. You can use `all-sections` or one or more section names seperated by semicolons. See `viewed/sections.json` call to get a list of sections.
    time-period Number of days `1 | 7 | 30 ` corresponds to a day, a week, or a month of content.
    Success response:

    An array of Articles

    Status Code 200
    Error response:

    Status Code 400
    
    
  • GET /mostemailed/{section}/{time-period}.json Most Emailed by Section & Time Period

    Optional parameters:
    section Limits the results by one or more sections. You can use `all-sections` or one or more section names seperated by semicolons. See `viewed/sections.json` call to get a list of sections.
    time-period Number of days `1 | 7 | 30 ` corresponds to a day, a week, or a month of content.
    Success response:

    An array of Articles

    Status Code 200
    Error responses:

    Status Code 400

    Status Code 403
    
    
  • GET /mostviewed/{section}/{time-period}.json Most Viewed by Section & Time Period

    Optional parameters:
    section Limits the results by one or more sections. You can use `all-sections` or one or more section names seperated by semicolons. See `viewed/sections.json` call to get a list of sections.
    time-period Number of days `1 | 7 | 30 ` corresponds to a day, a week, or a month of content.
    Success response:

    An array of Articles

    Status Code 200
    
    
Meta
URI / COID
coid://nytimes.cloudobjects.io/MostPopularAPI/V2
Revision
2-441fb62d215ef9a650344813daeb489b
Last updated
2017-05-29 15:27 (UTC)
Created at
2017-11-24 03:37 (UTC)
Usage permission
co:Public