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
{
"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.
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 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.