Docs menu
The Age API endpoint
The Age section headlines API
Returns the current stories for one The Age section: title, canonical URL, summary, author, publication time, and image where the section lists them. section must be one of the slugs returned by /theage/sections; any other value is rejected with a 400 before The Age is contacted.
GETapiKey1 credit/requestThe Agepublicnews.headlinesResponseDoc
The Age/theage/headlinesEndpoint facts
- Method
- GET
- API path
- /theage/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The Age
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of the slugs returned by theage-sections: melbourne-news, national/victoria, politics, politics/federal, politics/victoria, politics/nsw, politics/queensland, politics/western-australia, business, business/companies, business/markets, business/bullsnbears, business/the-economy, business/banking-and-finance, business/small-business, business/workplace, world, world/north-america, world/europe, world/asia, world/middle-east, world/south-america, world/africa, national, national/nsw, national/queensland, national/western-australia, opinion, property, property/news, property/living, sport, sport/afl, sport/cricket, sport/soccer, sport/racing, sport/tennis, sport/nrl, sport/rugby-union, sport/netball, sport/basketball, sport/motorsport, sport/cycling, sport/golf, sport/nfl, sport/athletics, sport/swimming, sport/boxing, goodfood, goodfood/melbourne-eating-out, goodfood/recipes, goodfood/tips-and-advice, goodfood/drinks, culture, culture/movies, culture/tv-and-radio, culture/music, culture/celebrity, culture/books, culture/comedy, culture/dance, culture/musicals, culture/opera, culture/theatre, culture/art-and-design, culture/live-reviews, lifestyle, lifestyle/health-and-wellness, lifestyle/fashion, lifestyle/life-and-relationships, lifestyle/beauty, traveller, traveller/inspiration/destination-guides, traveller/inspiration, traveller/reviews-and-advice, traveller/travel-news, good-weekend, sunday-life, money, money/super-and-retirement, money/investing, money/banking, money/borrowing, money/saving, money/tax, money/planning-and-budgeting, education, healthcare, environment, environment/conservation, environment/climate-change, environment/sustainability, environment/weather, technology, technology/video-games, australia-higher-education. Any other value returns a 400 error before any request is made to The Age.
Each item carries a title and canonical URL, plus the summary, author, publication time (UTC), and image when the section lists them.
Sampled response
- Request, 14 Oct 2026
- GET /theage/headlines?section=politics%2Ffederal
- Items in items
- 20
- Fields filled in every checked item
- 5
- Fields empty in some or all items
- 1
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| title | 20 | median 68 characters |
| url | 20 | theage.com.au |
| summary | 20 | median 149 characters |
| published_at | 20 | 2026-10-11 to 2026-10-13 |
| image_url | 20 | static.ffx.io |
| author | 17 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Section slug from /theage/sections Allowed values: melbourne-news, national/victoria, politics, politics/federal, politics/victoria, politics/nsw, politics/queensland, politics/western-australia, business, business/companies, business/markets, business/bullsnbears, business/the-economy, business/banking-and-finance, business/small-business, business/workplace, world, world/north-america, world/europe, world/asia, world/middle-east, world/south-america, world/africa, national, national/nsw, national/queensland, national/western-australia, opinion, property, property/news, property/living, sport, sport/afl, sport/cricket, sport/soccer, sport/racing, sport/tennis, sport/nrl, sport/rugby-union, sport/netball, sport/basketball, sport/motorsport, sport/cycling, sport/golf, sport/nfl, sport/athletics, sport/swimming, sport/boxing, goodfood, goodfood/melbourne-eating-out, goodfood/recipes, goodfood/tips-and-advice, goodfood/drinks, culture, culture/movies, culture/tv-and-radio, culture/music, culture/celebrity, culture/books, culture/comedy, culture/dance, culture/musicals, culture/opera, culture/theatre, culture/art-and-design, culture/live-reviews, lifestyle, lifestyle/health-and-wellness, lifestyle/fashion, lifestyle/life-and-relationships, lifestyle/beauty, traveller, traveller/inspiration/destination-guides, traveller/inspiration, traveller/reviews-and-advice, traveller/travel-news, good-weekend, sunday-life, money, money/super-and-retirement, money/investing, money/banking, money/borrowing, money/saving, money/tax, money/planning-and-budgeting, education, healthcare, environment, environment/conservation, environment/climate-change, environment/sustainability, environment/weather, technology, technology/video-games, australia-higher-education. | politics/federal | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/theage/headlines?section=politics%2Ffederal" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "politics/federal",
"items": [
{
"title": "Example headline",
"url": "https://www.theage.com.au/politics/federal/example-headline-20260925-p61abc.html",
"summary": "Example summary.",
"published_at": "2026-09-24T19:00:00Z",
"author": "Example Reporter"
}
]
}
}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 The Age 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/theage/headlines?section=politics%2Ffederal" \
-H "x-api-key: $CRAWLORA_API_KEY"