Nytimes APInytimes.com ↗
Fetch NYT articles by section or keyword with 7 response fields per article including title, URL, authors, summary, and thumbnail image.
What is the Nytimes API?
The New York Times API gives developers structured access to NYT content through 2 endpoints: get_section_articles for browsing articles by topic section and search_articles for keyword-driven queries. Each article object returns up to 7 fields — title, URL, summary, publication date, kicker label, authors, and thumbnail image URL — covering sections from world news and technology to sports and opinion.
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_fork 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)
# Search for articles by keyword and drill into the first result
item = client.articles.search(query="climate", limit=1).first()
if item:
print(item.title, item.url, item.summary)
# Handle a non-existent section gracefully
try:
client.articles.list(section="nonexistent", limit=1).first()
except SectionNotFound as e:
print("section not found:", e.section)
print("exercised: articles.list / articles.search")
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
Section Browsing
get_section_articles accepts a section slug — such as world, us, business, technology, science, health, arts, sports, or opinion — and returns a list of recent articles from that section. Each article in the articles array includes a title, url, summary, published_date, kicker (the label shown above the headline), authors, and image_url. The response also echoes back the section slug that was queried, which is useful for routing results in multi-section applications.
Keyword Search
search_articles takes a required query string and returns up to 10 results per page. Use the page parameter (zero-based index) to paginate through results, and the sort parameter to choose between best (relevance-ranked) and newest (chronological). The response object echoes page, sort, and query alongside the articles array, which shares the same 7-field structure as the section endpoint — making it straightforward to merge results from both endpoints in a single data model.
Response Shape
Both endpoints return the same article object structure: title, url, summary, published_date, kicker, authors, and image_url. The kicker field carries the short label NYT displays above the headline (e.g. "Politics" or "Climate"), which can serve as a secondary classification signal beyond the section slug. The authors field is an array of byline names. image_url points to the article's thumbnail where one is available.
Coverage Notes
Section slugs correspond to NYT's standard editorial sections. Not all sections carry equal article volume at any given time; less-active sections may return shorter lists. The search_articles endpoint surfaces results from the first page of NYT search results by default, with additional pages accessible via the page parameter.
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?+
- Build a news digest app that pulls the latest articles from multiple NYT sections using
get_section_articlesand displays thumbnails viaimage_url. - Monitor NYT coverage of a specific topic by polling
search_articleswith a keyword query sorted bynewest. - Aggregate
published_dateandsectiondata across sections to analyze NYT editorial output over time. - Populate a sidebar of related articles by searching for article keywords and returning matching
titleandurlpairs. - Track which authors (
authorsfield) appear most frequently on a given topic by running repeated keyword searches. - Feed a content curation tool that categorizes articles using
kickerlabels from both section and search results. - Build a media monitoring dashboard that alerts when specific keywords appear in new NYT articles using the
newestsort order.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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 `section`?+
kicker is the short editorial label NYT displays above a headline — for example, 'Climate', 'Supreme Court', or 'N.F.L.' It is more granular than the section slug and is set per article by editors. The section slug reflects the top-level section the article was filed under, while kicker can act as a finer topic tag within that section.Does `search_articles` return more than 10 results at a time?+
page parameter to retrieve subsequent pages. There is no built-in maximum page limit documented, but result availability depends on what NYT's search surface returns for a given query.Does the API return full article body text?+
title, url, summary, published_date, kicker, authors, and image_url — but not the full article body text, which sits behind NYT's subscription paywall. The API covers article metadata and summaries. You can fork this API on Parse and revise it to add a dedicated endpoint if a specific metadata field from the article page is missing.Can I filter articles by a specific author or date range?+
get_section_articles endpoint filters only by section slug, and search_articles filters by keyword query with sort options for relevance or newest. Author-based or date-range filtering is not exposed. You can fork this API on Parse and revise it to add the missing filtering endpoint.