The New York Times Company · Example Payload

Article Search Example

NewsMediaPublishingNewspapersArticlesBooksMoviesSportsGamesCookingReviewsSearchSemanticTaggingControlled VocabularyGeographicArchive

Article Search Example is an example object payload from The New York Times Company, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

statuscopyrightresponse

Example Payload

Raw ↑
{
  "status": "OK",
  "copyright": "Copyright (c) 2026 The New York Times Company. All Rights Reserved.",
  "response": {
    "docs": [
      {
        "abstract": "An overview of the U.S. presidential election results.",
        "web_url": "https://www.nytimes.com/2024/11/06/us/politics/election-results.html",
        "snippet": "Voters across the country cast ballots in Tuesday's presidential election.",
        "lead_paragraph": "Tens of millions of Americans voted on Tuesday in a presidential election whose outcome will shape policy for years.",
        "source": "The New York Times",
        "multimedia": [],
        "headline": {
          "main": "Election Results: A Decisive Outcome",
          "kicker": "Politics",
          "print_headline": "A Decisive Outcome"
        },
        "keywords": [
          {"name": "subject", "value": "Presidential Election of 2024", "rank": 1, "major": "N"},
          {"name": "glocations", "value": "United States", "rank": 2, "major": "N"}
        ],
        "pub_date": "2024-11-06T05:00:00+0000",
        "document_type": "article",
        "news_desk": "Politics",
        "section_name": "U.S.",
        "byline": {
          "original": "By Jonathan Weisman",
          "person": [{"firstname": "Jonathan", "lastname": "Weisman", "rank": 1}],
          "organization": null
        },
        "type_of_material": "News",
        "_id": "nyt://article/abcde-1234-5678",
        "word_count": 1492,
        "uri": "nyt://article/abcde-1234-5678"
      }
    ],
    "meta": {
      "hits": 12453,
      "offset": 0,
      "time": 84
    }
  }
}