Docs menu

BO3 API endpoint

BO3.gg forum threads API

Returns BO3.gg forum threads for one game with paging: a `category` id from bo3-forum-categories and `sort` (`activity` with pinned threads first, `newest`, `comments`, `rating`), up to 100 per page. Each thread has slug, title, category, comment count, rating, pinned flag, created and last-activity times and the author's nickname; post bodies, reactions and replies are not returned.

GETapiKey1 credit/requestBO3/bo3/forum

Endpoint facts

Method: GET
API path: /bo3/forum
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: BO3

BO3.gg Esports Data API Try BO3.gg forum threads API in Playground BO3 API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: optional; allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. Defaults to cs2.
category: optional forum category id from bo3-forum-categories for the same game; an id that is not in that list returns 400.
sort: optional; allowed values: activity, newest, comments, rating. Defaults to activity (pinned threads first, then latest activity).
offset: optional zero-based offset; limit: optional page size, 1 to 100, default 20.

Notable response behavior:

total counts the threads that fit the filters (221 for CS2 today) and has_more says whether another page exists. A game without a forum, such as Dota 2, returns an empty list.
Only thread metadata is returned; posts and replies are user-written content and are not exposed. A category filter makes one extra request to validate the id. The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /bo3/forum?sort=newest&limit=40
Items in threads: 40
Fields filled in every checked item: 11

