Docs menu

GosuGamers API endpoint

GosuGamers tournaments API

Lists GosuGamers esports tournaments, optionally for one `game` and one `state` (`all`, `ongoing`, `upcoming`, `past`), with an optional name prefix `q`: id, name, game, status, start time, prize pool with currency and USD value, participant count, featured flag and the tournament URL. Paged with `page` and `page_size` (up to 100); `total_rows` reports the size of the filtered list. Use gosugamers-tournament with a returned id and game for stages and upcoming matches.

GETapiKey1 credit/requestGosuGamers/gosugamers/tournaments

Endpoint facts

Method: GET
API path: /gosugamers/tournaments
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: GosuGamers

GosuGamers Esports API Try GosuGamers tournaments API in Playground GosuGamers API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: optional; allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india. Omit for every game.
state: optional; allowed values: all, ongoing, upcoming, past. Defaults to all.
q: optional tournament name prefix, up to 100 characters, for example VCT.
page: optional 1-based page; defaults to 1.
page_size: optional page size, 1 to 100; defaults to 10.

Notable response behavior:

The response state is one of all, ongoing, upcoming, past. Each row has id, name, slug, game, status, start_time, prize_pool with prize_currency, prize_pool_usd, featured, participant_count, image_url and url.
total_rows and total_pages describe the filtered list. A page past the end returns an empty tournaments list. Rows with no listed prize have no prize_pool field.
Pass a returned id and its game to gosugamers-tournament for stages and upcoming matches.
Reads the site's signed JSON API, which uses a public key the site ships in its own scripts. The service rediscovers that key itself if the site rotates it.
The response is cached for up to five minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/tournaments?game=valorant&state=past&page_size=40
Items in tournaments: 40
Fields filled in every checked item: 11
Fields empty in some or all items: 3

Field	Filled in, of 40 checked	Values in the sample
id	40
name	40	“VALORANT Champions 2026” and 39 other values
slug	40
game	40	valorant in all 40
game_name	40	Valorant in all 40
status	40	Completed in all 40
start_time	40	2026-05-04 to 2026-09-23
prize_pool	31	2,350 to 43,500,000, median 200,000
prize_currency	31	USD (16), MXN (5), EUR (3) and 4 more
prize_pool_usd	31	2,350 to 2,250,000, median 21,436.82
featured	40	true in 5 of 40
participant_count	40	2 to 100, median 12
image_url	40	static.gosugamers.net
url	40	gosugamers.net

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
game	string	No		Game section; one of dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india; omit for all games Allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india.
state	string	No	all	Tournament state; one of all, ongoing, upcoming, past; defaults to all Allowed values: all, ongoing, upcoming, past.
q	string	No		Tournament name prefix, up to 100 characters	VCT
page	integer	No	1	1-based page; defaults to 1 Minimum: 1.
page_size	integer	No	10	Page size, 1 to 100; defaults to 10 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gosugamers/tournaments?game=dota2&state=all&q=coffee&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.gosugamers.net/api/v6/tournaments/parents",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "valorant",
    "state": "past",
    "page": 1,
    "page_size": 3,
    "total_rows": 1508,
    "total_pages": 503,
    "count": 1,
    "tournaments": [
      {
        "id": "63147",
        "name": "VALORANT Champions 2026",
        "slug": "valorant-champions-2026",
        "game": "valorant",
        "game_name": "Valorant",
        "status": "Completed",
        "start_time": "2026-09-23T00:00:00Z",
        "prize_pool": 2250000,
        "prize_currency": "USD",
        "prize_pool_usd": 2250000,
        "featured": true,
        "participant_count": 16,
        "url": "https://www.gosugamers.net/valorant/tournaments/63147-valorant-champions-2026"
      }
    ]
  }
}

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	gosugamers.TournamentsResponse	No
data.count	integer	No		10
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.game	string	No		valorant
data.page	integer	No		1
data.page_size	integer	No		10
data.q	string	No		VCT
data.source_url	string	No		https://www.gosugamers.net/valorant/matches
data.state	string	No	all, ongoing, upcoming, past	all
data.total_pages	integer	No		152
data.total_rows	integer	No		1511
data.tournaments	array	No
data.tournaments[].featured	boolean	No		false
data.tournaments[].game	string	No		valorant
data.tournaments[].game_name	string	No		VALORANT
data.tournaments[].id	string	No		63208
data.tournaments[].image_url	string	No
data.tournaments[].name	string	No		VCT Threshold China 2026
data.tournaments[].participant_count	integer	No		8
data.tournaments[].prize_currency	string	No		USD
data.tournaments[].prize_pool	number	No		500000
data.tournaments[].prize_pool_usd	number	No		500000
data.tournaments[].slug	string	No		vct-threshold-china-2026
data.tournaments[].start_time	string	No		2026-10-20T04:00:00Z
data.tournaments[].status	string	No		Ongoing
data.tournaments[].url	string	No
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/gosugamers/tournaments?game=dota2&state=all&q=coffee&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More GosuGamers endpoint docs GosuGamers Esports API GosuGamers article API documentation GosuGamers news and features archive API documentation GosuGamers head-to-head meetings API documentation GosuGamers game sections API documentation GosuGamers match game API documentation GosuGamers match detail API documentation

