Nytimes APInytimes.com ↗
Fetch recent NYT articles by section via a single API endpoint. Returns title, URL, summary, authors, publication date, and thumbnail for each article.
What is the Nytimes API?
The New York Times API gives developers access to recent articles across NYT editorial sections through a single endpoint, get_section_articles. Each response includes up to 7 fields per article — title, URL, summary, published date, kicker label, authors, and thumbnail image URL — covering sections from world news and technology to opinion and sports.
curl -X GET 'https://api.parse.bot/scraper/4de61c33-f401-4faa-83eb-9921e06d1b0b/get_section_articles?section=technology' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nytimes-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: nytimes_com_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.nytimes_com_api import NYTimes, SectionNotFound
client = NYTimes()
# List recent articles from the technology section
for article in client.articles.list(section="technology", limit=3):
print(article.title, article.published_date, article.authors)
# Get the first article from world news
item = client.articles.list(section="world", limit=1).first()
if item:
print(item.title, item.url, item.summary)
# Handle a non-existent section
try:
client.articles.list(section="nonexistent", limit=1).first()
except SectionNotFound as e:
print("section not found:", e.section)
print("exercised: articles.list")
Fetches recent articles from a given NYT section. Returns a list of articles with title, URL, summary, publication date, kicker label, authors, and thumbnail image URL. Sections include world, us, business, technology, science, health, arts, sports, opinion, and others matching the nytimes.com/section/ navigation.
| Param | Type | Description |
|---|---|---|
| section | string | NYT section slug (e.g. world, us, business, technology, science, health, arts, sports, opinion). |
{
"type": "object",
"fields": {
"section": "the section slug that was queried",
"articles": "array of article objects with title, url, summary, published_date, kicker, authors, image_url"
},
"sample": {
"data": {
"section": "technology",
"articles": [
{
"url": "https://www.nytimes.com/2026/07/09/technology/personaltech/iphone-android-health-tracking.html",
"title": "How to Turn Your Phone Into a Personal Health Dashboard",
"kicker": "Tech Tip",
"authors": [
"J. D. Biersdorfer"
],
"summary": "Free apps from Google, Samsung and Apple can help you track your diet, exercise and well-being.",
"image_url": "https://static01.nyt.com/images/2026/07/20/technology/personaltech/08BIZ-TECHTIP-TOPART/08BIZ-TECHTIP-TOPART-jumbo.jpg",
"published_date": "2026-07-09T09:02:09.000Z"
}
]
},
"status": "success"
}
}About the Nytimes API
What the API Returns
The get_section_articles endpoint accepts a section parameter and returns a structured response with two top-level fields: section (the slug that was queried) and articles (an array of article objects). Each article object contains title, url, summary, published_date, kicker, authors, and image_url. The kicker field is the short label NYT displays above a headline — useful for distinguishing news sub-types like "Opinion", "News Analysis", or a beat label.
Sections and Parameters
The section input is a string slug and is optional. Supported values include world, us, business, technology, science, health, arts, sports, and opinion, among others. If you omit the parameter, the endpoint falls back to a default section. There is no pagination parameter — the endpoint returns the most recent articles available for the given section at the time of the call.
Data Shape and Freshness
The authors field returns an array of byline contributors for each article. The image_url field points to a thumbnail used in NYT section listings, which may be absent for some articles. The published_date field reflects the article's original publication timestamp, not an update timestamp, so articles that are significantly corrected or updated after publication will still show the original date.
The Nytimes API is a managed, monitored endpoint for nytimes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nytimes.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nytimes.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live NYT technology news feed on a developer dashboard using the
technologysection slug - Aggregate article
summaryandpublished_datefields to build a daily briefing digest - Pull
image_urlandtitlefrom multiple sections to populate a news widget with thumbnails - Monitor the
opinionsection for new bylines by tracking theauthorsfield across requests - Build a cross-section search index by iterating through section slugs and storing
urlandkickervalues - Alert on breaking health or science articles by polling the
healthandsciencesections on a schedule
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The New York Times have an official developer API?+
What does the `kicker` field contain and how is it different from `title`?+
kicker is the short label NYT displays above a headline — typically a beat, desk, or content-type label such as "News Analysis", "Opinion", or a geographic label. It is separate from the article title and can be useful for filtering or categorizing articles by content type without parsing the headline text.Does the API support full article body text?+
title, url, summary, published_date, kicker, authors, and image_url — but not the full article body. You can fork this API on Parse and revise it to add an endpoint that retrieves article body content.Can I search articles by keyword or date range?+
get_section_articles endpoint filters only by section slug and returns the most recent articles for that section; there is no keyword search or date-range parameter. You can fork this API on Parse and revise it to add a search endpoint.Are there any articles that won't appear in section results?+
image_url field may be empty for articles that do not have a section thumbnail assigned.