Docs menu
National Post API endpoint
National Post section headlines API
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.
GETapiKey1 credit/requestNational Postpublicnews.headlinesResponseDoc
National Post/nationalpost/headlinesEndpoint facts
- Method
- GET
- API path
- /nationalpost/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- National Post
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of 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. Any other value returns an invalid-params error.
The eight top-level sections health, opinion, longreads, modern-life, travel, entertainment, shopping-essentials and sports are read from the section's public feed: 10 stories with title, canonical URL, summary, publication time and byline. Every other section is read from its own category page: up to about 45 stories with title, canonical URL, summary (when the card shows one) and lead image, but no publication time or byline, because the page only shows relative times such as "1 hour ago". Paid Sponsored stories are left out.
Sampled response
- Request, 14 Oct 2026
- GET /nationalpost/headlines?section=opinion
- Items in items
- 10
- Fields filled in every checked item
- 4
- Fields empty in some or all items
- 1
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| title | 10 | median 73 characters |
| url | 10 | nationalpost.com |
| summary | 9 | median 110 characters |
| published_at | 10 | 2026-10-10 to 2026-10-13 |
| author | 10 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | National Post section slug Allowed values: 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. | canada | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/nationalpost/headlines?section=canada" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "hockey",
"items": [
{
"title": "How Nick Blankenburg has skated his way into Maple Leafs' plans",
"url": "https://nationalpost.com/sports/hockey/nhl/toronto-maple-leafs/nick-blankenburg-skated-way-into-plans",
"summary": "Defenceman Nick Blankenburg, in Maple Leafs camp on a PTO, was confident that a contract with the club was not far off."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under National Post top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/nationalpost/headlines?section=canada" \
-H "x-api-key: $CRAWLORA_API_KEY"