# Brawlhalla News and Patch Notes API

> Brawlhalla news, patch notes, esports posts and weekly legend rotations from the official site

- Vendor: `brawlhallanewsandpatchnotesapi` · version 1.0 · category Gaming · tags brawlhalla api, brawlhalla patch notes api, game news api, brawlhalla esports api, legend rotation api, fighting game api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/brawlhallanewsandpatchnotesapi
- This document: https://apiclay.com/docs/brawlhallanewsandpatchnotesapi.md
- OpenAPI 3.1: https://apiclay.com/api/brawlhallanewsandpatchnotesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `brawlhallanewsandpatchnotesapi`
- Updated: 2026-11-18

## About

## Brawlhalla News and Patch Notes API

Brawlhalla's official site CMS (WordPress): every news post with patch notes, events, esports and the weekly free legend rotation, searchable by keyword and filterable by category, plus any single post with its full HTML and the category list with post counts.

Data comes from **brawlhalla.com** (https://www.brawlhalla.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/categories` for ids (15 Patch Notes, 1143 Weekly Rotation, 28 Esports), then `/news?categories=15&amp;_fields=id,date,title,link` and `/post?id=`.

### Routes

#### GET `/news` - News posts
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Keyword, e.g. `patch` or a legend name. |
| categories | query | string | no | Category ids, comma-separated, from `/categories`. |
| per_page | query | number | no | Up to 100 (default 10). |
| page | query | number | no | Page. |
| after | query | string | no | ISO date; only posts published after it. |
| _fields | query | string | no | e.g. `id,date,title,link` for a short answer. |

Returns: array of posts, newest first: `id`, `date`, `link` (brawlhalla.com/news/...), `title.rendered`, `excerpt.rendered`, `content.rendered`, `categories`, `featured_media`.

#### GET `/post` - Post
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | number | yes | Post `id` from `/news`. |

Returns: one post with the full article or patch notes in `content.rendered` (HTML).

#### GET `/categories` - Categories
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| per_page | query | number | no | Up to 100. |
| _fields | query | string | no | e.g. `id,name,count`. |

Returns: array of `id`, `name`, `slug`, `count`: Announcements, Community, Esports, Legends, Patch Notes, Weekly Rotation.

### Caveats

- Posts are official Brawlhalla content owned by Blue Mammoth Games and Ubisoft; link back rather than republishing full articles.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by brawlhalla.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /news — News posts
- Gateway: `GET https://api.apiclay.com/v1/api/brawlhallanewsandpatchnotesapi/news`
- Public query params: `search` (string), `categories` (string), `per_page` (number), `page` (number), `after` (string), `_fields` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /post — Post
- Gateway: `GET https://api.apiclay.com/v1/api/brawlhallanewsandpatchnotesapi/post`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/brawlhallanewsandpatchnotesapi/categories`
- Public query params: `per_page` (number), `_fields` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/brawlhallanewsandpatchnotesapi/news" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
