Docs menu
BO3 API endpoint
BO3.gg news categories API
Returns the BO3.gg editorial categories (id and title, sorted by title: Analytics, Article, Blog, Events, Gaming, Guides, Highlights, Interviews, News, Predictions, Results, Streams, Tips, Transfers, Wiki) accepted by the `category` filter of bo3-news-feed.
GETapiKey1 credit/requestBO3
BO3/bo3/news-categoriesEndpoint facts
- Method
- GET
- API path
- /bo3/news-categories
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- BO3
How this endpoint behaves
Header: x-api-key required.
Parameters:
- None.
Notable response behavior:
- The list is read live, so it follows the site: today it has 15 categories, for example
1News,2Results,38Predictions. The response is cached for up to one day.
Sampled response
- Request, 29 Oct 2026
- GET /bo3/news-categories
- Items in categories
- 15
- Fields filled in every checked item
- 2
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| id | 15 | |
| title | 15 | median 7 characters |
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/bo3/news-categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://api.bo3.gg/api/v1/news-categories",
"fetched_at": "2026-10-28T10:00:00Z",
"count": 2,
"categories": [
{
"id": 37,
"title": "Analytics"
},
{
"id": 38,
"title": "Predictions"
}
]
}
}Request schema
No body schema
Response schema
Inline response schema
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | bo3.NewsCategoriesResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].id | integer | No | 38 | |||
| data.categories[].title | string | No | Predictions | |||
| data.count | integer | No | 15 | |||
| data.fetched_at | string | No | 2026-10-28T10:00:00Z | |||
| data.source_url | string | No | https://bo3.gg/matches/current | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
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/bo3/news-categories" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More BO3 endpoint docsBO3.gg Esports Data APIBO3.gg CS2 economy baseline API documentationBO3.gg forum categories API documentationBO3.gg forum threads API documentationBO3.gg match maps and rounds API documentationBO3.gg esports match history API documentationBO3.gg per-player match statistics API documentation