---
title: "Get NZ Herald section headlines"
method: GET
path: "/nzherald/headlines"
tags: ["NZ Herald"]
---

# Get NZ Herald section headlines

`GET /nzherald/headlines`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/nzherald/headlines`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `section` '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', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsHeadlinesResponseDoc
  - `data` NewsplatformHeadlinesResponse
    - `items` NewsplatformHeadlineItem[]
      - `author` string
      - `image_url` string
      - `published_at` string
      - `summary` string
      - `title` string
      - `type` string
      - `url` string
    - `section` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)