MENU navbar-image

Introduction

The CSGOSKINS.GG API provides detailed information about CS2 items.

This documentation aims to provide all the information you need to work with our API.

Status codes

This is a list of all possible HTTP status codes that our API may return:

Errors

Every response with an HTTP status code that is not 200 is considered to be an error. Error responses always contain a message JSON key which describes the error in human-readable text. We recommend to use the list of HTTP status codes to identify errors.

Rate limiting

Our API is rate limited to prevent abuse that would degrade our ability to maintain consistent API performance for all users. There is no global rate limit, each endpoint has its individual rate limit. This rate limit can always be found in the documentation of the specific endpoint.

Additionally, our API always returns a X-RateLimit-Limit header which tells you the number of requests you can make to the given endpoint per minute. The X-RateLimit-Remaining header tells you how many requests you currently have left. Once you are being rate limited, HTTP response code 429 is returned. The X-RateLimit-Reset header is then also present, which gives you the unix timestamp of when the rate limit is lifted.

Pagination

Some endpoints support pagination. Those endpoints accept a page parameter, which lets you specify which page to retrieve. Additionally, the limit parameter can be used to set the number of results to return per page.

Changelog

Any changes to our API are listed here. We never release any breaking changes without sufficient prior notice via email. However, we may add new fields to responses. Make sure to design your application with that in mind, so no issues arise from new fields being present in API responses.

2023-11-11

2023-03-07

2022-12-26

2021-10-08

2021-08-10

2021-08-01

2021-06-22

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_API_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

Please note that an active subscription is required to use our API. You can check out our available subscription plans here. After you signed up and created your subscription, you can generate an API key in your dashboard.

Endpoints

List Prices

requires authentication

Pro Plan, Business Plan

10 req/min rate limit

List prices for all items and from all markets. This endpoint returns all items for which pricing data exists in the chosen range. Item prices and listed quantities from all available markets are returned for each item.

Prices are updated once every 5 minutes for most markets. Prices for some markets can take longer than 5 minutes to be updated. From a practical standpoint, it's not recommended to request this endpoint more than once per minute.

When using a historical range (anything other than current), the aggregator parameter determines which price is selected. Historical prices are saved once per day, so the avg aggregator with a 30d range would evaluate the 30 price entries of the past 30 days and then retrieve the average price of that data set. The same goes for the returned quantity and volume.

Example request:
curl --request GET \
    --get "https://csgoskins.gg/api/v1/prices" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --data "{
    \"range\": \"180d\",
    \"aggregator\": \"median\"
}"

const url = new URL(
    "https://csgoskins.gg/api/v1/prices"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "range": "180d",
    "aggregator": "median"
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://csgoskins.gg/api/v1/prices';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
        ],
        'json' => [
            'range' => '180d',
            'aggregator' => 'median',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/prices'
payload = {
    "range": "180d",
    "aggregator": "median"
}
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}',
  'Content-Type': 'application/json'
}

response = requests.request('GET', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "data": [
        {
            "market_hash_name": "AK-47 | Aquamarine Revenge (Battle-Scarred)",
            "prices": [
                {
                    "market": "steam",
                    "price": 1277,
                    "quantity": 43,
                    "volume": 107,
                    "updated_at": 1626566412
                },
                {
                    "market": "skinport",
                    "price": 1560,
                    "quantity": 6,
                    "volume": null,
                    "updated_at": 1626566653
                }
            ]
        },
        {
            "market_hash_name": "AK-47 | Aquamarine Revenge (Factory New)",
            "prices": [
                {
                    "market": "steam",
                    "price": 5270,
                    "quantity": 25,
                    "volume": 37,
                    "updated_at": 1626566273
                },
                {
                    "market": "skinport",
                    "price": 5973,
                    "quantity": 14,
                    "volume": null,
                    "updated_at": 1626566484
                }
            ]
        }
    ]
}

Request   

GET api/v1/prices

Headers

Authorization      

Example: Bearer {YOUR_API_KEY}

Content-Type      

Example: application/json

Query Parameters

range   string  optional  

The range in which prices are measured in. Allowed values are current (default), 7d, 30d, 60d, 90d, 180d (Business Plan), 365d (Business Plan). When current is used, the aggregator parameter has no effect because the most recent price is automatically selected.

aggregator   string  optional  

The aggregator function that is used to measure the price. Allowed values are min (default), max, avg, and median.

Body Parameters

range   string  optional  

Example: 180d

Must be one of:
  • current
  • 7d
  • 30d
  • 60d
  • 90d
  • 180d
  • 365d
aggregator   string  optional  

Example: median

Must be one of:
  • min
  • max
  • avg
  • median

