Docs menu

GosuGamers API endpoint

GosuGamers recent results API

Returns the most recent completed esports matches from GosuGamers, for one `game` or across all games, 10 per page by default and up to 100 with `page` and `page_size`, with final scores and winner flags. `total_rows` reports how many results the site lists. Use gosugamers-match with the returned ids for opponents, ranking and streams.

GETapiKey1 credit/requestGosuGamers/gosugamers/results

Endpoint facts

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

GosuGamers Esports API Try GosuGamers recent results 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 results across all games.
page: optional 1-based page; defaults to 1. Page 1 with the default size is read from the public page; any other page or size is read from the site's JSON API.
page_size: optional page size, 1 to 100; defaults to 10.

Notable response behavior:

Only the first page (up to 10 results) is available; total_rows and total_pages describe the full history on the site.
teams[].winner is derived from the final scores; drawn or unscored matches have no winner.
The response is cached for up to five minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/results?game=valorant&page_size=40
Items in matches: 40
Fields filled in every checked item: 11

Field	Filled in, of 40 checked	Values in the sample
id	40
game	40	valorant in all 40
start_time	40	2026-10-08 to 2026-10-29
tournament	40
stage	40	Main Event in all 40
round	40	“Quarterfinals” and 12 other values
group	40	Playoffs (25), Week 1 (9), Week 2 (6)
match_number	40	1 to 4, median 2
finished	40	true in 40 of 40
teams	40	median 2 entries
url	40	gosugamers.net

Request parameters

Parameter	Type	Required	Default	Description
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.
page	integer	No	1	1-based page; page 1 with the default size is read from the public page, any other page or size from the site's JSON API; 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/results?game=dota2&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.gosugamers.net/valorant/matches",
    "fetched_at": "2026-10-27T10:00:00Z",
    "game": "valorant",
    "page": 1,
    "page_size": 10,
    "total_rows": 1647,
    "total_pages": 165,
    "count": 1,
    "matches": [
      {
        "id": "663300",
        "game": "valorant",
        "start_time": "2026-10-27T12:45:00Z",
        "tournament": {
          "id": "63208",
          "name": "VCT Threshold China 2026",
          "slug": "vct-threshold-china-2026"
        },
        "stage": "Main Event",
        "round": "Round 1",
        "group": "Week 2",
        "match_number": 2,
        "venue": "The Hub, Shanghai, China",
        "finished": true,
        "teams": [
          {
            "name": "Unsettled Resentment",
            "tag": "UR",
            "id": "58200",
            "score": 2,
            "winner": true
          },
          {
            "name": "Victory No Limits Gaming",
            "tag": "VLG",
            "id": "58210",
            "score": 1,
            "winner": false
          }
        ],
        "url": "https://www.gosugamers.net/valorant/tournaments/63208-vct-threshold-china-2026/matches/663300-wolves-esports-vs-world-sports-invictus-gaming"
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	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.MatchListResponse	No
data.count	integer	No	10
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.game	string	No	valorant
data.matches	array	No		MatchSummary record, 22 fields: finished, game, group, id, match_number, round, stage, start_time, teams, tournament, url, venue. Described under GosuGamers team profile API.
data.page	integer	No	1
data.page_size	integer	No	10
data.source_url	string	No	https://www.gosugamers.net/valorant/matches
data.total_pages	integer	No	165
data.total_rows	integer	No	1647
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/results?game=dota2&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 recent results API

GETapiKey1 credit/requestGosuGamers/gosugamers/results

Endpoint facts

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

GosuGamers Esports API Try GosuGamers recent results 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 results across all games.
page: optional 1-based page; defaults to 1. Page 1 with the default size is read from the public page; any other page or size is read from the site's JSON API.
page_size: optional page size, 1 to 100; defaults to 10.

Notable response behavior:

Only the first page (up to 10 results) is available; total_rows and total_pages describe the full history on the site.
teams[].winner is derived from the final scores; drawn or unscored matches have no winner.
The response is cached for up to five minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/results?game=valorant&page_size=40
Items in matches: 40
Fields filled in every checked item: 11

Field	Filled in, of 40 checked	Values in the sample
id	40
game	40	valorant in all 40
start_time	40	2026-10-08 to 2026-10-29
tournament	40
stage	40	Main Event in all 40
round	40	“Quarterfinals” and 12 other values
group	40	Playoffs (25), Week 1 (9), Week 2 (6)
match_number	40	1 to 4, median 2
finished	40	true in 40 of 40
teams	40	median 2 entries
url	40	gosugamers.net

Request parameters

Parameter	Type	Required	Default	Description
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.
page	integer	No	1	1-based page; page 1 with the default size is read from the public page, any other page or size from the site's JSON API; 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/results?game=dota2&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.gosugamers.net/valorant/matches",
    "fetched_at": "2026-10-27T10:00:00Z",
    "game": "valorant",
    "page": 1,
    "page_size": 10,
    "total_rows": 1647,
    "total_pages": 165,
    "count": 1,
    "matches": [
      {
        "id": "663300",
        "game": "valorant",
        "start_time": "2026-10-27T12:45:00Z",
        "tournament": {
          "id": "63208",
          "name": "VCT Threshold China 2026",
          "slug": "vct-threshold-china-2026"
        },
        "stage": "Main Event",
        "round": "Round 1",
        "group": "Week 2",
        "match_number": 2,
        "venue": "The Hub, Shanghai, China",
        "finished": true,
        "teams": [
          {
            "name": "Unsettled Resentment",
            "tag": "UR",
            "id": "58200",
            "score": 2,
            "winner": true
          },
          {
            "name": "Victory No Limits Gaming",
            "tag": "VLG",
            "id": "58210",
            "score": 1,
            "winner": false
          }
        ],
        "url": "https://www.gosugamers.net/valorant/tournaments/63208-vct-threshold-china-2026/matches/663300-wolves-esports-vs-world-sports-invictus-gaming"
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	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.MatchListResponse	No
data.count	integer	No	10
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.game	string	No	valorant
data.matches	array	No		MatchSummary record, 22 fields: finished, game, group, id, match_number, round, stage, start_time, teams, tournament, url, venue. Described under GosuGamers team profile API.
data.page	integer	No	1
data.page_size	integer	No	10
data.source_url	string	No	https://www.gosugamers.net/valorant/matches
data.total_pages	integer	No	165
data.total_rows	integer	No	1647
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/results?game=dota2&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 recent results API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GosuGamers recent results API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related