New Zealand policy monitoring
Use NZ Herald endpoints to turn new zealand policy monitoring into repeatable API requests with documented inputs and JSON responses.
Collect NZ Herald section and article data with the publisher’s premium boundary visible to downstream users.
Extract New Zealand national, regional, business and investigative reporting from NZ Herald as structured JSON.
Endpoint families
5
Documented params
8
Examples
5
Live catalog snapshot
Active endpoints
5
Methods
GET
Required params
8
Schema refs
5
{
"platform": "NZ Herald",
"endpoint": "nzherald-news",
"method": "GET",
"path": "/nzherald/news",
"auth": "apiKey"
}Use cases
Extract New Zealand national, regional, business and investigative reporting from NZ Herald as structured JSON.
Use NZ Herald endpoints to turn new zealand policy monitoring into repeatable API requests with documented inputs and JSON responses.
Use NZ Herald endpoints to turn regional story discovery into repeatable API requests with documented inputs and JSON responses.
Use NZ Herald endpoints to turn business reporting analysis into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live NZ Herald endpoint catalog — 5 endpoints, 8 documented request parameters, and 5 published response schemas — the same catalog Docs and Playground run against.
5 documented NZ Herald endpoints, grouped into 5 request families — Article, Author and Headlines, plus 2 more.
8 request parameters are documented across those NZ Herald endpoints, 8 of them required — the full input contract is public before you write any integration code.
5 of the 5 NZ Herald endpoints ship a recorded example response, and 5 carry a documented response schema — you can code against the real JSON before the first request.
NZ Herald endpoints document their error responses (400, 403, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
5 hosted MCP tools back the NZ Herald endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/nzherald/article
/nzherald/author
/nzherald/headlines
/nzherald/news
/nzherald/sections
Endpoint catalog
/nzherald/articleReturns 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.
MCP tool nzherald_article
/nzherald/authorReturns 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.
MCP tool nzherald_author
/nzherald/headlinesReturns 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.
MCP tool nzherald_headlines
/nzherald/newsReturns 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.
MCP tool nzherald_news
/nzherald/sectionsLists 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`.
MCP tool nzherald_sections
Related APIs
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
How to scrape NZ Herald
The NZ Herald is NZME’s flagship news title, spanning national reporting, local communities, business and investigations. Its homepage can mix those beats, so a section-led collection is useful for comparing coverage over time. The public endpoints do not unlock NZ Herald Premium articles: a premium article request returns a permission error. Plan for that result explicitly when building a corpus or assessing how much of a section is available to anonymous readers.
Start at /nzherald/sections and use a returned section in /nzherald/headlines. Preserve the section label: an Auckland local item and a national policy item may be relevant to different geographic analyses even when both appear in top stories.
/nzherald/news captures fresh public homepage stories. Check the corresponding section feed to see whether a headline is part of a sustained desk focus or only a featured front-page selection.
Pass a canonical story URL to /nzherald/article. Treat a permission error on a Premium URL as a genuine access boundary, not missing data to fill from a summary. /nzherald/author can add a reporter biography and recent work when public.
FAQ
No. Premium article URLs produce a permission error instead of a partial or invented article body. Keep the URL and access outcome if coverage analysis needs to count such stories.
Build separate queues from the returned sections, then retain section name, URL and publication metadata alongside each accessible article. This avoids collapsing regional reporting into a single national news series.