Docs menu
Birmingham Mail API endpoint
Birmingham Mail top stories API
Returns fresh Birmingham Mail top stories from the public home RSS feed. Photo galleries are omitted because they have no readable article body.
GETapiKey1 credit/requestBirmingham Mailpublicnews.newsResponseDoc
Birmingham Mail/birminghammail/newsEndpoint facts
- Method
- GET
- API path
- /birminghammail/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Birmingham Mail
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns fresh Birmingham Mail top stories from the public home RSS feed (about 25 entries): title, canonical URL, summary, publication time, byline author and image. Photo-gallery entries are omitted because they have no readable article body. The site's pages brand the title "Birmingham Live"; this API keeps the Birmingham Mail name.
Sampled response
- Request, 14 Oct 2026
- GET /birminghammail/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 78 characters |
| url | 25 | birminghammail.co.uk |
| summary | 25 | median 104 characters |
| published_at | 25 | 2026-10-13 |
| author | 25 | |
| image_url | 25 | i2-prod.birminghammail.co.uk and 2 other hosts |
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/birminghammail/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"items": [
{
"title": "Example Birmingham Mail headline",
"url": "https://www.birminghammail.co.uk/news/midlands-news/example-headline-34668610",
"summary": "Example summary.",
"published_at": "2026-09-24T20:57:22Z",
"author": "Example Reporter",
"image_url": "https://i2-prod.birminghammail.co.uk/example.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.NewsResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].type | string | No | ||||
| data.items[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 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/news" \
-H "x-api-key: $CRAWLORA_API_KEY"