Global News API Documentation

First request

Endpoint

GET /globalnews/headlines

Cost

1 credit/request

curl -X GET "https://api.crawlora.net/api/v1/globalnews/headlines?section=world" \
  -H "x-api-key: $CRAWLORA_API_KEY"

How to use Global News endpoints

Global News describes its reporting as a network of 21 local newsrooms paired with national coverage and stories about Canada and abroad. Start with the matching local edition for a municipal or provincial issue, then compare national coverage for wider context. The local report and national rewrite may describe the same event, so preserve the newsroom, geography, byline, publication time, and canonical URL rather than counting them as separate events. For weather or public safety, collect dated snapshots because article details can change after the first headline. A 2026-10-27 pull listed 33 slugs that mix national topics (world, canada, politics) with city slugs such as calgary, and each feed returned 10 stories.

1. Step 1

   Separate topical sections from city hubs

   The sections route covers topical sections and every regional or city hub, each with its own feed. Slugs include canada, world, money, us-news, the-curator and local-station values such as toronto and calgary.

2. Step 2

   Match the article URL form

   Article calls take a canonical globalnews.ca link of the form /news/<id>/<slug>/ or /the-curator/<id>/<slug>/ and return title, description, section, authors, lead image, publish and update times and body paragraphs.

3. Step 3

   Key on the story id

   The numeric id in the path identifies the story, so use it as the stable key and treat the trailing slug as descriptive text.

4. Step 4

   Expect optional author fields

   The author route takes a /author/<slug>/ URL and returns name, biography, image_url and recent articles. Title, image_url and biography appear only if the profile has them.

5. Step 5

   Separate national topics from city feeds

   The world section's 10 stories ran from 2026-10-24 11:49 UTC to 2026-10-26 18:12, and calgary's 10 ran from 2026-10-24 to 2026-10-26 23:44, so city feeds can be as active as national ones. Keep the slug beside each story.

6. Step 6

   Treat the news route as a latest strip

   The news route returned 10 stories from 2026-10-26 22:22 UTC to 2026-10-27 00:58, a window of about two and a half hours, much shorter than the two-day section windows. Use it to catch breaking items, not for coverage.

Other Media & Streaming APIs