---
title: "Get National Post section headlines"
method: GET
path: "/nationalpost/headlines"
tags: ["National Post"]
---

# Get National Post section headlines

`GET /nationalpost/headlines`

## Request

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

Returns National Post headlines for one section; `section` is required and takes one of 45 slugs such as `canada`, `hockey` or `deals`. The top-level sections `health`, `opinion`, `longreads`, `modern-life`, `travel`, `entertainment`, `shopping-essentials` and `sports` return 10 stories with publication time and byline. Others return up to about 45 without either. Sponsored stories are left out.

## Query parameters

- `section` 'canada' | 'true-crime' | 'politics' | 'health' | 'world' | 'israel-middle-east' | 'opinion' | 'longreads' | 'modern-life' | 'food' | 'horoscopes' | 'style-beauty' | 'travel' | 'travel-canada' | 'travel-usa' | 'travel-international' | 'travel-cruises' | 'travel-guide' | 'entertainment' | 'books' | 'celebrity' | 'movies' | 'music' | 'theatre' | 'television' | 'business-essentials' | 'shopping-essentials' | 'buy-canadian' | 'home-living' | 'outdoor-living' | 'kitchen-dining' | 'tech' | 'personal-care' | 'entertainment-hobbies' | 'gift-guide' | 'deals' | 'sports' | 'hockey' | 'baseball' | 'basketball' | 'football' | 'soccer' | 'golf' | 'tennis' | 'driving', 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)