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 Lists API

The Lists API from The New York Times Company — 4 operation(s) for lists.

The New York Times Company Lists 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 Lists. 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. 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 0 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 Lists 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.

Lists 4
GET
/lists/{date}/{list}.json
Best Sellers List by Date
GET_lists-date-list-json 3 params → 200
GET
/lists/overview.json
Best Sellers List Overview
GET_lists-overview-format 1 param → 200
GET
/lists/names.json
Best Sellers List Names
GET_lists-names-format → 200
GET
/lists/best-sellers/history.json
Best Sellers List History
GET_lists-best-sellers-history-json 7 params → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

new-york-times-company-lists-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.json API
The New York Times Company Most Popular 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