Docs menu

VLR API endpoint

VLR.gg news article API

Returns one VLR.gg news article: title, author, UTC publish time, the body as plain-text paragraphs, the teams, players and events it links to (type `team`, `player` or `event`, with id, slug and name), external links and image URLs. Reader comments are not included. Forum threads share the same numeric id space, so an id that is a thread, or does not exist, returns not found. Take `id` from vlr-news.

GETapiKey1 credit/requestVLR/vlr/news-article

Endpoint facts

Method: GET
API path: /vlr/news-article
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg news article API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

id: required numeric article id, the id of a row in vlr-news.

Notable response behavior:

The response has id, url, title, author, published_at (UTC), text (the paragraphs joined by blank lines), paragraphs, references, external_links and images.
Each references entry is a team, player or event the text links to: type is team, player or event, with id, slug, name and url. Each reference appears once. Use the ids with vlr-team, vlr-player or vlr-event.
Reader comments are not included, and the hover cards VLR shows for linked teams and players are left out of text.
Forum threads share the numeric id space with articles, so an id that is a thread, or that does not exist, returns not found.
The response is cached for up to ten minutes.

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
id	string	Yes		Numeric VLR news article id from vlr-news	781119

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/news-article?id=781119" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/781119",
    "fetched_at": "2026-10-28T10:00:00Z",
    "id": "781119",
    "url": "https://www.vlr.gg/781119",
    "title": "Efina set to leave Gen.G as free agent",
    "author": "jenopelle",
    "published_at": "2026-10-28T09:16:51Z",
    "text": "Kim \"Efina\" Nak-yeon has announced that Gen.G ...",
    "paragraphs": [
      "Kim \"Efina\" Nak-yeon has announced that Gen.G ..."
    ],
    "references": [
      {
        "type": "player",
        "id": "985",
        "slug": "efina",
        "name": "Efina",
        "url": "https://www.vlr.gg/player/985/efina"
      },
      {
        "type": "team",
        "id": "17",
        "slug": "gen-g",
        "name": "Gen.G",
        "url": "https://www.vlr.gg/team/17/gen-g"
      }
    ],
    "external_links": [
      "https://x.com/Efinavlrt/status/2115343101439222119"
    ],
    "images": []
  }
}

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	vlr.ArticleDetail	No
data.author	string	No		jenopelle
data.external_links	array	No
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.id	string	No		781119
data.images	array	No
data.paragraphs	array	No
data.published_at	string	No		2026-10-28T09:16:51Z
data.references	array	No
data.references[].id	string	No		17
data.references[].name	string	No		Gen.G
data.references[].slug	string	No		gen-g
data.references[].type	string	No	team, player, event	team
data.references[].url	string	No		https://www.vlr.gg/team/17/gen-g
data.source_url	string	No		https://www.vlr.gg/matches
data.text	string	No
data.title	string	No		Efina set to leave Gen.G as free agent
data.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
404	Not Found	#/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/vlr/news-article?id=781119" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More VLR endpoint docs VLR.gg VALORANT Esports API VLR.gg event agent pick rates API documentation VLR.gg event matches API documentation VLR.gg event player statistics API documentation VLR.gg event detail API documentation VLR.gg events API documentation VLR.gg forum categories API documentation

Open in Playground Back to group

Docs menu

VLR API endpoint

VLR.gg news article API

GETapiKey1 credit/requestVLR/vlr/news-article

Endpoint facts

Method: GET
API path: /vlr/news-article
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg news article API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

id: required numeric article id, the id of a row in vlr-news.

Notable response behavior:

The response has id, url, title, author, published_at (UTC), text (the paragraphs joined by blank lines), paragraphs, references, external_links and images.
Each references entry is a team, player or event the text links to: type is team, player or event, with id, slug, name and url. Each reference appears once. Use the ids with vlr-team, vlr-player or vlr-event.
Reader comments are not included, and the hover cards VLR shows for linked teams and players are left out of text.
Forum threads share the numeric id space with articles, so an id that is a thread, or that does not exist, returns not found.
The response is cached for up to ten minutes.

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
id	string	Yes		Numeric VLR news article id from vlr-news	781119

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/news-article?id=781119" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/781119",
    "fetched_at": "2026-10-28T10:00:00Z",
    "id": "781119",
    "url": "https://www.vlr.gg/781119",
    "title": "Efina set to leave Gen.G as free agent",
    "author": "jenopelle",
    "published_at": "2026-10-28T09:16:51Z",
    "text": "Kim \"Efina\" Nak-yeon has announced that Gen.G ...",
    "paragraphs": [
      "Kim \"Efina\" Nak-yeon has announced that Gen.G ..."
    ],
    "references": [
      {
        "type": "player",
        "id": "985",
        "slug": "efina",
        "name": "Efina",
        "url": "https://www.vlr.gg/player/985/efina"
      },
      {
        "type": "team",
        "id": "17",
        "slug": "gen-g",
        "name": "Gen.G",
        "url": "https://www.vlr.gg/team/17/gen-g"
      }
    ],
    "external_links": [
      "https://x.com/Efinavlrt/status/2115343101439222119"
    ],
    "images": []
  }
}

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	vlr.ArticleDetail	No
data.author	string	No		jenopelle
data.external_links	array	No
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.id	string	No		781119
data.images	array	No
data.paragraphs	array	No
data.published_at	string	No		2026-10-28T09:16:51Z
data.references	array	No
data.references[].id	string	No		17
data.references[].name	string	No		Gen.G
data.references[].slug	string	No		gen-g
data.references[].type	string	No	team, player, event	team
data.references[].url	string	No		https://www.vlr.gg/team/17/gen-g
data.source_url	string	No		https://www.vlr.gg/matches
data.text	string	No
data.title	string	No		Efina set to leave Gen.G as free agent
data.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
404	Not Found	#/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/vlr/news-article?id=781119" \
  -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

VLR.gg news article API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

VLR.gg news article API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related