Response

Response Fields

data   object[]   

An array of objects where each array element represents a specific item.
market_hash_name   string   

The market_hash_name of the item.

prices   object[]   

An array of objects where each array element represents the price on a specific market.
market   string   

The identifier of the marketplace.

price   integer   

The price in USD cents for the item.

quantity   integer   

The number of all available listings for the item (at any price).

volume   int|null   

The number of sales for the item (at any price). Currently only available for Steam.

updated_at   integer   

The unix timestamp of when the price and quantity were last updated.

List Price Histories

requires authentication

Pro Plan, Business Plan

20 req/min rate limit

List historical price data for all items and from all markets. You can use the range parameter to set the number of days for which price data will be returned.

Example request:
curl --request GET \
    --get "https://csgoskins.gg/api/v1/price-histories" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --data "{
    \"range\": \"60d\",
    \"page\": 7,
    \"limit\": 8
}"

const url = new URL(
    "https://csgoskins.gg/api/v1/price-histories"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "range": "60d",
    "page": 7,
    "limit": 8
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://csgoskins.gg/api/v1/price-histories';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
        ],
        'json' => [
            'range' => '60d',
            'page' => 7,
            'limit' => 8,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/price-histories'
payload = {
    "range": "60d",
    "page": 7,
    "limit": 8
}
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}',
  'Content-Type': 'application/json'
}

response = requests.request('GET', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "meta": {
        "total": 13971,
        "per_page": 20,
        "current_page": 1,
        "last_page": 700
    },
    "data": [
        {
            "market_hash_name": "2020 RMR Challengers",
            "dates": [
                {
                    "date": "2021-08-09",
                    "prices": [
                        {
                            "market": "skinport",
                            "price": 28,
                            "quantity": 275,
                            "volume": null
                        },
                        {
                            "market": "steam",
                            "price": 28,
                            "quantity": 8397,
                            "volume": 1043
                        }
                    ]
                },
                {
                    "date": "2021-08-08",
                    "prices": [
                        {
                            "market": "skinport",
                            "price": 27,
                            "quantity": 245,
                            "volume": null
                        },
                        {
                            "market": "steam",
                            "price": 29,
                            "quantity": 8191,
                            "volume": 974
                        }
                    ]
                }
            ]
        }
    ]
}

Request   

GET api/v1/price-histories

Headers

Authorization      

Example: Bearer {YOUR_API_KEY}

Content-Type      

Example: application/json

Query Parameters

range   string  optional  

The range for which to return price histories. Allowed values are 7d (default), 30d, 60d, 90d, 180d (Business Plan), 365d (Business Plan).

page   integer  optional  

The page to retrieve, defaults to 1. The meta.last_page field returns the last available page.

limit   integer  optional  

The number of items to return per page, defaults to 20. Must be a number between 1 and 20.

Body Parameters

range   string  optional  

Example: 60d

Must be one of:
  • 7d
  • 30d
  • 60d
  • 90d
  • 180d
  • 365d
page   integer  optional  

Must be at least 1. Must not be greater than 999999999. Example: 7

limit   integer  optional  

Must be at least 1. Must not be greater than 20. Example: 8

Response

Response Fields

meta   object   

An object containing metadata about the response.
total   integer   

The total number of items in our database.

per_page   integer   

The number of items that are returned per requested page.

current_page   integer   

The number of the current page.

last_page   integer   

The number of the last available page.

data   object[]   

An array of objects where each array element represents a specific item.
market_hash_name   string   

The market_hash_name of the item.

dates   object[]   

An array of objects where each array element represents a specific day.
date   string   

The historical date for which prices are returned.

prices   object[]   

An array of objects where each array element represents the price on a specific market.
market   string   

The identifier of the marketplace.

price   integer   

The price in USD cents for the item.

quantity   integer   

The number of all available listings for the item (at any price).

volume   int|null   

The number of sales for the item (at any price). Currently only available for Steam.

requires authentication

Pro Plan, Business Plan

10 req/min rate limit

List offer links for all markets. An offer is an item that is listed on a specific marketplace. Every offer has a link, which is the direct URL for the offer on the marketplace. Note that this endpoint only returns links for offers which are currently listed on the given marketplace.

Example request:
curl --request GET \
    --get "https://csgoskins.gg/api/v1/offer-links" \
    --header "Authorization: Bearer {YOUR_API_KEY}"
