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
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This example
curl "https://apis.io/api/v1/examples/article-search-example"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.