The New York Times website screenshot

The New York Times

The New York Times is one of the world's most respected news organizations, providing comprehensive journalism across politics, culture, business, science, health, and the arts since 1851. The NYT Developer Network exposes a suite of RESTful APIs enabling developers to search and access NYT articles, best-seller book lists, movie reviews, semantic metadata, top stories, and popular content. All APIs require an API key obtained from the NYT Developer Portal.

The New York Times publishes 7 APIs on the APIs.io network, including Archive API, Content API, Movies API, and 4 more. Tagged areas include Articles, Books, Movies, News, and Media.

The The New York Times catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

The New York Times’ developer surface includes authentication, developer portal, getting-started guide, signup flow, FAQ, GitHub presence, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub
46.1/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFreemiumSelf serve⚡ Free to try
7 APIs
ArticlesBooksMoviesNewsMediaPublishingJournalism

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 46.1/100 · developing
Contract Quality 13.6 / 25
Developer Ergonomics 7.4 / 20
Commercial Clarity 10.5 / 20
Operational Transparency 3.4 / 13
Governance 3.8 / 12
Discoverability 7.4 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/the-new-york-times: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

The New York Times Archive API

The Archive API from The New York Times — 1 operation(s) for archive.

The New York Times Content API

The Content API from The New York Times — 3 operation(s) for content.

The New York Times Movies API

The Movies API from The New York Times — 3 operation(s) for movies.

The New York Times Name API

The Name API from The New York Times — 1 operation(s) for name.

The New York Times Search API

The Search API from The New York Times — 1 operation(s) for search.

The New York Times Stories API

The Stories API from The New York Times — 2 operation(s) for stories.

The New York Times Timestags API

The Timestags API from The New York Times — 1 operation(s) for timestags.

Scroll for all 7

Pricing Plans 1

Published pricing tiers and plan structures.

The New York Times Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

The New York Times Rate Limits

1 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

The New York Times Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

The New York Times Context

40 classes · 2 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

The New York Times API Rules

12 rules · 3 errors 7 warnings

SPECTRAL

The New York Times API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

NYT Article

18 properties

JSON SCHEMA

NYT Best Seller Book

11 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

New York Times Article Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

New York Times Search Articles Example

2 fields

EXAMPLE

New York Times Top Stories Example

2 fields

EXAMPLE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

The New York Times Authentication

apiKey · 1 scheme

SECURITY

The New York Times Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

The New York Times Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

The New York Times Agentic Access

12 operations

12 operations · 0 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Portal
Portal
 GettingStarted
GettingStarted
 Signup
Signup
 Login
Login

Documentation 3

Reference material describing how the API behaves

OpenAPI
OpenAPI
 JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 LlmsText
LlmsText

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

SpectralRuleset
SpectralRuleset
 JSONLDContext
JSONLDContext
 Vocabulary
Vocabulary

Build 3

SDKs, sample code, and the tooling you integrate with

GitHub
GitHub
 SDKs
SDKs
 SDKs
SDKs

Access & Security 3

Authentication, authorization, and security posture

VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

FAQ
FAQ

Commercial 1

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: the-new-york-times
url: https://raw.githubusercontent.com/api-evangelist/the-new-york-times/refs/heads/main/apis.yml
name: The New York Times
description: The New York Times is one of the world's most respected news organizations, providing comprehensive journalism
  across politics, culture, business, science, health, and the arts since 1851. The NYT Developer Network exposes a suite
  of RESTful APIs enabling developers to search and access NYT articles, best-seller book lists, movie reviews, semantic metadata,
  top stories, and popular content. All APIs require an API key obtained from the NYT Developer Portal.
kind: contract
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/the-new-york-times.png
access: 3rd-Party
tags:
- Articles
- Books
- Movies
- News
- Media
- Publishing
- Journalism
created: '2023-10-06T00:00:00.000Z'
modified: '2026-05-19'
position: Consuming
specificationVersion: '0.19'
apis:
- aid: the-new-york-times:the-new-york-times-archive-api
  name: The New York Times Archive API
  description: The Archive API from The New York Times — 1 operation(s) for archive.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Archive
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-archive-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
- aid: the-new-york-times:the-new-york-times-content-api
  name: The New York Times Content API
  description: The Content API from The New York Times — 3 operation(s) for content.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Content
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-content-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
- aid: the-new-york-times:the-new-york-times-movies-api
  name: The New York Times Movies API
  description: The Movies API from The New York Times — 3 operation(s) for movies.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Movies
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-movies-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
- aid: the-new-york-times:the-new-york-times-name-api
  name: The New York Times Name API
  description: The Name API from The New York Times — 1 operation(s) for name.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Name
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-name-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
- aid: the-new-york-times:the-new-york-times-search-api
  name: The New York Times Search API
  description: The Search API from The New York Times — 1 operation(s) for search.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-search-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
- aid: the-new-york-times:the-new-york-times-stories-api
  name: The New York Times Stories API
  description: The Stories API from The New York Times — 2 operation(s) for stories.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Stories
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-stories-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
- aid: the-new-york-times:the-new-york-times-timestags-api
  name: The New York Times Timestags API
  description: The Timestags API from The New York Times — 1 operation(s) for timestags.
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  baseURL: https://api.nytimes.com/svc/archive/v1
  tags:
  - Timestags
  properties:
  - type: OpenAPI
    url: openapi/the-new-york-times-timestags-api-openapi.yml
  - type: Documentation
    url: https://developer.nytimes.com/docs/archive-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/books-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/most-popular-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timestags-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/timeswire-product/1/overview
  - type: Documentation
    url: https://developer.nytimes.com/docs/top-stories-product/1/overview
common:
- type: AgenticAccess
  url: agentic-access/the-new-york-times-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/the-new-york-times-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/the-new-york-times-domain-security.yml
- type: Authentication
  url: authentication/the-new-york-times-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/the-new-york-times
- url: https://developer.nytimes.com/
  type: Portal
- url: https://developer.nytimes.com/get-started
  type: GettingStarted
- url: https://developer.nytimes.com/accounts/create
  type: Signup
- url: https://developer.nytimes.com/accounts/login
  type: Login
- url: https://developer.nytimes.com/terms
  type: TermsOfService
- url: https://developer.nytimes.com/faq
  type: FAQ
- url: https://github.com/nytimes
  type: GitHub
- url: https://nytimes.com
  type: Website
- url: https://github.com/nytimes/public_api_specs
  type: OpenAPI
- url: https://github.com/nytimes/times_wire
  name: Times Wire Ruby Client
  type: SDKs
- url: https://github.com/nytimes/nytcampfin
  name: Campaign Finance Python Client
  type: SDKs
- url: rules/new-york-times-rules.yml
  type: SpectralRuleset
- url: json-schema/new-york-times-article-schema.json
  type: JSONSchema
- url: json-schema/new-york-times-book-schema.json
  type: JSONSchema
- url: json-ld/the-new-york-times-context.jsonld
  type: JSONLDContext
- url: vocabulary/the-new-york-times-vocabulary.yml
  type: Vocabulary
- type: LlmsText
  url: https://developer.nytimes.com/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com