Docs menu
The Sydney Morning Herald API endpoint
The Sydney Morning Herald sections API
Lists every Sydney Morning Herald section accepted by /smh/headlines (96 sections from the site's own section menu), each with its slug, display name, and public section-front URL.
GETapiKey1 credit/requestThe Sydney Morning Heraldpublicnews.sectionsResponseDoc
The Sydney Morning Herald/smh/sectionsEndpoint facts
- Method
- GET
- API path
- /smh/sections
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The Sydney Morning Herald
- Response schema
- #/definitions/publicnews.sectionsResponseDoc
How this endpoint behaves
Lists every section accepted by smh-headlines, taken from the site's own section menu: 96 sections, each with a slug, a display name, and the public section-front url. The accepted slugs are: sydney-news, national/nsw, politics, politics/federal, politics/nsw, politics/victoria, 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/victoria, national/queensland, national/western-australia, opinion, property, property/news, property/living, sport, sport/nrl, sport/rugby-union, sport/cricket, sport/soccer, sport/afl, sport/racing, sport/tennis, sport/netball, sport/basketball, sport/motorsport, sport/cycling, sport/golf, sport/nfl, sport/athletics, sport/swimming, sport/boxing, goodfood, goodfood/sydney-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.
Menu entries that are topic tags, bylines, off-site links, or utility pages (Today's Paper, puzzles, quizzes) are not sections and are not listed.
Sampled response
- Request, 14 Oct 2026
- GET /smh/sections
- Items in sections
- 96
- Fields filled in every checked item
- 3
| Field | Filled in, of 96 checked | Values in the sample |
|---|---|---|
| slug | 96 | |
| name | 96 | “Sydney” and 95 other values |
| url | 96 | smh.com.au |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/smh/sections" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"sections": [
{
"slug": "politics/federal",
"name": "Politics / Federal",
"url": "https://www.smh.com.au/politics/federal"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.sectionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.SectionsResponse | No | ||||
| data.sections | array | No | ||||
| data.sections[].name | string | No | ||||
| data.sections[].slug | string | No | ||||
| data.sections[].url | string | No |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/smh/sections" \
-H "x-api-key: $CRAWLORA_API_KEY"