const url = new URL(
    "https://csgoskins.gg/api/v1/offer-links"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://csgoskins.gg/api/v1/offer-links';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/offer-links'
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


{
    "data": [
        {
            "market_hash_name": "AK-47 | Aquamarine Revenge (Battle-Scarred)",
            "links": [
                {
                    "market": "buff163",
                    "url": "https://buff.163.com/market/goods?goods_id=33858",
                    "key": 33858
                },
                {
                    "market": "skinport",
                    "url": "https://skinport.com/item/ak-47-aquamarine-revenge-battle-scarred?r=csgoskins",
                    "key": null
                }
            ]
        },
        {
            "market_hash_name": "AK-47 | Aquamarine Revenge (Factory New)",
            "links": [
                {
                    "market": "buff163",
                    "url": "https://buff.163.com/market/goods?goods_id=33859",
                    "key": 33859
                },
                {
                    "market": "skinport",
                    "url": "https://skinport.com/item/ak-47-aquamarine-revenge-factory-new?r=csgoskins",
                    "key": null
                }
            ]
        }
    ]
}

Response

Response Fields

data   object[]   

An array of objects where each array element represents an offer link.
market_hash_name   string   

The market_hash_name of the item.

links   object[]   

An array of objects where each array element represents a link.
market   string   

The identifier of the marketplace.

url   string   

The URL to the offer on the marketplace.

key   string|null   

This is the external key of the offer. Only some markets such as buff163 have this value, for most markets this will be null.

List Basic Item Details

requires authentication

Pro Plan

60 req/min rate limit

List all CS2 items with basic information about each item.

Example request:
curl --request GET \
    --get "https://csgoskins.gg/api/v1/basic-item-details" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --data "{
    \"page\": 1,
    \"limit\": 15
}"

const url = new URL(
    "https://csgoskins.gg/api/v1/basic-item-details"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "page": 1,
    "limit": 15
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://csgoskins.gg/api/v1/basic-item-details';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
        ],
        'json' => [
            'page' => 1,
            'limit' => 15,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/basic-item-details'
payload = {
    "page": 1,
    "limit": 15
}
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}',
  'Content-Type': 'application/json'
}

response = requests.request('GET', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "meta": {
        "total": 17221,
        "per_page": 100,
        "current_page": 1,
        "last_page": 173
    },
    "data": [
        {
            "market_hash_name": "Imaginary Item",
            "image_url": "https://cdn.csgoskins.gg/public/uih/products/aHR0cHM6Ly9zdGVhbWNvbW11bml0eS1hLmFrYW1haWhkLm5ldC9lY29ub215L2ltYWdlLy05YTgxZGxXTHdKMlVVR2NWc19uc1Z0emRPRWR0V3dLR1paTFFIVHhEWjdJNTZLVTBad3dvNE5VWDRvRkpaRUhMYlhBNlExTkw0a21yQWxPQTBfRlZQQ2kydF9mVWtSeE56dFVvcmVhT0JCaHg4emVjQzlMN2RLaWtzN1R3Nlh4TU9uUWxUTUY2NXdtMC1pUXBJbjMwQWJrOHhjNWFqaW5kZENXSXdFNlkxellfVm01MzY2eDBoTm1iRkQ3LzUxMngzODQ-/auto/auto/85/notrim/b50f3b556dec1cf4de48d7ed761abdd6.png",
            "image_url_steam": "https://steamcommunity-a.akamaihd.net/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRfQ1_ESOr_h56LHE59IjtE57e1JwJf1PzEdQJO7c6xkc7dwaWiYe3SlzwIuZBy3uzEp9qg3Vbn-0c4YGyhcY7HIFI8aVHS_lm5366x0qhmo9uG/512x384",
            "stattrak": true,
            "souvenir": false,
            "type": {
                "name": "Rifle"
            },
            "category": {
                "name": "Skin"
            },
            "exterior": {
                "name": "Field-Tested"
            },
            "tint": {
                "name": "Bazooka Pink"
            },
            "weapon": {
                "name": "AK-47"
            },
            "tournament": {
                "name": "2019 StarLadder Berlin Championship"
            },
            "team": {
                "name": "G2 Esports"
            },
            "player": {
                "name": "kennyS"
            },
            "rarity": {
                "name": "Classified"
            },
            "paintkits": [
                {
                    "name": "Redline",
                    "phase": "Ruby"
                }
            ],
            "containers": [
                {
                    "name": "Operation Phoenix Weapon Case"
                }
            ],
            "collections": [
                {
                    "name": "The Phoenix Collection"
                }
            ]
        }
    ]
}

Request   

GET api/v1/basic-item-details

Headers

Authorization      

Example: Bearer {YOUR_API_KEY}

Content-Type      

Example: application/json

Query Parameters

page   integer  optional  

The page to retrieve, defaults to 1. The meta.last_page field returns the last available page.

limit   integer  optional  

The number of items to return per page, defaults to 100. Must be a number between 1 and 100.

