---
title: "Get Stuff section headlines"
method: GET
path: "/stuff/headlines"
tags: ["Stuff"]
---

# Get Stuff section headlines

`GET /stuff/headlines`

## Request

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

Returns the latest Stuff (New Zealand) stories for one section. `section` is required and takes one of 31 slugs, including slash-separated regional and sport ones such as `nz-news/auckland` and `sport/rugby`, plus `world-news`, `business`, `politics` and `motoring`. Each item has its title, URL, summary, publication time, author and image.

## Query parameters

- `section` 'latest-news' | 'nz-news' | 'nz-news/auckland' | 'nz-news/wellington' | 'nz-news/canterbury' | 'nz-news/north-island' | 'nz-news/south-island' | 'world-news' | 'business' | 'money' | 'politics' | 'perspectives' | 'pou-tiaki' | 'forever-project' | 'sport' | 'sport/rugby' | 'sport/cricket' | 'sport/netball' | 'sport/football' | 'sport/rugby-league' | 'home-property' | 'home-property/good-life' | 'travel' | 'life-and-style' | 'wellbeing' | 'wellbeing/house-wellness' | 'food-drink' | 'culture' | 'motoring' | 'health' | 'quizzes', 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/028417aa35bb?raw)