BBC API endpoint
Returns fresh BBC News headlines for one section, `world` by default. `section` can be `all`, `world`, `uk`, `politics`, `business`, `health`, `science_and_environment`, `technology` or `entertainment_and_arts`; `all` can mix stories from several sections. Each item has a title, URL, summary and publication time when available.
/bbc/headlinesQuery parameter: optional section, a supported BBC News RSS section. It defaults to world. Allowed values: all, world, uk, politics, business, health, science_and_environment, technology, entertainment_and_arts. all reads the BBC News root feed and may include stories from multiple sections.
Returns fresh public BBC News stories with their title, canonical URL, summary, and publication time when available.
| Field | Filled in, of 21 checked | Values in the sample |
|---|---|---|
| title | 21 | median 62 characters |
| url | 21 | bbc.co.uk |
| summary | 21 | median 101 characters |
| published_at | 21 | 2026-10-12 to 2026-10-13 |
| section | 21 | all in all 21 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | No | world | BBC News RSS section, defaults to world Allowed values: all, world, uk, politics, business, health, science_and_environment, technology, entertainment_and_arts. | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/bbc/headlines?section=all" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"section": "world",
"items": [
{
"title": "Example story",
"url": "https://www.bbc.co.uk/news/articles/c123abc4567"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/bbc.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | bbc.HeadlinesResponse | No | ||||
| data.items | array | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].section | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].url | string | No | ||||
| 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/bbc/headlines?section=all" \
-H "x-api-key: $CRAWLORA_API_KEY"