Body Parameters

page   integer  optional  

Must be at least 1. Must not be greater than 999999999. Example: 1

limit   integer  optional  

Must be at least 1. Must not be greater than 100. Example: 15

Response

Response Fields

meta   object   

An object containing metadata about the response.
total   integer   

The total number of items in our database.

per_page   integer   

The number of items that are returned per requested page.

current_page   integer   

The number of the current page.

last_page   integer   

The number of the last available page.

data   object[]   

An array of objects where each array element represents a specific item.
market_hash_name   string   

The market_hash_name of the item.

image_url   string   

The image URL of the item, hosted on our CDN.

image_url_steam   string|null   

The image URL of the item, hosted on Steam.

stattrak   boolean   

Whether this item is a StatTrak version or not.

souvenir   boolean   

Whether this item is a Souvenir version or not.

type   object   

Information about the type of the item.
name   string   

The name of the item type.

category   object   

Information about the category of the item.
name   string   

The name of the item category.

exterior   object|null   

Information about the exterior of the item. Only available for skins.
name   string   

The name of the item exterior.

tint   object|null   

Information about the tint of the item. Only available for certain stickers.
name   string   

The name of the item tint.

weapon   object|null   

Information about the weapon of the item. Only available for skins.
name   string   

The name of the weapon.

tournament   object|null   

Information about the CS2 tournament which the item was released with.
Only available for tournament items such as stickers and graffiti.
name   string   

The name of the tournament.

team   object|null   

Information about the team which the item belongs to. Only available for stickers and graffiti.
name   string   

The name of the team.

player   object|null   

Information about the player which the item belongs to. Only available for stickers.
name   string   

The name of the player.

rarity   object|null   

Information about the rarity of the item.
name   string   

The name of the rarity.

paintkits   object[]   

The paintkits (or finishes) which are available for this item.
Only available for skins.
Most skins only have a single paintkit.
Only Dopplers and Gamma Dopplers can have multiple paintkits.
name   string   

The name of the paintkit.

phase   string|null   

The Doppler phase of the paintkit.

containers   object[]   

The containers that contain the item.
name   string   

The name of the container.

collections   object[]   

The collections that the item belongs to.
name   string   

The name of the collection.

List Advanced Item Details

requires authentication

Business Plan

60 req/min rate limit

List all CS2 items with advanced information about each item.

Example request:
curl --request GET \
    --get "https://csgoskins.gg/api/v1/advanced-item-details" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --data "{
    \"page\": 12,
    \"limit\": 16
}"

const url = new URL(
    "https://csgoskins.gg/api/v1/advanced-item-details"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "page": 12,
    "limit": 16
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://csgoskins.gg/api/v1/advanced-item-details';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
        ],
        'json' => [
            'page' => 12,
            'limit' => 16,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/advanced-item-details'
payload = {
    "page": 12,
    "limit": 16
}
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}',
  'Content-Type': 'application/json'
}

