Docs menu

GosuGamers API endpoint

GosuGamers news and features archive API

Pages the GosuGamers news and features archive (51,051 articles), newest first, with optional `section` and `type` filters: id, type, title, teaser, section, publish time, author, image and URL. `section` is one of the 15 sections that carry articles (the six esports titles, Wild Rift, Free Fire, Battlegrounds Mobile India and the editorial sections entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings and umamusume-pretty-derby); an article can belong to several sections. `type` is `news` or `features`. Paged with `page` and `page_size` (up to 100). Use gosugamers-article with a returned id for the text.

GETapiKey1 credit/requestGosuGamers/gosugamers/articles

Endpoint facts

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

GosuGamers Esports API Try GosuGamers news and features archive API in Playground GosuGamers API documentation

How this endpoint behaves

Pages the GosuGamers news and features archive (51,051 articles on 2026-10-29), newest first.

Header: x-api-key required.

Parameters:

section: optional; allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby. Omit it for all sections. An article can belong to several sections, so the per-section totals add up to more than the archive.
type: optional; allowed values: news, features. Omit it for both. The two add up to the whole archive (47,036 news and 4,015 features).
page: optional 1-based page; defaults to 1.
page_size: optional page size, 1 to 100; defaults to 10.

Notable response behavior:

Each article has id, type (news or features), title, teaser, section (the section it is filed under on the site), published_at, author, image_url and url. Use the id with gosugamers-article for the text.
total_rows and total_pages describe the filtered archive. A page past the end, and a section with no articles (free-fire, battlegrounds-mobile-india), return an empty articles list.
Section totals on 2026-10-29: dota2 12,018, counterstrike 4,357, lol 4,086, entertainment 3,869, mobile-legends 921, valorant 757, genshin-impact 170, pubg-mobile 156, zenless-zone-zero 140, honor-of-kings 110, honkai-star-rail 86, wild-rift 68, umamusume-pretty-derby 46.
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 five minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/articles?section=valorant&page_size=40
Items in articles: 40
Fields filled in every checked item: 8
Fields empty in some or all items: 1

Field	Filled in, of 40 checked	Values in the sample
id	40
type	40	news in all 40
title	40	median 80 characters
teaser	40	median 83 characters
section	40	valorant (33), general (7)
published_at	40	2025-06-22 to 2026-10-21
image_url	40	static.gosugamers.net
url	40	gosugamers.net
author	3

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
section	string	No		Article section; one of dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby; omit for all Allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby.
type	string	No		Article type; one of news, features; omit for both Allowed values: news, features.
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/articles?section=dota2&type=news&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/articles?pageNo=1&pageSize=3&siteSectionName=valorant",
    "fetched_at": "2026-10-29T10:00:00Z",
    "section": "valorant",
    "page": 1,
    "page_size": 3,
    "total_rows": 757,
    "total_pages": 253,
    "count": 1,
    "articles": [
      {
        "id": "79434",
        "type": "news",
        "title": "Magical life sim Witchbrook finally gets January 2027 release date, new trailer shows off gameplay",
        "teaser": "Witchbrook has a release date at last.",
        "section": "gaming",
        "published_at": "2026-10-28T15:25:00Z",
        "author": "Timaugustin",
        "image_url": "https://static.gosugamers.net/96/c2/a5/30cb9941554614eeb00081f1338ee8691699f71f9b4ad2715a728c1204.webp",
        "url": "https://www.gosugamers.net/entertainment/news/79434-magical-life-sim-witchbrook-finally-gets-january-2027-release-date-new-trailer-shows-off-gameplay"
      }
    ]
  }
}

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.ArticlesResponse	No
data.articles	array	No
data.articles[].author	string	No		Timaugustin
data.articles[].id	string	No		79434
data.articles[].image_url	string	No
data.articles[].published_at	string	No		2026-10-28T15:25:00Z
data.articles[].section	string	No		entertainment
data.articles[].teaser	string	No
data.articles[].title	string	No
data.articles[].type	string	No	news, features	news
data.articles[].url	string	No
data.count	integer	No		10
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.page	integer	No		1
data.page_size	integer	No		10
data.section	string	No		valorant
data.source_url	string	No		https://www.gosugamers.net/valorant/matches
data.total_pages	integer	No		5106
data.total_rows	integer	No		51051
data.type	string	No	news, features	news
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/articles?section=dota2&type=news&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 head-to-head meetings 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 news and features archive API

