GET/nymag/articleapiKey2 credits/request
Returns a New York Magazine article by its canonical `url`: title, description, section, authors, lead image, publication and update times, a `paywalled` flag and the body `paragraphs`. Subscriber-only or blocked articles return an upstream error.
Required: url.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: published_at: 2026-09-21; section: “Politics”; url: nymag.com; title: 54 characters; authors: 1 entry; description: 161 characters; updated_at: 2026-09-21; image_url: pyxis.nymag.com.
Open in Playground
GET/nymag/authorapiKey2 credits/request
Returns a New York Magazine author profile from a required `url` in the form `https://nymag.com/author/<slug>/`. The response has `name`, `job_title` (empty for some contributors), `bio` and recent articles with title, URL, `excerpt` and a `section` label. Each article's `published_at` is the page's date text, such as `Sept. 20, 2026`, not a timestamp.
Required: url.
Sampled 14 Oct 2026: 50 items. Filled in every item: title, url, section, excerpt, published_at. In the sample: url: nymag.com; title: median 46 characters; excerpt: median 83 characters.
Open in Playground
GET/nymag/headlinesapiKey1 credit/request
Returns recent New York Magazine stories for one site section. `section` is required and takes one of nine slugs: `intelligencer`, `thecut`, `vulture`, `grub-street`, `curbed`, `strategist`, `select-all`, `science` or `daily`. Each item has a title and URL, and may include summary, author, publication time and image.
Required: section (9 allowed values: intelligencer, thecut, vulture, grub-street, curbed, strategist, select-all, science, daily).
Sampled 14 Oct 2026: 3 items. Filled in every item: title, url. In the sample: url: nymag.com; title: median 55 characters.
Open in Playground
GET/nymag/newsapiKey1 credit/request
Returns the current New York Magazine top stories, with no parameters. Each item has a title and URL, and may include summary, author, publication time and image. Use `nymag-headlines` to read one of its sections.
Takes no parameters.
Sampled 14 Oct 2026: 2 items. Filled in every item: title, url. In the sample: url: nymag.com; title: median 19 characters.
Open in Playground
GET/nymag/sectionsapiKey1 credit/request
Lists the New York Magazine section slugs accepted by `nymag-headlines`, such as `intelligencer`, `thecut`, `vulture` and `grub-street`. Each entry has its stable `slug`, display `name` and section `url`.
Takes no parameters.
Sampled 14 Oct 2026: 9 items. Filled in every item: slug, name, url. In the sample: name: “Intelligencer” and 8 other values; url: nymag.com.
Open in Playground