response = requests.request('GET', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "meta": {
        "total": 17221,
        "per_page": 100,
        "current_page": 1,
        "last_page": 173
    },
    "data": [
        {
            "market_hash_name": "Imaginary Item",
            "image_url": "https://cdn.csgoskins.gg/public/uih/products/aHR0cHM6Ly9zdGVhbWNvbW11bml0eS1hLmFrYW1haWhkLm5ldC9lY29ub215L2ltYWdlLy05YTgxZGxXTHdKMlVVR2NWc19uc1Z0emRPRWR0V3dLR1paTFFIVHhEWjdJNTZLVTBad3dvNE5VWDRvRkpaRUhMYlhBNlExTkw0a21yQWxPQTBfRlZQQ2kydF9mVWtSeE56dFVvcmVhT0JCaHg4emVjQzlMN2RLaWtzN1R3Nlh4TU9uUWxUTUY2NXdtMC1pUXBJbjMwQWJrOHhjNWFqaW5kZENXSXdFNlkxellfVm01MzY2eDBoTm1iRkQ3LzUxMngzODQ-/auto/auto/85/notrim/b50f3b556dec1cf4de48d7ed761abdd6.png",
            "image_url_steam": "https://steamcommunity-a.akamaihd.net/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRfQ1_ESOr_h56LHE59IjtE57e1JwJf1PzEdQJO7c6xkc7dwaWiYe3SlzwIuZBy3uzEp9qg3Vbn-0c4YGyhcY7HIFI8aVHS_lm5366x0qhmo9uG/512x384",
            "inspect_url": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20M3475067761979237163A22000338544D7965642962764830214",
            "stattrak": true,
            "souvenir": false,
            "popularity": 25,
            "description": "50% of the proceeds from the sale of this sticker support the included players and organizations.",
            "type": {
                "name": "Rifle",
                "image_url": "https://cdn.csgoskins.gg/public/uih/types/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3R5cGVzL3JpZmxlLnBuZw--/auto/auto/85/notrim/82b8fb7dc067b06c72ebc0758461fdcb.png"
            },
            "category": {
                "name": "Skin",
                "image_url": "https://cdn.csgoskins.gg/public/uih/categories/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL2NhdGVnb3JpZXMvc2tpbi5wbmc-/auto/auto/85/notrim/d5a8ea882ffdc9c7511261a1b6ab2329.png"
            },
            "exterior": {
                "name": "Field-Tested",
                "name_short": "FT"
            },
            "tint": {
                "name": "Bazooka Pink",
                "color": "#ba68b2"
            },
            "workshop": {
                "id": "192361478",
                "url": "https://steamcommunity.com/sharedfiles/filedetails/?id=192361478"
            },
            "key": {
                "name": "Falchion Case Key",
                "image_url": "https://cdn.csgoskins.gg/public/uih/items/aHR0cHM6Ly9zdGVhbWNkbi1hLmFrYW1haWhkLm5ldC9hcHBzLzczMC9pY29ucy9lY29uL3Rvb2xzL2NyYXRlX2tleV9jb21tdW5pdHlfOC4yZjgwYzcyMDliZDA4NTMzODUzMjZkNGE2NzEyZTQwNzk4MWE3N2FhLnBuZw--/auto/auto/85/notrim/cb69b47378c329bef914621f9111395a.png"
            },
            "weapon": {
                "name": "AK-47",
                "defindex": "7",
                "type": "Rifle",
                "description": "Powerful and reliable, the AK-47 is one of the most popular assault rifles in the world. It is most deadly in short, controlled bursts of fire.",
                "image_url": "https://cdn.csgoskins.gg/public/uih/weapons/aHR0cHM6Ly9zdGVhbWNkbi1hLmFrYW1haWhkLm5ldC9hcHBzLzczMC9pY29ucy9lY29uL3dlYXBvbnMvYmFzZV93ZWFwb25zL3dlYXBvbl9hazQ3LmEzMjBmMTNmZWE0ZjIxZDFlYjNiNDY2NzhkNmIxMmU5N2NiZDEwNTIucG5n/auto/auto/85/notrim/1848f214868d131c61206fdd2d72ca31.png"
            },
            "tournament": {
                "name": "2019 StarLadder Berlin Championship",
                "name_short": "2019 StarLadder Berlin",
                "location": "Berlin 2019",
                "city": "Berlin",
                "year": "2019",
                "image_url": "https://cdn.csgoskins.gg/public/uih/tournaments/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3RvdXJuYW1lbnRzLzIwMTktc3RhcmxhZGRlci1iZXJsaW4ucG5n/auto/auto/85/notrim/65ee49e4009874ac345a01a55da2ec47.png"
            },
            "team": {
                "name": "G2 Esports",
                "tag": "G2",
                "geo": "EU",
                "image_url": "https://cdn.csgoskins.gg/public/uih/teams/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3RvdXJuYW1lbnRzLzIwMTktc3RhcmxhZGRlci1iZXJsaW4ucG5n/auto/auto/85/notrim/65ee49e4009874ac345a01a55da2ec47.png"
            },
            "player": {
                "name": "kennyS",
                "name_real": "Kenny Schrub",
                "geo": "FR",
                "steamid": "76561198024905796",
                "image_url": "https://cdn.csgoskins.gg/public/uih/players/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3RvdXJuYW1lbnRzLzIwMTktc3RhcmxhZGRlci1iZXJsaW4ucG5n/auto/auto/85/notrim/65ee49e4009874ac345a01a55da2ec47.png"
            },
            "film": {
                "name": "Paper",
                "image_url": "https://cdn.csgoskins.gg/public/uih/films/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL2ZpbG1zL3BhcGVyLnBuZw--/auto/auto/85/notrim/ab20caf96069dcf4af4132cd31d7ce04.png"
            },
            "side": {
                "name": "Counter-Terrorists",
                "name_short": "CT",
                "image_url": "https://cdn.csgoskins.gg/public/uih/sides/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3NpZGVzL2NvdW50ZXItdGVycm9yaXN0cy5wbmc-/auto/auto/85/notrim/6b7c882accebe691ca60dcb75a1d7f5d.png"
            },
            "unit": {
                "name": "SEAL Frogman"
            },
            "artist": {
                "name": "Scarlxrd"
            },
            "map": {
                "name": "Vertigo",
                "image_url": "https://cdn.csgoskins.gg/public/uih/maps/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL21hcHMvdmVydGlnby5wbmc-/auto/auto/85/notrim/5e4ff21ecb1eb5e1c5a38e886817f7ed.png"
            },
            "rarity": {
                "name": "Classified",
                "color": "#d32ce6"
            },
            "designer": {
                "name": "emkay",
                "steamid": "76561198005082533",
                "image_url": "https://cdn.csgoskins.gg/public/uih/designers/aHR0cHM6Ly9jZG4uY3Nnb3NraW5zLmdnL3B1YmxpYy9pbWFnZXMvZGVzaWduZXJzLzc2NTYxMTk4MDMxODY5NjIxL2F2YXRhci5wbmc-/auto/auto/85/notrim/df4739bcf2fa0010bf93698e50296f9a.png"
            },
            "update": {
                "name": "Introducing Operation Broken Fang",
                "blog_url": "https://blog.counter-strike.net/index.php/2020/12/31917/",
                "update_url": "http://counter-strike.net/brokenfang",
                "released_at": "2020-12-03"
            },
            "professional_players": [
                {
                    "name": "ceh9",
                    "name_real": "Arsenij Trynozhenko",
                    "geo": "UA",
                    "steamid": "76561197989686129",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/players/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3RvdXJuYW1lbnRzLzIwMTktc3RhcmxhZGRlci1iZXJsaW4ucG5n/auto/auto/85/notrim/65ee49e4009874ac345a01a55da2ec47.png"
                },
                {
                    "name": "sergej",
                    "name_real": "Jere Salo",
                    "geo": "FI",
                    "steamid": "76561198027839825",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/players/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL3RvdXJuYW1lbnRzLzIwMTktc3RhcmxhZGRlci1iZXJsaW4ucG5n/auto/auto/85/notrim/65ee49e4009874ac345a01a55da2ec47.png"
                }
            ],
            "locks": [
                {
                    "name": "Operation Hydra Case",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/items/aHR0cHM6Ly9zdGVhbWNkbi1hLmFrYW1haWhkLm5ldC9hcHBzLzczMC9pY29ucy9lY29uL3dlYXBvbl9jYXNlcy9jcmF0ZV9jb21tdW5pdHlfMTcuOGQ0NTI4ZWNhMjI5ZDY1ZDBjMTk5MjlhZTIwNzhhYWIzOGRmMTM2OS5wbmc-/auto/auto/85/notrim/f3fab646beb68ff6a2d732b30f1d7a81.png"
                }
            ],
            "sounds": [
                {
                    "name": "Affirmative",
                    "url": "https://cdn.csgoskins.gg/public/audio/agents/1st-lieutenant-farlow-swat/affirmative.wav",
                    "extension": "wav"
                },
                {
                    "name": "Negative",
                    "url": "https://cdn.csgoskins.gg/public/audio/agents/1st-lieutenant-farlow-swat/negative.wav",
                    "extension": "wav"
                },
                {
                    "name": "Cheer",
                    "url": "https://cdn.csgoskins.gg/public/audio/agents/1st-lieutenant-farlow-swat/cheer.wav",
                    "extension": "wav"
                },
                {
                    "name": "Hold This Position",
                    "url": "https://cdn.csgoskins.gg/public/audio/agents/1st-lieutenant-farlow-swat/hold-this-position.wav",
                    "extension": "wav"
                },
                {
                    "name": "Follow Me",
                    "url": "https://cdn.csgoskins.gg/public/audio/agents/1st-lieutenant-farlow-swat/follow-me.wav",
                    "extension": "wav"
                },
                {
                    "name": "Thanks",
                    "url": "https://cdn.csgoskins.gg/public/audio/agents/1st-lieutenant-farlow-swat/thanks.wav",
                    "extension": "wav"
                }
            ],
            "paintkits": [
                {
                    "name": "Redline",
                    "defindex": "282",
                    "wear_min": 0.1,
                    "wear_max": 0.7,
                    "description": "It has been painted using a carbon fiber hydrographic and a dry-transfer decal of a red pinstripe.",
                    "text": "Never be afraid to push it to the limit",
                    "phase": "Ruby",
                    "pattern_diff": false,
                    "image_url": "https://cdn.csgoskins.gg/public/uih/paintkits/aHR0cHM6Ly9zdGVhbWNkbi1hLmFrYW1haWhkLm5ldC9hcHBzLzczMC9pY29ucy9lY29uL2RlZmF1bHRfZ2VuZXJhdGVkL3dlYXBvbl9hazQ3X2N1X2FrNDdfY29icmFfbGlnaHRfbGFyZ2UuNzQ5NGJmZGY0ODU1ZmQ0ZTZhMmRiZDk4M2VkMGEyNDNjODBlZjgzMC5wbmc-/auto/auto/85/notrim/55628959530ef8397af086fef121601e.png",
                    "style": {
                        "name": "Custom Paint Job",
                        "description": "This style enables extremely customized looks in a full range of colors."
                    }
                }
            ],
            "containers": [
                {
                    "name": "Operation Phoenix Weapon Case",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/items/aHR0cHM6Ly9zdGVhbWNkbi1hLmFrYW1haWhkLm5ldC9hcHBzLzczMC9pY29ucy9lY29uL3dlYXBvbl9jYXNlcy9jcmF0ZV9jb21tdW5pdHlfMi40OTE3NGFiZGRjY2NiNjUxOWI4M2QyN2QwY2ZmNDc2ZTFjNDRjYzU3LnBuZw--/auto/auto/85/notrim/aa32422deb0419fb31ea7a13a368f7f1.png"
                }
            ],
            "collections": [
                {
                    "name": "The Phoenix Collection",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/collections/aHR0cHM6Ly9jZG4uY3Nnb3NraW5zLmdnL3B1YmxpYy9pbWFnZXMvY29sbGVjdGlvbnMvMjM5ZmNjNTU1ZDA4NjdkYjg5ODQ3NTc2ZTk1ZjYyNzAvZGVmYXVsdC5wbmc-/auto/auto/85/notrim/e48a02517befdd8b5a7bfb250d8c96db.png"
                }
            ],
            "colors": [
                {
                    "name": "Red",
                    "hex": "#ED1B24",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/colors/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL2NvbG9ycy9yZWQucG5n/auto/auto/85/notrim/efc8327ff347f90cf8afecbc157e6ed9.png"
                },
                {
                    "name": "Black",
                    "hex": "#000000",
                    "image_url": "https://cdn.csgoskins.gg/public/uih/colors/aHR0cHM6Ly9jc2dvc2tpbnMuZ2cvbWVkaWEvaW1hZ2VzL2NvbG9ycy9ibGFjay5wbmc-/auto/auto/85/notrim/65397419d6b9f65c8080df8eb632420a.png"
                }
            ]
        }
    ]
}

