---
title: "Get Birmingham Mail section headlines"
method: GET
path: "/birminghammail/headlines"
tags: ["Birmingham Mail"]
---

# Get Birmingham Mail section headlines

`GET /birminghammail/headlines`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/birminghammail/headlines`
- Auth: API key in header `x-api-key`

Returns fresh headlines from one public Birmingham Mail section. Photo galleries are omitted because they have no readable article body.

## Query parameters

- `section` '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', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsHeadlinesResponseDoc
  - `data` NewsplatformHeadlinesResponse
    - `items` NewsplatformHeadlineItem[]
      - `author` string
      - `image_url` string
      - `published_at` string
      - `summary` string
      - `title` string
      - `type` string
      - `url` string
    - `section` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)