GET/birminghammail/articleapiKey2 credits/request
Returns public Birmingham Mail article metadata (including the section) and body paragraphs from a canonical article URL. Photo-gallery URLs are rejected.
Required: url.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: published_at: 2026-09-24; section: “Midlands News”; url: birminghammail.co.uk; title: 76 characters; authors: 1 entry; description: 78 characters; updated_at: 2026-09-24; image_url: i2-prod.birminghammail.co.uk.
Open in Playground
GET/birminghammail/authorapiKey2 credits/request
Returns one Birmingham Mail author's public profile: name, job title, bio, email, X/Twitter handle, and one page of their recent articles.
Optional: slug, url, page.
Sampled 14 Oct 2026: 24 items. Filled in every item: title, url, label, label_url. In the sample: url: birminghammail.co.uk; title: median 78 characters; label_url: birminghammail.co.uk.
Open in Playground
GET/birminghammail/headlinesapiKey1 credit/request
Returns fresh headlines from one public Birmingham Mail section. Photo galleries are omitted because they have no readable article body.
Required: section (23 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).
Sampled 14 Oct 2026: 25 items. Filled in every item: title, url, summary, published_at, author, image_url. In the sample: published_at: 2026-10-10 to 2026-10-13; url: birminghammail.co.uk; title: median 85 characters; summary: median 103 characters; image_url: i2-prod.birminghammail.co.uk and 1 other host.
Open in Playground
GET/birminghammail/newsapiKey1 credit/request
Returns fresh Birmingham Mail top stories from the public home RSS feed. Photo galleries are omitted because they have no readable article body.
Takes no parameters.
Sampled 14 Oct 2026: 25 items. Filled in every item: title, url, summary, published_at, author, image_url. In the sample: published_at: 2026-10-13; url: birminghammail.co.uk; title: median 78 characters; summary: median 104 characters; image_url: i2-prod.birminghammail.co.uk and 2 other hosts.
Open in Playground
GET/birminghammail/sectionsapiKey1 credit/request
Lists the 23 Birmingham Mail sections that `birminghammail-headlines` accepts, such as `news/midlands-news`, `black-country`, `sport/football/transfer-news` and `whats-on`. Each has a `slug`, a display `name` and the feed `url`. Only sections with a recently updated feed are included (last verified 2026-09-25), and each returns up to about 25 entries.
Takes no parameters.
Sampled 14 Oct 2026: 23 items. Filled in every item: slug, name, url. In the sample: name: “News” and 22 other values; url: birminghammail.co.uk.
Open in Playground
Birmingham Mail API endpoints