CSGO API

Introduction

An unofficial JSON API for Counter-Strike: Global Offensive.

All data are retrieved from items_game.txt and csgo_english.txt. These files use Valve's KeyValue text file format and have to be parsed with vdf-parser.

This project is open source.

BASE URL
https://bymykel.github.io/CSGO-API/api/{language}

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

Try some experimental API REST endpoints


List skins

GET /skins.json
Schema
Example
array[object]
id
string
name
string
description
string
weapon
string
pattern
string
min_float
number
max_float
number
rarity
string
image
string

List stickers

GET /stickers.json
Schema
Example
array[object]
id
string
name
string
description
string or null
rarity
string or null
image
string

List collections

GET /collections.json
Schema
Example
array[object]
id
string
name
string
image
string

List crates

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

GET /crates.json
Schema
Example
array[object]
id
string
name
string
description
string or null
type
string or null
first_sale_date
string or null
image
string

Filter by type

Capsules with patches

GET /crates/capsules/patches.json

Capsules with pins

GET /crates/capsules/pins.json

Cases

GET /crates/cases.json

Graffiti boxes

GET /crates/graffiti.json

Music kit boxes

GET /crates/music_kit_boxes.json

Souvenir packages

GET /crates/souvenir.json

Rest of crates that don't fit in any type

GET /crates/other.json

List keys

GET /keys.json
Schema
Example
array[object]
id
string
name
string
description
string or null
image
string

List collectibles

GET /collectibles.json
Schema
Example
array[object]
id
string
name
string
description
string or null
rarity
string or null
type
string or null
image
string

Filter by type

Major fantasy team trophies

GET /collectibles/major/fantasy_trophies.json

Major finalists trophies

GET /collectibles/major/finalists_trophies.json

Major pickem coins

GET /collectibles/major/pickem_coins.json

Major old pickem trophy

GET /collectibles/major/pickem_old.json

Operation coins

GET /collectibles/operation/coins.json

Operation stars

GET /collectibles/operation/stars.json

Map Contributor Coins

GET /collectibles/map_coins.json

Pins

GET /collectibles/pins.json

Service medals

GET /collectibles/service_medals.json

Rest of collectibles that don't fit in any type

GET /collectibles/other.json

List agents

GET /agents.json
Schema
Example
array[object]
id
string
name
string
description
string
rarity
string
image
string

List patches

GET /patches.json
Schema
Example
array[object]
id
string
name
string
description
string or null
rarity
string
image
string

List graffiti

GET /graffiti.json
Schema
Example
array[object]
id
string
name
string
description
string or null
rarity
string or null
image
string

List music kits

GET /music_kits.json
Schema
Example
array[object]
id
string
name
string
description
string
rarity
string
exclusive
boolean
image
string

I have created some API REST endpoints to make it easier to retrieve the data.

I'm still working on it, so it may change in the future.

BASE URL
https://cs2-api.vercel.app/api

Search by query

GET /search?page=6&q=paris
{
    "data": [
        {
            "id": "sticker-6661",
            "name": "Sticker | GamerLegion (Glitter) | Paris 2023",
            "description": null,
            "rarity": "Remarkable",
            "image": "https://steamcdn-a.akamaihd.net/..."
        },
        {
            "id": "sticker-6662",
            "name": "Sticker | GamerLegion (Holo) | Paris 2023",
            "description": null,
            "rarity": "Exotic",
            "image": "https://steamcdn-a.akamaihd.net/..."
        },
        {},
        {}
    ],
    "total": 627,
    "page": {
        "prev": "https://cs2-api.vercel.app/api/search?page=5&q=paris",
        "next": "https://cs2-api.vercel.app/api/search?page=7&q=paris"
    }
}

Get all items paginated

GET /items
{
    "data": [
        {
            "id": "agent-4613",
            "name": "Bloody Darryl The Strapped | The Professionals",
            "description": "Before he was leader of the heist gang 'The Pro....",
            "rarity": "Superior",
            "image": "https://steamcdn-a.akamaihd.net/..."
        },
        {
            "id": "agent-4619",
            "name": "'Blueberries' Buckshot | NSWC SEAL",
            "description": "Known as SEAL Team's \\\"Weapon....",
            "rarity": "Exceptional",
            "image": "https://steamcdn-a.akamaihd.net/..."
        },
        {},
        {}
    ],
    "total": 9938,
    "page": {
        "prev": null,
        "next": "https://cs2-api.vercel.app/api/items?page=2"
    }
}

To get an item by id

GET /items?id=skin-1049812
{
    "id": "skin-1049812",
    "name": "M4A4 | Howl",
    "description": "More accurate but less damaging...",
    "weapon": "M4A4",
    "pattern": "Howl",
    "min_float": 0,
    "max_float": 0.4,
    "rarity": "Contraband",
    "stattrak": false,
    "image": "https://steamcdn-a.akamaihd.net/..."
}