Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

The New York Times Company Most Popular API

The Most Popular API from The New York Times Company — 4 operation(s) for most popular.

The New York Times Company Most Popular API is one of 15 APIs that The New York Times Company publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include Most Popular. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a status page, and 5 JSON Schemas.

This API exposes 4 operations across 4 paths, and defines 5 schemas. It is described by OpenAPI 2.0, at version 2.0.0.

Requests are made against the base URL https://api.nytimes.com/svc/search/v2.

4 operations 4 paths 5 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2.0.0
Base URL
https://api.nytimes.com/svc/search/v2
Authentication
API Key
Resource Areas
1

Authentication & Security 1

The New York Times Company Most Popular API declares 1 security scheme for authenticating requests. An API key is passed in the query as api-key (apikey). By default, every request must be authenticated.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

Most Popular 4
GET
/emailed/{period}.json
Most emailed articles on NYTimes.com.
1 param → 200401429
GET
/shared/{period}.json
Most shared articles on NYTimes.com.
1 param → 200401429
GET
/shared/{period}/{share_type}.json
Most shared articles on NYTimes.com of specified share type.
2 params → 200401429
GET
/viewed/{period}.json
Most viewed articles on NYTimes.com.
1 param → 200401429

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are SharedArticle (24 properties), EmailedArticle (24 properties), ViewedArticle (19 properties), Media (6 properties). Each schema is shown below with its type and property counts.

EmailedArticle
object
24 properties
SharedArticle
object
24 properties
ViewedArticle
object
19 properties
MediaMetadata
object
4 properties
Media
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

new-york-times-company-most-popular-api-openapi.yml Raw ↑

Other APIs The New York Times Company publishes across the network.

The New York Times Company Archive API
The New York Times Company Content API
The New York Times Company Content.json API
The New York Times Company Events API
The New York Times Company Lists API
The New York Times Company Lists.json API
The New York Times Company Movies API
The New York Times Company Name API
The New York Times Company Reviews.json API
The New York Times Company Search API
The New York Times Company Search.json API
The New York Times Company Stories API