Request   

GET api/v1/advanced-item-details

Headers

Authorization      

Example: Bearer {YOUR_API_KEY}

Content-Type      

Example: application/json

Query Parameters

page   integer  optional  

The page to retrieve, defaults to 1. The meta.last_page field returns the last available page.

limit   integer  optional  

The number of items to return per page, defaults to 100. Must be a number between 1 and 100.

Body Parameters

page   integer  optional  

Must be at least 1. Must not be greater than 999999999. Example: 12

limit   integer  optional  

Must be at least 1. Must not be greater than 100. Example: 16

Response

Response Fields

meta   object   

An object containing metadata about the response.
total   integer   

The total number of items in our database.

per_page   integer   

The number of items that are returned per requested page.

current_page   integer   

The number of the current page.

last_page   integer   

The number of the last available page.

data   object[]   

An array of objects where each array element represents a specific item.
market_hash_name   string   

The market_hash_name of the item.

image_url   string   

The image URL of the item, hosted on our CDN.

image_url_steam   string|null   

The image URL of the item, hosted on Steam.

inspect_url   string|null   

The URL to inspect the item in-game.
Only available for skins, stickers, agents, graffiti, patches, and collectibles.

stattrak   boolean   

Whether this item is a StatTrak version or not.

souvenir   boolean   

