SCMP API endpoint
Returns the current article listing for one South China Morning Post section: each story's title, canonical URL, summary, byline, publication time, and lead image. Section must be a slug returned by /scmp/sections.
/scmp/headlinesQuery parameter: required section, a slug from /scmp/sections. Values: news, business, property, tech, lifestyle, culture, sport, postmag, style, this-week-in-asia, cooking, hong-kong, china, asia, world, people-culture, china-politics, china-diplomacy, china-economy, hong-kong-politics, hong-kong-economy, hong-kong-health-environment, hong-kong-education, world-us-canada, world-europe, world-middle-east, world-americas, world-africa, world-russia-central-asia, asia-australasia, asia-diplomacy, asia-east-asia, asia-southeast-asia, asia-south-asia, business-companies, business-investor-relations, business-global-economy, business-money-wealth, opinion-comment, opinion-harrys-view, opinion-blogs, opinion-polls, opinion-letters, property-hong-kong-china, property-international, tech-big-tech, tech-enterprises, tech-innovation, tech-leaders-founders, tech-science-research, lifestyle-fashion-beauty, lifestyle-travel-leisure, lifestyle-motoring, lifestyle-food-drink, lifestyle-health-wellness, lifestyle-watches, culture-books, culture-music, culture-film-tv, culture-arts, sport-hong-kong, sport-china, sport-golf, sport-racing, sport-rugby, sport-football, sport-tennis, sport-other, sport-boxing, sport-hong-kong-sevens, postmag-culture, postmag-travel, postmag-food-drink, postmag-passions, postmag-wellness, postmag-design-interiors, style-luxury, style-fashion, style-beauty, style-people, style-lifestyle, this-week-in-asia-politics, this-week-in-asia-geopolitics, this-week-in-asia-economics, this-week-in-asia-society, this-week-in-asia-opinion, this-week-in-asia-asia-buzz, this-week-in-asia-people.
Returns the current article listing for that section from SCMP's own public RSS feed: each story's title, canonical URL, summary, byline, publication time, and lead image.
| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| title | 50 | median 79 characters |
| url | 50 | scmp.com |
| summary | 50 | median 499 characters |
| author | 50 | |
| published_at | 50 | 2026-10-11 to 2026-10-13 |
| image_url | 50 | cdn.i-scmp.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Section slug from /scmp/sections Allowed values: news, business, property, tech, lifestyle, culture, sport, postmag, style, this-week-in-asia, cooking, hong-kong, china, asia, world, people-culture, china-politics, china-diplomacy, china-economy, hong-kong-politics, hong-kong-economy, hong-kong-health-environment, hong-kong-education, world-us-canada, world-europe, world-middle-east, world-americas, world-africa, world-russia-central-asia, asia-australasia, asia-diplomacy, asia-east-asia, asia-southeast-asia, asia-south-asia, business-companies, business-investor-relations, business-global-economy, business-money-wealth, opinion-comment, opinion-harrys-view, opinion-blogs, opinion-polls, opinion-letters, property-hong-kong-china, property-international, tech-big-tech, tech-enterprises, tech-innovation, tech-leaders-founders, tech-science-research, lifestyle-fashion-beauty, lifestyle-travel-leisure, lifestyle-motoring, lifestyle-food-drink, lifestyle-health-wellness, lifestyle-watches, culture-books, culture-music, culture-film-tv, culture-arts, sport-hong-kong, sport-china, sport-golf, sport-racing, sport-rugby, sport-football, sport-tennis, sport-other, sport-boxing, sport-hong-kong-sevens, postmag-culture, postmag-travel, postmag-food-drink, postmag-passions, postmag-wellness, postmag-design-interiors, style-luxury, style-fashion, style-beauty, style-people, style-lifestyle, this-week-in-asia-politics, this-week-in-asia-geopolitics, this-week-in-asia-economics, this-week-in-asia-society, this-week-in-asia-opinion, this-week-in-asia-asia-buzz, this-week-in-asia-people. | hong-kong | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/scmp/headlines?section=hong-kong" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"section": "hong-kong",
"items": [
{
"title": "Example Headline",
"url": "https://www.scmp.com/news/hong-kong/politics/article/3368530/example-headline",
"summary": "An example teaser sentence.",
"author": "Jane Example",
"published_at": "2026-09-23T04:15:00Z",
"image_url": "https://cdn.i-scmp.com/sites/default/files/example.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/scmp.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | scmp.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 6 fields: author, image_url, published_at, summary, title, url. Described under SCMP author profile API. | |||
| data.section | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/scmp/headlines?section=hong-kong" \
-H "x-api-key: $CRAWLORA_API_KEY"