The New York Times · Example Payload

New York Times Search Articles Example

ArticlesBooksMoviesNewsMediaPublishingJournalism

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

Top-level fields

requestresponse

Example Payload

Raw ↑
{
  "request": {
    "method": "GET",
    "url": "https://api.nytimes.com/svc/search/v2/articlesearch.json",
    "params": {
      "q": "artificial intelligence",
      "begin_date": "20240101",
      "end_date": "20240131",
      "sort": "newest",
      "api-key": "YOUR_API_KEY"
    }
  },
  "response": {
    "status": "OK",
    "copyright": "Copyright (c) 2024 The New York Times Company. All Rights Reserved.",
    "response": {
      "docs": [
        {
          "_id": "nyt://article/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "web_url": "https://www.nytimes.com/2024/01/15/technology/artificial-intelligence-regulation.html",
          "snippet": "Lawmakers are pushing for new rules to govern artificial intelligence systems.",
          "lead_paragraph": "Congress is moving forward with legislation that would impose new requirements on companies developing artificial intelligence systems.",
          "abstract": "Federal lawmakers introduced a bipartisan bill to regulate AI systems used in critical infrastructure.",
          "print_page": "A1",
          "source": "The New York Times",
          "headline": {
            "main": "Congress Moves to Regulate Artificial Intelligence",
            "kicker": "Technology Policy",
            "print_headline": "A.I. Regulation Bill Advances in Senate"
          },
          "byline": {
            "original": "By JANE DOE and JOHN SMITH",
            "person": [
              { "firstname": "Jane", "lastname": "Doe", "role": "reported" },
              { "firstname": "John", "lastname": "Smith", "role": "reported" }
            ]
          },
          "keywords": [
            { "name": "subject", "value": "Artificial Intelligence", "rank": 1 },
            { "name": "organizations", "value": "Senate", "rank": 2 }
          ],
          "pub_date": "2024-01-15T10:00:00+0000",
          "document_type": "article",
          "news_desk": "Technology",
          "section_name": "Technology",
          "type_of_material": "News",
          "word_count": 1250
        }
      ],
      "meta": {
        "hits": 342,
        "offset": 0,
        "time": 423
      }
    }
  }
}

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/new-york-times-search-articles-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 email required.

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