GETapiKey1 credit/requestGosuGamers/gosugamers/articles

Endpoint facts

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

GosuGamers Esports API Try GosuGamers news and features archive API in Playground GosuGamers API documentation

How this endpoint behaves

Pages the GosuGamers news and features archive (51,051 articles on 2026-10-29), newest first.

Header: x-api-key required.

Parameters:

section: optional; allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby. Omit it for all sections. An article can belong to several sections, so the per-section totals add up to more than the archive.
type: optional; allowed values: news, features. Omit it for both. The two add up to the whole archive (47,036 news and 4,015 features).
page: optional 1-based page; defaults to 1.
page_size: optional page size, 1 to 100; defaults to 10.

Notable response behavior:

Each article has id, type (news or features), title, teaser, section (the section it is filed under on the site), published_at, author, image_url and url. Use the id with gosugamers-article for the text.
total_rows and total_pages describe the filtered archive. A page past the end, and a section with no articles (free-fire, battlegrounds-mobile-india), return an empty articles list.
Section totals on 2026-10-29: dota2 12,018, counterstrike 4,357, lol 4,086, entertainment 3,869, mobile-legends 921, valorant 757, genshin-impact 170, pubg-mobile 156, zenless-zone-zero 140, honor-of-kings 110, honkai-star-rail 86, wild-rift 68, umamusume-pretty-derby 46.
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 five minutes.

Sampled response

Request, 29 Oct 2026: GET /gosugamers/articles?section=valorant&page_size=40
Items in articles: 40
Fields filled in every checked item: 8
Fields empty in some or all items: 1

Field	Filled in, of 40 checked	Values in the sample
id	40
type	40	news in all 40
title	40	median 80 characters
teaser	40	median 83 characters
section	40	valorant (33), general (7)
published_at	40	2025-06-22 to 2026-10-21
image_url	40	static.gosugamers.net
url	40	gosugamers.net
author	3

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
section	string	No		Article section; one of dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby; omit for all Allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby.
type	string	No		Article type; one of news, features; omit for both Allowed values: news, features.
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/articles?section=dota2&type=news&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/articles?pageNo=1&pageSize=3&siteSectionName=valorant",
    "fetched_at": "2026-10-29T10:00:00Z",
    "section": "valorant",
    "page": 1,
    "page_size": 3,
    "total_rows": 757,
    "total_pages": 253,
    "count": 1,
    "articles": [
      {
        "id": "79434",
        "type": "news",
        "title": "Magical life sim Witchbrook finally gets January 2027 release date, new trailer shows off gameplay",
        "teaser": "Witchbrook has a release date at last.",
        "section": "gaming",
        "published_at": "2026-10-28T15:25:00Z",
        "author": "Timaugustin",
        "image_url": "https://static.gosugamers.net/96/c2/a5/30cb9941554614eeb00081f1338ee8691699f71f9b4ad2715a728c1204.webp",
        "url": "https://www.gosugamers.net/entertainment/news/79434-magical-life-sim-witchbrook-finally-gets-january-2027-release-date-new-trailer-shows-off-gameplay"
      }
    ]
  }
}

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.ArticlesResponse	No
data.articles	array	No
data.articles[].author	string	No		Timaugustin
data.articles[].id	string	No		79434
data.articles[].image_url	string	No
data.articles[].published_at	string	No		2026-10-28T15:25:00Z
data.articles[].section	string	No		entertainment
data.articles[].teaser	string	No
data.articles[].title	string	No
data.articles[].type	string	No	news, features	news
data.articles[].url	string	No
data.count	integer	No		10
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.page	integer	No		1
data.page_size	integer	No		10
data.section	string	No		valorant
data.source_url	string	No		https://www.gosugamers.net/valorant/matches
data.total_pages	integer	No		5106
data.total_rows	integer	No		51051
data.type	string	No	news, features	news
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/articles?section=dota2&type=news&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 news and features archive API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

GosuGamers news and features archive API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related