Docs menu
Birmingham Mail API endpoint
Birmingham Mail section headlines API
Returns fresh headlines from one public Birmingham Mail section. Photo galleries are omitted because they have no readable article body.
GETapiKey1 credit/requestBirmingham Mailpublicnews.headlinesResponseDoc
Birmingham Mail/birminghammail/headlinesEndpoint facts
- Method
- GET
- API path
- /birminghammail/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Birmingham Mail
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of news, news/midlands-news, news/uk-news, news/world-news, news/showbiz-tv, news/cost-of-living, news/money, news/health, black-country, motoring, motoring/motoring-news, sport, sport/football, sport/football/football-news, sport/football/transfer-news, whats-on, whats-on/whats-on-news, whats-on/family-kids-news, whats-on/food-drink-news, whats-on/music-nightlife-news, whats-on/shopping, travel, special-features. Use birminghammail-sections to list them with display names. Results include up to about 25 entries; photo galleries are omitted. Invalid values return a 400 error.
Sampled response
- Request, 14 Oct 2026
- GET /birminghammail/headlines?section=sport%2Ffootball%2Ffootball-news
- Items in items
- 25
- Fields filled in every checked item
- 6
| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| title | 25 | median 85 characters |
| url | 25 | birminghammail.co.uk |
| summary | 25 | median 103 characters |
| published_at | 25 | 2026-10-10 to 2026-10-13 |
| author | 25 | |
| image_url | 25 | i2-prod.birminghammail.co.uk and 1 other host |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Birmingham Mail section slug Allowed values: news, news/midlands-news, news/uk-news, news/world-news, news/showbiz-tv, news/cost-of-living, news/money, news/health, black-country, motoring, motoring/motoring-news, sport, sport/football, sport/football/football-news, sport/football/transfer-news, whats-on, whats-on/whats-on-news, whats-on/family-kids-news, whats-on/food-drink-news, whats-on/music-nightlife-news, whats-on/shopping, travel, special-features. | news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/birminghammail/headlines?section=news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "sport/football/football-news",
"items": [
{
"title": "Example headline",
"url": "https://www.birminghammail.co.uk/sport/football/football-news/example-headline-34666875",
"published_at": "2026-09-24T14:46:16Z",
"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 Birmingham Mail top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/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/birminghammail/headlines?section=news" \
-H "x-api-key: $CRAWLORA_API_KEY"