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.
type: Contract
image: https://kinlane-productions2.s3.amazonaws.com/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-03'
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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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-productions2.s3.amazonaws.com/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:
  - url: https://developer.nytimes.com/
    type: Portal
  - url: https://developer.nytimes.com/get-started
    type: Getting Started
  - 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: SDK
  - url: https://github.com/nytimes/nytcampfin
    name: Campaign Finance Python Client
    type: SDK
  - url: rules/new-york-times-rules.yml
    type: SpectralRuleset
  - url: capabilities/article-research.yaml
    type: NaftikoCapability
  - url: capabilities/content-discovery.yaml
    type: NaftikoCapability
  - url: capabilities/metadata-enrichment.yaml
    type: NaftikoCapability
  - 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

maintainers:
  - FN: Kin Lane
    email: [email protected]