Open in Playground Back to group

Docs menu

GosuGamers API endpoint

GosuGamers tournaments API

GETapiKey1 credit/requestGosuGamers/gosugamers/tournaments

Endpoint facts

Method: GET
API path: /gosugamers/tournaments
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: GosuGamers

GosuGamers Esports API Try GosuGamers tournaments API in Playground GosuGamers API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: optional; allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india. Omit for every game.
state: optional; allowed values: all, ongoing, upcoming, past. Defaults to all.
q: optional tournament name prefix, up to 100 characters, for example VCT.
page: optional 1-based page; defaults to 1.
page_size: optional page size, 1 to 100; defaults to 10.

Notable response behavior:

The response state is one of all, ongoing, upcoming, past. Each row has id, name, slug, game, status, start_time, prize_pool with prize_currency, prize_pool_usd, featured, participant_count, image_url and url.
total_rows and total_pages describe the filtered list. A page past the end returns an empty tournaments list. Rows with no listed prize have no prize_pool field.
Pass a returned id and its game to gosugamers-tournament for stages and upcoming matches.
Reads the site's signed JSON API, which uses a public key the site ships in its own scripts. The service rediscovers that key itself if the site rotates it.
The response is cached for up to five minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/tournaments?game=valorant&state=past&page_size=40
Items in tournaments: 40
Fields filled in every checked item: 11
Fields empty in some or all items: 3

Field	Filled in, of 40 checked	Values in the sample
id	40
name	40	“VALORANT Champions 2026” and 39 other values
slug	40
game	40	valorant in all 40
game_name	40	Valorant in all 40
status	40	Completed in all 40
start_time	40	2026-05-04 to 2026-09-23
prize_pool	31	2,350 to 43,500,000, median 200,000
prize_currency	31	USD (16), MXN (5), EUR (3) and 4 more
prize_pool_usd	31	2,350 to 2,250,000, median 21,436.82
featured	40	true in 5 of 40
participant_count	40	2 to 100, median 12
image_url	40	static.gosugamers.net
url	40	gosugamers.net

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
game	string	No		Game section; one of dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india; omit for all games Allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india.
state	string	No	all	Tournament state; one of all, ongoing, upcoming, past; defaults to all Allowed values: all, ongoing, upcoming, past.
q	string	No		Tournament name prefix, up to 100 characters	VCT
page	integer	No	1	1-based page; defaults to 1 Minimum: 1.
page_size	integer	No	10	Page size, 1 to 100; defaults to 10 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gosugamers/tournaments?game=dota2&state=all&q=coffee&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.gosugamers.net/api/v6/tournaments/parents",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "valorant",
    "state": "past",
    "page": 1,
    "page_size": 3,
    "total_rows": 1508,
    "total_pages": 503,
    "count": 1,
    "tournaments": [
      {
        "id": "63147",
        "name": "VALORANT Champions 2026",
        "slug": "valorant-champions-2026",
        "game": "valorant",
        "game_name": "Valorant",
        "status": "Completed",
        "start_time": "2026-09-23T00:00:00Z",
        "prize_pool": 2250000,
        "prize_currency": "USD",
        "prize_pool_usd": 2250000,
        "featured": true,
        "participant_count": 16,
        "url": "https://www.gosugamers.net/valorant/tournaments/63147-valorant-champions-2026"
      }
    ]
  }
}

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	gosugamers.TournamentsResponse	No
data.count	integer	No		10
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.game	string	No		valorant
data.page	integer	No		1
data.page_size	integer	No		10
data.q	string	No		VCT
data.source_url	string	No		https://www.gosugamers.net/valorant/matches
data.state	string	No	all, ongoing, upcoming, past	all
data.total_pages	integer	No		152
data.total_rows	integer	No		1511
data.tournaments	array	No
data.tournaments[].featured	boolean	No		false
data.tournaments[].game	string	No		valorant
data.tournaments[].game_name	string	No		VALORANT
data.tournaments[].id	string	No		63208
data.tournaments[].image_url	string	No
data.tournaments[].name	string	No		VCT Threshold China 2026
data.tournaments[].participant_count	integer	No		8
data.tournaments[].prize_currency	string	No		USD
data.tournaments[].prize_pool	number	No		500000
data.tournaments[].prize_pool_usd	number	No		500000
data.tournaments[].slug	string	No		vct-threshold-china-2026
data.tournaments[].start_time	string	No		2026-10-20T04:00:00Z
data.tournaments[].status	string	No		Ongoing
data.tournaments[].url	string	No
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/gosugamers/tournaments?game=dota2&state=all&q=coffee&page=1" \
  -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

GosuGamers tournaments API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GosuGamers tournaments API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related