Endpoint Playground

Try the NZ Herald section headlines API

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.

What a live request returned

14 Oct 2026: 10 items; 6 fields had a value in every checked item.

Observed request: GET /nzherald/headlines?section=business
Fields with a value in every checked item: title, url, summary, published_at, author, image_url

Sample value profiles: published_at: 2026-10-13; url: nzherald.co.nz; title: median 79 characters.

Request: GET /nzherald/headlines
Cost: 1 credit/request
Auth: apiKey

NZ Herald section headlines API documentation NZ Herald platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/nzherald/headlines?section=business' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
section	string	Yes	business	NZ Herald section slug

Example JSON response

{
  "code": 200,
  "data": {
    "section": "nz",
    "items": [
      {
        "title": "Example headline",
        "url": "https://www.nzherald.co.nz/nz/example-article-slug/ABCDEFGHIJKLMNOPQRST1234/"
      }
    ]
  }
}

More NZ Herald endpoints

Get NZ Herald article content Get an NZ Herald author profile Get NZ Herald top stories Get NZ Herald sections

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestpublicnews.headlinesResponseDocNZ Herald

GET /nzherald/headlines

Get NZ Herald section headlines

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

section

requiredstring

NZ Herald section slug · allowed: 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, world, kahu, talanoa, the-selection

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "section": "nz",
    "items": [
      {
        "title": "Example headline",
        "url": "https://www.nzherald.co.nz/nz/example-article-slug/ABCDEFGHIJKLMNOPQRST1234/"
      }
    ]
  }
}

Endpoint Playground

Try the NZ Herald section headlines API

What a live request returned

14 Oct 2026: 10 items; 6 fields had a value in every checked item.

Observed request: GET /nzherald/headlines?section=business
Fields with a value in every checked item: title, url, summary, published_at, author, image_url

Sample value profiles: published_at: 2026-10-13; url: nzherald.co.nz; title: median 79 characters.

Request: GET /nzherald/headlines
Cost: 1 credit/request
Auth: apiKey

NZ Herald section headlines API documentation NZ Herald platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/nzherald/headlines?section=business' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
section	string	Yes	business	NZ Herald section slug

Example JSON response

{
  "code": 200,
  "data": {
    "section": "nz",
    "items": [
      {
        "title": "Example headline",
        "url": "https://www.nzherald.co.nz/nz/example-article-slug/ABCDEFGHIJKLMNOPQRST1234/"
      }
    ]
  }
}

More NZ Herald endpoints

Get NZ Herald article content Get an NZ Herald author profile Get NZ Herald top stories Get NZ Herald sections

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestpublicnews.headlinesResponseDocNZ Herald

GET /nzherald/headlines

Get NZ Herald section headlines

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

section

requiredstring

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "section": "nz",
    "items": [
      {
        "title": "Example headline",
        "url": "https://www.nzherald.co.nz/nz/example-article-slug/ABCDEFGHIJKLMNOPQRST1234/"
      }
    ]
  }
}