Whether this item is a Souvenir version or not.

popularity   integer   

The popularity of the item. A higher number means the item is more popular.
This value is based on the item price and the number of daily sales on Steam.

description   string|null   

The Steam description of the item.

type   object   

Information about the type of the item.
name   string   

The name of the item type.

image_url   string   

The image URL of the item type.

category   object   

Information about the category of the item.
name   string   

The name of the item category.

image_url   string   

The image URL of the item category.

exterior   object|null   

Information about the exterior of the item. Only available for skins.
name   string   

The name of the item exterior.

name_short   string   

The shortened 2-letter name of the item exterior.

tint   object|null   

Information about the tint of the item. Only available for certain stickers.
name   string   

The name of the item tint.

color   string   

The HEX color of the item tint.

workshop   object|null   

Information about the Steam workshop page of the item.
Only available for items which have been created by
community designers instead of Valve.
id   string   

The ID of the item's workshop page.

url   string   

The URL to the workshop page of the item.

key   object|null   

Information about the key which the item can be opened with.
Only available for certain containers which can be opened with a key.
name   string   

The name of the key.

image_url   string   

The image URL of the key.

weapon   object|null   

Information about the weapon of the item. Only available for skins.
name   string   

The name of the weapon.

defindex   string   

The index of the weapon in the CS2 game files.