Field	Filled in, of 40 checked	Values in the sample
id	40
slug	40
title	40	“Will here be a pickem for Major?” and 39 other values
category_id	40
category	40	CS2 in all 40
comments	40	0 to 11, median 6
rating	40	0
pinned	40	true in 0 of 40
created_at	40	2025-08-14 to 2026-05-25
last_activity_at	40	2025-08-15 to 2026-05-27
author	40

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
game	string	No	cs2	Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 Allowed values: cs2, valorant, lol, dota2, r6siege, mlbb.
category	integer	No		Forum category id from bo3-forum-categories, for example 4 Minimum: 1.
sort	string	No	activity	Order; one of activity, newest, comments, rating; defaults to activity Allowed values: activity, newest, comments, rating.
offset	integer	No	0	Zero-based offset; defaults to 0 Minimum: 0.
limit	integer	No	20	Page size, 1 to 100; defaults to 20 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bo3/forum?game=cs2&sort=activity&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.bo3.gg/api/v1/forum",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "cs2",
    "sort": "activity",
    "total": 221,
    "offset": 0,
    "limit": 20,
    "count": 1,
    "has_more": true,
    "threads": [
      {
        "id": 1244,
        "slug": "where-is-the-pick-ems",
        "title": "WHERE IS THE PICK EMS",
        "category_id": 1,
        "category": "CS2",
        "comments": 6,
        "rating": 0,
        "pinned": false,
        "created_at": "2025-10-06T10:22:40Z",
        "last_activity_at": "2026-05-27T12:10:18Z",
        "author": {
          "id": 18470,
          "slug": "witness",
          "nickname": "Witness"
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	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.ForumFeedResponse	No
data.category	integer	No		4
data.count	integer	No		20
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.game	string	No		cs2
data.has_more	boolean	No		true
data.limit	integer	No		20
data.offset	integer	No		0
data.sort	string	No	activity, newest, comments, rating	activity
data.source_url	string	No		https://bo3.gg/matches/current
data.threads	array	No
data.threads[].author	bo3.PersonRef	No
data.threads[].author.id	integer	No		14
data.threads[].author.nickname	string	No		Pers1valle
data.threads[].author.slug	string	No		pers1valle
data.threads[].category	string	No		CS2
data.threads[].category_id	integer	No		1
data.threads[].comments	integer	No		6
data.threads[].created_at	string	No
data.threads[].id	integer	No		1244
data.threads[].last_activity_at	string	No
data.threads[].pinned	boolean	No		false
data.threads[].rating	integer	No		0
data.threads[].slug	string	No		where-is-the-pick-ems
data.threads[].title	string	No
data.total	integer	No		221
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/forum?game=cs2&sort=activity&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More BO3 endpoint docs BO3.gg Esports Data API BO3.gg CS2 economy baseline API documentation BO3.gg forum categories API documentation BO3.gg match maps and rounds API documentation BO3.gg esports match history API documentation BO3.gg per-player match statistics API documentation BO3.gg match detail API documentation

Open in Playground Back to group

Docs menu

BO3 API endpoint

BO3.gg forum threads API

GETapiKey1 credit/requestBO3/bo3/forum

Endpoint facts

Method: GET
API path: /bo3/forum
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: BO3

BO3.gg Esports Data API Try BO3.gg forum threads API in Playground BO3 API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: optional; allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. Defaults to cs2.
category: optional forum category id from bo3-forum-categories for the same game; an id that is not in that list returns 400.
sort: optional; allowed values: activity, newest, comments, rating. Defaults to activity (pinned threads first, then latest activity).
offset: optional zero-based offset; limit: optional page size, 1 to 100, default 20.

Notable response behavior:

total counts the threads that fit the filters (221 for CS2 today) and has_more says whether another page exists. A game without a forum, such as Dota 2, returns an empty list.
Only thread metadata is returned; posts and replies are user-written content and are not exposed. A category filter makes one extra request to validate the id. The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /bo3/forum?sort=newest&limit=40
Items in threads: 40
Fields filled in every checked item: 11

Field	Filled in, of 40 checked	Values in the sample
id	40
slug	40
title	40	“Will here be a pickem for Major?” and 39 other values
category_id	40
category	40	CS2 in all 40
comments	40	0 to 11, median 6
rating	40	0
pinned	40	true in 0 of 40
created_at	40	2025-08-14 to 2026-05-25
last_activity_at	40	2025-08-15 to 2026-05-27
author	40

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
game	string	No	cs2	Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 Allowed values: cs2, valorant, lol, dota2, r6siege, mlbb.
category	integer	No		Forum category id from bo3-forum-categories, for example 4 Minimum: 1.
sort	string	No	activity	Order; one of activity, newest, comments, rating; defaults to activity Allowed values: activity, newest, comments, rating.
offset	integer	No	0	Zero-based offset; defaults to 0 Minimum: 0.
limit	integer	No	20	Page size, 1 to 100; defaults to 20 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bo3/forum?game=cs2&sort=activity&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.bo3.gg/api/v1/forum",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "cs2",
    "sort": "activity",
    "total": 221,
    "offset": 0,
    "limit": 20,
    "count": 1,
    "has_more": true,
    "threads": [
      {
        "id": 1244,
        "slug": "where-is-the-pick-ems",
        "title": "WHERE IS THE PICK EMS",
        "category_id": 1,
        "category": "CS2",
        "comments": 6,
        "rating": 0,
        "pinned": false,
        "created_at": "2025-10-06T10:22:40Z",
        "last_activity_at": "2026-05-27T12:10:18Z",
        "author": {
          "id": 18470,
          "slug": "witness",
          "nickname": "Witness"
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	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.ForumFeedResponse	No
data.category	integer	No		4
data.count	integer	No		20
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.game	string	No		cs2
data.has_more	boolean	No		true
data.limit	integer	No		20
data.offset	integer	No		0
data.sort	string	No	activity, newest, comments, rating	activity
data.source_url	string	No		https://bo3.gg/matches/current
data.threads	array	No
data.threads[].author	bo3.PersonRef	No
data.threads[].author.id	integer	No		14
data.threads[].author.nickname	string	No		Pers1valle
data.threads[].author.slug	string	No		pers1valle
data.threads[].category	string	No		CS2
data.threads[].category_id	integer	No		1
data.threads[].comments	integer	No		6
data.threads[].created_at	string	No
data.threads[].id	integer	No		1244
data.threads[].last_activity_at	string	No
data.threads[].pinned	boolean	No		false
data.threads[].rating	integer	No		0
data.threads[].slug	string	No		where-is-the-pick-ems
data.threads[].title	string	No
data.total	integer	No		221
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/forum?game=cs2&sort=activity&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

BO3.gg forum threads API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

BO3.gg forum threads API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related