GET/nzherald/articleapiKey2 credits/request
Returns public NZ Herald article metadata and body paragraphs from a canonical article URL. A premium (subscriber-only) article URL returns a permission error instead of a partial or fabricated body.
Required: url.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: published_at: 2026-09-24; section: “Business”; url: nzherald.co.nz; title: 81 characters; authors: 1 entry; description: 77 characters; updated_at: 2026-09-24; image_url: cloudfront-ap-southeast-2.images.arcpublishing.com.
Open in Playground
GET/nzherald/authorapiKey2 credits/request
Returns an NZ Herald author profile from a required `url` in the form `https://www.nzherald.co.nz/author/<slug>/`. The response has `name`, `job_title`, `location`, `email`, `biography`, `image_url` and recent articles. Each field reflects what the author's page shows, and article `published_at` is RFC3339 where the page gives a machine-readable timestamp.
Required: url.
Sampled 14 Oct 2026: 81 items. Filled in every item: title, url, summary, published_at, image_url. In the sample: published_at: 2026-02-22 to 2026-10-12; url: nzherald.co.nz; title: median 80 characters; summary: median 83 characters; image_url: cloudfront-ap-southeast-2.images.arcpublishing.com.
Open in Playground
GET/nzherald/headlinesapiKey1 credit/request
Returns recent NZ Herald headlines for one section. `section` is required and takes a slug listed by `nzherald-sections`, such as `nz`, `business`, `rugby`, `politics` or `world`. Each item has a title and URL. A URL may point at a premium article, which `nzherald-article` rejects with a permission error.
Required: section (44 allowed values, including business, markets-with-madison, media-insider, business-reports, small-business, personal-finance, economy, companies, markets, entertainment, lifestyle, society-insider, nz, crime, education, politics, trailblazers, property, sport, commonwealth-games, cricket, olympics, paralympics, rugby, rugby-league, football, basketball, golf, boxing, netball, athletics, cycling, motorsport, racing, sailing, tennis, ufc, technology, travel, travel-news).
Sampled 14 Oct 2026: 10 items. Filled in every item: title, url, summary, published_at, author, image_url. In the sample: published_at: 2026-10-13; url: nzherald.co.nz; title: median 79 characters; summary: median 80 characters; image_url: nzherald.co.nz.
Open in Playground
GET/nzherald/newsapiKey1 credit/request
Returns the current New Zealand Herald top stories, with no parameters. Each item has a title and URL, and may include summary, author, publication time and image. Use `nzherald-headlines` to read one section.
Takes no parameters.
Sampled 14 Oct 2026: 48 items. Filled in every item: title, url. In the sample: url: nzherald.co.nz; title: median 63 characters.
Open in Playground
GET/nzherald/sectionsapiKey1 credit/request
Lists the NZ Herald section slugs accepted by `nzherald-headlines`, such as `nz`, `business`, `rugby`, `technology` and `world`. Each entry has its `slug`, a display `name` (for example `New Zealand` for `nz`) and a `url`.
Takes no parameters.
Sampled 14 Oct 2026: 44 items. Filled in every item: slug, name, url. In the sample: name: “Business” and 43 other values; url: nzherald.co.nz.
Open in Playground
NZ Herald API endpoints