type   string   

The type of the weapon.

description   string   

The description of the weapon.

image_url   string   

The image URL of the weapon.

tournament   object|null   

Information about the CS2 tournament which the item was released with.
Only available for tournament items such as stickers and graffiti.
name   string   

The name of the tournament.

name_short   string   

The short name of the tournament.

location   string   

The location where the tournament took place.

city   string   

The city where the tournament took place.

year   string   

The year in which the tournament took place.

image_url   string   

The image URL to the logo of the tournament.

team   object|null   

Information about the team which the item belongs to.
Only available for stickers and graffiti.
name   string   

The name of the team.

tag   string   

The tag of the team.

geo   string   

The 2-letter ISO 3166 code of the team's country.

image_url   string   

The image URL to the logo of the team.

player   object|null   

Information about the player which the item belongs to.
Only available for stickers.
name   string   

The name of the player.

name_real   string   

The real name of the player (first name and last name).

geo   string   

The 2-letter ISO 3166 code of the player's country.

steamid   string|null   

The steamid64 of the player.

image_url   string   

The image URL to the logo of the player's team.

film   object|null   

Information about the film which the item belongs to.
Only available for stickers.
name   string   

The name of the film.

image_url   string   

The image URL of the film.

side   object|null   

Information about the side which the item belongs to.
Only available for agents.
name   string   

The name of the side.

name_short   string   

The short name of the side.

image_url   string   

The image URL of the side.

unit   object|null   

Information about the unit which the item belongs to.
Only available for agents.
name   string   

The name of the unit.

artist   object|null   

Information about the artist which the item belongs to.
Only available for music kits.
name   string   

The name of the artist.

map   object|null   

Information about the map which the item belongs to.
Only available for souvenir packages.
name   string   

The name of the map.

image_url   string   

The image URL of the map.

rarity   object|null   

Information about the rarity of the item.
name   string   

The name of the rarity.

color   string   

The HEX color of the rarity.

designer   object|null   

Information about the community designer of the item.
Only available for items which have been designed by
community designers instead of Valve.
name   string   

The name of the designer.

steamid   string   

The steamid64 of the designer.

image_url   string   

The image URL of the designer.

update   object|null   

Information about the CS2 update which the item was released with.
name   string   

The name of the update.

blog_url   string   

The URL to the CS2 blog post of the update.

update_url   string|null   

The URL to the dedicated update page.
This is only available for large updates such as a new operation.

released_at   string   

The date of when the update was released.

professional_players   object[]   

The professional CS2 players which currently have this item
in their Steam inventory.
name   string   

The name of the player.

name_real   string   

The real name of the player (first name and last name).

geo   string   

The 2-letter ISO 3166 code of the player's country.

steamid   string|null   

The steamid64 of the professional_players.

image_url   string   

The image URL to the logo of the player's team.

locks   object[]   

The containers that can be opened with the item. Only available for keys.
name   string   

The name of the lock.

image_url   string   

The image URL of the lock.

sounds   object[]   

The sound files which belong to the item. Only available for music kits and agents.
For music kits, all soundtracks are available. For agents, a few sample voice lines
are available.
name   string   

The name of the sound.

url   string   

The URL to the sound file.

extension   string   

The file extension of the sound. Either wav or mp3.

paintkits   object[]   

The paintkits (or finishes) which are available for this item. Only available for skins.
Most skins only have a single paintkit, only Dopplers and Gamma Dopplers can have
multiple paintkits.
name   string   

The name of the paintkit.

defindex   string   

The name of the paintkit.

wear_min   string   

The minimum possible wear value of the paintkit.

wear_max   string   

The maximum possible wear value of the paintkit.

description   string   

The description of the paintkit.

text   string|null   

The text of the paintkit.

phase   string|null   

The Doppler phase of the paintkit.

pattern_diff   boolean   

Whether the pattern changes the appearance of the skin.

image_url   string   

The image URL of the paintkit.

style   object|null   

The style of the paintkit.
name   string   

The name of the style.

description   string   

The description of the style.

containers   object[]   

The containers that contain the item.
name   string   

The name of the container.

image_url   string   

The image URL of the container.

collections   object[]   

The collections that the item belongs to.
name   string   

The name of the collection.

image_url   string   

The image URL of the collection.

colors   object[]   

The main colors which the item is composed of. Only available for skins and stickers.
name   string   

The name of the color.

hex   string   

The HEX code of the color.

image_url   string   

The image URL of the color.