The New York Times

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
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
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:archive-api
  name: The New York Times Archive API
  description: The Archive API returns an array of NYT articles for a given month, going back to 1851. Its response fields
    are the same as the Article Search API. Use it to build your own local database of NYT article metadata.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/archive/v1
  humanURL: https://developer.nytimes.com/docs/archive-product/1/overview
  tags:
  - Archive
  - Articles
  - Months
  - Years
  - History
  properties:
  - url: https://developer.nytimes.com/docs/archive-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-archive-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:article-search-api
  name: The New York Times Article Search API
  description: Use the Article Search API to look up articles by keyword. You can refine your search using filters and facets.
    The API searches NYT articles from September 18, 1851 to today, retrieving headlines, abstracts, lead paragraphs, links
    to associated multimedia and other article metadata.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/search/v2
  humanURL: https://developer.nytimes.com/docs/articlesearch-product/1/overview
  tags:
  - Articles
  - Search
  - Keywords
  - Facets
  properties:
  - url: https://developer.nytimes.com/docs/articlesearch-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-article-search-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:books-api
  name: The New York Times Books API
  description: The Books API provides information about book reviews and The New York Times Best Sellers lists. Access current
    and historical bestseller lists, book details, and NYT critic reviews.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/books/v3
  humanURL: https://developer.nytimes.com/docs/books-product/1/overview
  tags:
  - Books
  - Best Sellers
  - Reviews
  - Lists
  properties:
  - url: https://developer.nytimes.com/docs/books-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-books-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:most-popular
  name: The New York Times Most Popular API
  description: The Most Popular API provides services for getting the most popular articles on NYTimes.com based on emails,
    shares, or views. Retrieve the most emailed, shared, and viewed articles by section and time period.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/mostpopular/v2
  humanURL: https://developer.nytimes.com/docs/most-popular-product/1/overview
  tags:
  - Articles
  - Popular
  - Social Sharing
  - Trending
  properties:
  - url: https://developer.nytimes.com/docs/most-popular-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-most-popular-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:movie-reviews-api
  name: The New York Times Movie Reviews API
  description: Search for NYT movie reviews by keyword and get lists of NYT Critics' Picks. As an alternative, use the Article
    Search API with appropriate filter queries to access movie review content.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/movies/v2
  humanURL: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
  tags:
  - Movies
  - Reviews
  - Critics
  - Film
  properties:
  - url: https://developer.nytimes.com/docs/movie-reviews-api/1/overview
    type: Documentation
  - url: openapi/new-york-times-movie-review-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:semantic-api
  name: The New York Times Semantic API
  description: The Semantic API complements the Articles API. With the Semantic API, you get access to the long list of people,
    places, organizations and other locations, entities and descriptors that make up the controlled vocabulary used as metadata
    by The New York Times.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/semantic/v2
  humanURL: https://developer.nytimes.com/docs/semantic-api-product/1/overview
  tags:
  - Concepts
  - Semantics
  - Metadata
  - Entities
  - People
  - Organizations
  properties:
  - url: https://developer.nytimes.com/docs/semantic-api-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-semantic-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:timestags-api
  name: The New York Times TimesTags API
  description: With the TimesTags API, you can mine the riches of the New York Times tag set. The TimesTags service matches
    your query to the controlled vocabularies that fuel NYTimes.com metadata. Note this API is deprecated; equivalent functionality
    is available through the Semantic API.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/suggest/v1
  humanURL: https://developer.nytimes.com/docs/timestags-product/1/overview
  tags:
  - Tags
  - Autocomplete
  - Metadata
  - Search
  properties:
  - url: https://developer.nytimes.com/docs/timestags-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-times-tags-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:times-newswire-api
  name: The New York Times Times Newswire API
  description: With the Times Newswire API, you can get links and metadata for Times articles as soon as they are published
    on NYTimes.com. The Times Newswire API provides an up-to-the-minute stream of published articles by section and source.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/news/v3
  humanURL: https://developer.nytimes.com/docs/timeswire-product/1/overview
  tags:
  - News
  - Wire
  - Streaming
  - Articles
  - Sections
  properties:
  - url: https://developer.nytimes.com/docs/timeswire-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-times-newswire-openapi-original.yml
    type: OpenAPI
- aid: the-new-york-times:top-stories
  name: The New York Times Top Stories API
  description: The Top Stories API returns an array of articles currently on the specified section (arts, business, health,
    home, etc.) of NYTimes.com. Use the home section to get articles currently on the homepage.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.nytimes.com/svc/topstories/v2
  humanURL: https://developer.nytimes.com/docs/top-stories-product/1/overview
  tags:
  - Articles
  - Top Stories
  - Sections
  - News
  properties:
  - url: https://developer.nytimes.com/docs/top-stories-product/1/overview
    type: Documentation
  - url: openapi/new-york-times-top-stories-openapi-original.yml
    type: OpenAPI
common:
- 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