Docs menu

GosuGamers API endpoint

GosuGamers head-to-head meetings API

Returns the other recorded meetings between two GosuGamers teams as seen from one match: tournament, start time, both teams with ids, tags and final scores, winner flags and the match URL. The given `match_id` itself is left out; `game` is required by the upstream but does not narrow the list. Take the ids from gosugamers-matches, gosugamers-results or gosugamers-rankings. Two teams with no other meeting return an empty list.

GETapiKey1 credit/requestGosuGamers/gosugamers/encounters

Endpoint facts

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

GosuGamers Esports API Try GosuGamers head-to-head meetings API in Playground GosuGamers API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: required; allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india. The upstream requires it but does not narrow the list by it, so meetings in another game of the same two teams can appear.
match_id: required numeric id of the match whose other meetings are wanted (the id of a gosugamers-matches or gosugamers-results row). That match itself is left out of the list.
team1_id: required numeric id of the first team.
team2_id: required numeric id of the second team.

Notable response behavior:

Each meeting has id, game, start_time, tournament (id, name, slug), both teams (id, name, tag, slug, logo_url, score, winner) and url. game is the requested game, not a value read from the row.
The side order follows the upstream rather than your team1_id/team2_id; match teams by id.
Two teams with no other meeting, or ids that do not exist, return an empty matches list. There is no paging.
Read from the site's signed JSON API, which uses a public key the site ships in its own scripts; the service rediscovers it if the site rotates it.
The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/encounters?game=valorant&match_id=660816&team1_id=38335&team2_id=37547
Items in matches: 1
Fields filled in every checked item: 7

Field	Filled in, of 1 checked	Values in the sample
id	1
game	1	“valorant”
start_time	1	2022-12-10
tournament	1
finished	1	true in 1 of 1
teams	1	median 2 entries
url	1	gosugamers.net

Request parameters

Parameter	Type	Required	Description	Example
x-api-key (header)	string	Yes	API key required
game	string	Yes	Game section of the match; one of dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india Allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india.	valorant
match_id	string	Yes	Numeric id of the match whose other meetings are wanted; that match is left out	660816
team1_id	string	Yes	Numeric id of the first team	38335
team2_id	string	Yes	Numeric id of the second team	37547

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gosugamers/encounters?game=valorant&match_id=660816&team1_id=38335&team2_id=37547" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.gosugamers.net/api/v6/matches/encounters?matchId=660816&op1Id=38335&op2Id=37547&siteSectionName=valorant",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "valorant",
    "match_id": "660816",
    "team1_id": "38335",
    "team2_id": "37547",
    "count": 1,
    "matches": [
      {
        "id": "510742",
        "game": "valorant",
        "start_time": "2022-12-10T19:00:00Z",
        "tournament": {
          "id": "53462",
          "name": "Red Bull Home Ground #3",
          "slug": "red-bull-home-ground-3"
        },
        "finished": true,
        "teams": [
          {
            "name": "Team Vitality",
            "tag": "VIT",
            "id": "38335",
            "slug": "team-vitality",
            "score": 0,
            "winner": false
          },
          {
            "name": "100 Thieves",
            "tag": "100T",
            "id": "37547",
            "slug": "100-thieves",
            "score": 2,
            "winner": true
          }
        ],
        "url": "https://www.gosugamers.net/valorant/tournaments/53462-red-bull-home-ground-3/matches/510742-100-thieves-vs-team-vitality"
      }
    ]
  }
}

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.EncountersResponse	No
data.count	integer	No	1
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.game	string	No	valorant
data.match_id	string	No	660816
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.source_url	string	No	https://www.gosugamers.net/valorant/matches
data.team1_id	string	No	38335
data.team2_id	string	No	37547
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/encounters?game=valorant&match_id=660816&team1_id=38335&team2_id=37547" \
  -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 game sections API documentation GosuGamers match game API documentation GosuGamers match detail API documentation GosuGamers upcoming and live matches API documentation

Open in Playground Back to group

Docs menu

GosuGamers API endpoint

GosuGamers head-to-head meetings API

GETapiKey1 credit/requestGosuGamers/gosugamers/encounters

Endpoint facts

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

GosuGamers Esports API Try GosuGamers head-to-head meetings API in Playground GosuGamers API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: required; allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india. The upstream requires it but does not narrow the list by it, so meetings in another game of the same two teams can appear.
match_id: required numeric id of the match whose other meetings are wanted (the id of a gosugamers-matches or gosugamers-results row). That match itself is left out of the list.
team1_id: required numeric id of the first team.
team2_id: required numeric id of the second team.

Notable response behavior:

Each meeting has id, game, start_time, tournament (id, name, slug), both teams (id, name, tag, slug, logo_url, score, winner) and url. game is the requested game, not a value read from the row.
The side order follows the upstream rather than your team1_id/team2_id; match teams by id.
Two teams with no other meeting, or ids that do not exist, return an empty matches list. There is no paging.
Read from the site's signed JSON API, which uses a public key the site ships in its own scripts; the service rediscovers it if the site rotates it.
The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/encounters?game=valorant&match_id=660816&team1_id=38335&team2_id=37547
Items in matches: 1
Fields filled in every checked item: 7

Field	Filled in, of 1 checked	Values in the sample
id	1
game	1	“valorant”
start_time	1	2022-12-10
tournament	1
finished	1	true in 1 of 1
teams	1	median 2 entries
url	1	gosugamers.net

Request parameters

Parameter	Type	Required	Description	Example
x-api-key (header)	string	Yes	API key required
game	string	Yes	Game section of the match; one of dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india Allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india.	valorant
match_id	string	Yes	Numeric id of the match whose other meetings are wanted; that match is left out	660816
team1_id	string	Yes	Numeric id of the first team	38335
team2_id	string	Yes	Numeric id of the second team	37547

cURL example

curl -X GET "https://api.crawlora.net/api/v1/gosugamers/encounters?game=valorant&match_id=660816&team1_id=38335&team2_id=37547" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.gosugamers.net/api/v6/matches/encounters?matchId=660816&op1Id=38335&op2Id=37547&siteSectionName=valorant",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "valorant",
    "match_id": "660816",
    "team1_id": "38335",
    "team2_id": "37547",
    "count": 1,
    "matches": [
      {
        "id": "510742",
        "game": "valorant",
        "start_time": "2022-12-10T19:00:00Z",
        "tournament": {
          "id": "53462",
          "name": "Red Bull Home Ground #3",
          "slug": "red-bull-home-ground-3"
        },
        "finished": true,
        "teams": [
          {
            "name": "Team Vitality",
            "tag": "VIT",
            "id": "38335",
            "slug": "team-vitality",
            "score": 0,
            "winner": false
          },
          {
            "name": "100 Thieves",
            "tag": "100T",
            "id": "37547",
            "slug": "100-thieves",
            "score": 2,
            "winner": true
          }
        ],
        "url": "https://www.gosugamers.net/valorant/tournaments/53462-red-bull-home-ground-3/matches/510742-100-thieves-vs-team-vitality"
      }
    ]
  }
}

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.EncountersResponse	No
data.count	integer	No	1
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.game	string	No	valorant
data.match_id	string	No	660816
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.source_url	string	No	https://www.gosugamers.net/valorant/matches
data.team1_id	string	No	38335
data.team2_id	string	No	37547
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/encounters?game=valorant&match_id=660816&team1_id=38335&team2_id=37547" \
  -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 head-to-head meetings API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GosuGamers head-to-head meetings API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related