GET/nyt/articleapiKey3 credits/request
Returns a New York Times article by canonical `url`, with `title`, `description`, `published_at`, `updated_at`, `section`, `authors`, `keywords`, `image_url` and the body `paragraphs` in order. Query strings and fragments are stripped. A subscription barrier returns `403`, and non-article or non-NYT URLs return `400`.
Required: url.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: published_at: 2026-09-20; section: “U.S.”; url: nytimes.com; title: 44 characters; authors: 2 entries; description: 165 characters; updated_at: 2026-09-20; image_url: static01.nyt.com.
Open in Playground
GET/nyt/authorapiKey3 credits/request
Returns one New York Times contributor's public byline page: name, tagline, About/Contact panels, and their recent articles from a canonical author URL.
Required: url.
Sampled 14 Oct 2026: 10 items. Filled in every item: title, url, description, authors. Not in every item: image_url (9). In the sample: url: nytimes.com; description: median 136 characters; authors: median 3 entries; image_url: static01.nyt.com.
Open in Playground
GET/nyt/categoriesapiKey1 credit/request
Lists the public New York Times editorial navigation taxonomy, including top-level categories and nested destinations. Use /nyt/sections for the separately verified RSS-backed section values accepted by /nyt/headlines; product links, newsletters, and podcasts are not included as article categories.
Takes no parameters.
Sampled 14 Oct 2026: 12 items. Filled in every item: slug, name, url. Not in every item: sections (3). In the sample: name: “U.S.” and 11 other values; url: nytimes.com and 1 other host; sections: median 9 entries.
Open in Playground
GET/nyt/headlinesapiKey1 credit/request
Returns a New York Times section RSS feed: each story's title, canonical URL, description, author, publication time, and lead image. Section must be a slug returned by /nyt/sections.
Required: section.
Sampled 14 Oct 2026: 51 items. Filled in every item: title, url, description, author, published_at. Not in every item: image_url (47). In the sample: published_at: “Tue, 13 Oct 2026 13:17:24 +0000” and 50 other values; url: nytimes.com; title: median 63 characters; description: median 113 characters; image_url: static01.nyt.com.
Open in Playground
GET/nyt/sectionsapiKey1 credit/request
Lists the New York Times section slugs accepted by `nyt-headlines`, such as `World` and `Business`, each with its display `name` and `url`. It covers only the sections that endpoint takes; use `nyt-categories` for the broader site navigation, including Politics, DealBook and Wirecutter.
Takes no parameters.
Sampled 14 Oct 2026: 24 items. Filled in every item: slug, name, url. In the sample: name: “Home Page” and 23 other values; url: rss.nytimes.com.
Open in Playground