CSGO API

Introduction

Welcome to the unofficial JSON API for Counter-Strike 2. This API provides access to various data aspects of the game, parsed into JSON format for easier integration and use.

You can find this project source code on GitHub.

BASE URL
https://raw.githubusercontent.com/ByMykel/CSGO-API/main/public/api/{language}

The hosted API currently ships 2 languages (out of 28 available). Replace {language} in the URL with one of the folder codes below:

en zh-CN

Need more languages?

Languages are selected by folder code (en, ru, zh-CN, ...).

Locally

npm install
node update.js --languages en,ru,uk
node group.js  --languages en,ru,uk

Use --languages all to run every available language. --force skips the manifest cache check.

In a fork

Set LANGUAGES under Settings → Secrets and variables → Actions → Variables (value: en,ru,uk, or all). Scheduled runs use it. To override once: Actions → Update and Group JSON API → Run workflow, fill the languages input (takes priority over the variable).

Available folder codes:

en zh-CN pt-BR ru es-ES bg cs da nl fi fr de el hu it ja ko es-MX no pl pt-PT ro sv zh-TW th tr uk vi

List all

Object with all items accessible by their id.

GET /all.json

Response Structure

Object with all items accessible by their id:
Each key is an item id (string)
Each value is an item object containing all item data

List skins

Returns an array of all weapon skins grouped by pattern and wear condition.

GET /skins.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
weapon (object) - Weapon information
category (object) - category
pattern (object) - Pattern/skin design
min_float (number) - min float
max_float (number) - max float
rarity (object) - Rarity with color
stattrak (boolean) - stattrak
souvenir (boolean) - souvenir
paint_index (string) - paint index
wears (array) - Available wear conditions
collections (array) - Collections containing this item
crates (array) - Crates containing this item
team (object) - Team information (CT/T)
legacy_model (boolean) - legacy model
image (string) - Image URL
original (object) - Original item data

List skins not grouped

Returns an array of all weapon skins with each wear condition as a separate item.

GET /skins_not_grouped.json

Response Structure

Array of objects with:
id (string) - Unique identifier
skin_id (string) - Reference to grouped skin
name (string) - Item name
description (string) - Item description
weapon (object) - Weapon information
category (object) - category
pattern (object) - Pattern/skin design
min_float (number) - min float
max_float (number) - max float
wear (object) - Specific wear condition
stattrak (boolean) - stattrak
souvenir (boolean) - souvenir
paint_index (string) - paint index
rarity (object) - Rarity with color
market_hash_name (string) - Market hash name
team (object) - Team information (CT/T)
style (object) - Finish style information
legacy_model (boolean) - legacy model
image (string) - Image URL
original (object) - Original item data

List stickers

Returns an array of all available stickers.

GET /stickers.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
crates (array) - Crates containing this item
collections (array) - Collections containing this item
type (string) - Item type
market_hash_name (string|null) - Market hash name
effect (string) - Sticker effect (Foil, Holo, etc.)
tournament (object) - Tournament information
image (string) - Image URL
original (object) - Original item data

List sticker slabs

Returns an array of sticker slabs (sealed stickers that can be opened).

GET /sticker_slabs.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
crates (array) - Crates containing this item
collections (array) - Collections containing this item
type (string) - Item type
market_hash_name (string|null) - Market hash name
effect (string) - Sticker effect (Foil, Holo, etc.)
tournament (object) - Tournament information
image (string) - Image URL
original (object) - Original item data

List keychains

Returns an array of all weapon charms/keychains.

GET /keychains.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
collections (array) - Collections containing this item
market_hash_name (string) - Market hash name
image (string) - Image URL
original (object) - Original item data

List collections

Returns an array of all weapon skin collections.

GET /collections.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
crates (array) - Crates containing this item
contains (array) - Items that can be obtained
image (string) - Image URL
original (object) - Original item data

List crates

This list includes cases, capsules, graffiti boxes, music kit boxes and souvenir packages.

GET /crates.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
type (string|null) - Item type
first_sale_date (string) - First sale date
rarity (object) - Rarity with color
contains (array) - Items that can be obtained
contains_rare (array) - Rare items (knives, etc.)
market_hash_name (string) - Market hash name
rental (boolean) - Whether it's a rental
image (string) - Image URL
model_player (string|null) - Player model path
loot_list (string|null) - loot list
original (object) - Original item data

List keys

Returns an array of all case keys.

GET /keys.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
crates (array) - Crates containing this item
market_hash_name (string) - Market hash name
marketable (boolean) - Whether it's marketable
image (string) - Image URL
original (object) - Original item data

List collectibles

Returns an array of all collectible items (coins, medals, etc.).

GET /collectibles.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
type (string|null) - Item type
genuine (boolean) - Whether it's genuine
market_hash_name (string|null) - Market hash name
image (string) - Image URL
original (object) - Original item data

List agents

Returns an array of all player agents/characters.

GET /agents.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
collections (array) - Collections containing this item
team (object) - Team information (CT/T)
market_hash_name (string) - Market hash name
image (string) - Image URL
model_player (string) - Player model path
original (object) - Original item data

List patches

Returns an array of all agent patches.

GET /patches.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
market_hash_name (string) - Market hash name
image (string) - Image URL
original (object) - Original item data

List graffiti

Returns an array of all graffiti items.

GET /graffiti.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
crates (array) - Crates containing this item
market_hash_name (string) - Market hash name
image (string) - Image URL
original (object) - Original item data

List music kits

Returns an array of all music kits.

GET /music_kits.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (string) - Definition index
rarity (object) - Rarity with color
market_hash_name (string|null) - Market hash name
exclusive (boolean) - Whether it's exclusive
image (string) - Image URL
original (object) - Original item data

List base weapons

Returns an array of all base weapons and default items (gloves, knives, etc.).

GET /base_weapons.json

Response Structure

Array of objects with:
id (string) - Unique identifier
name (string) - Item name
description (string) - Item description
def_index (number) - Definition index
category (object) - category
image (string) - Image URL

List highlights

Returns an array of tournament highlight charms.

GET /highlights.json

Response Structure

Array of objects with:
id (string) - Unique identifier
def_index (string) - Definition index
name (string) - Item name
description (string) - Item description
tournament_event (string) - Tournament event name
team0 (string) - First team name
team1 (string) - Second team name
stage (string) - Tournament stage
tournament_player (string) - Tournament player name
map (string) - Map name
market_hash_name (string) - Market hash name
image (string) - Image URL
video (string) - Video URL
thumbnail (string) - Thumbnail image URL
original (object) - Original item data

Inventory

All items grouped by category for easy lookup. Skins use weapon_id and paint_index as keys, while other categories use def_index.

GET /inventory.json

Response Structure

Object with categories:
skins (object) - Keyed by weapon_id, then paint_index
crates (object) - Keyed by def_index
collectibles (object) - Keyed by def_index
stickers (object) - Keyed by def_index
graffiti (object) - Keyed by def_index
music_kits (object) - Keyed by def_index
keychains (object) - Keyed by def_index
highlights (object) - Keyed by def_index
agents (object) - Keyed by def_index
patches (object) - Keyed by def_index
keys (object) - Keyed by def_index
sticker_slabs (object) - Keyed by def_index
tools (object) - Keyed by def_index
Each item has:
name (string) - Item name
rarity (object|null) - Rarity with color
marketable (boolean) - Whether it's marketable
image (string) - Image URL