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.

2026-10-22

2025-11-17

2025-01-26

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.

01. Prices

Endpoints for general price data.

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\": \"60d\",
    \"aggregator\": \"avg\"
}"

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": "60d",
    "aggregator": "avg"
};

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' => '60d',
            'aggregator' => 'avg',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/prices'
payload = {
    "range": "60d",
    "aggregator": "avg"
}
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)",
            "phase": "Ruby",
            "prices": [
                {
                    "market": "steam",
                    "price": 1277,
                    "quantity": 43,
                    "volume": 107,
                    "updated_at": 1626566412
                },
                {
                    "market": "skinport",
                    "price": 1560,
                    "quantity": 6,
                    "volume": 12,
                    "updated_at": 1626566653
                }
            ]
        },
        {
            "market_hash_name": "AK-47 | Aquamarine Revenge (Factory New)",
            "phase": null,
            "prices": [
                {
                    "market": "steam",
                    "price": 5270,
                    "quantity": 25,
                    "volume": 37,
                    "updated_at": 1626566273
                },
                {
                    "market": "skinport",
                    "price": 5973,
                    "quantity": 14,
                    "volume": 5,
                    "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: 60d

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

Example: avg

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. This property is only unique in combination with the phase property.

phase   string|null     

The Doppler phase 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   integer     

The number of sales for the item (at any price) on a day, 0 if the market reported no sales that day.

updated_at   integer     

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

02. Price Histories

Endpoints for general price history data.

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\": 19,
    \"limit\": 14
}"

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": 19,
    "limit": 14
};

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' => 19,
            'limit' => 14,
        ],
    ]
);
$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": 19,
    "limit": 14
}
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",
            "phase": "Ruby",
            "dates": [
                {
                    "date": "2021-08-09",
                    "prices": [
                        {
                            "market": "skinport",
                            "price": 28,
                            "quantity": 275,
                            "volume": 61
                        },
                        {
                            "market": "steam",
                            "price": 28,
                            "quantity": 8397,
                            "volume": 1043
                        }
                    ]
                },
                {
                    "date": "2021-08-08",
                    "prices": [
                        {
                            "market": "skinport",
                            "price": 27,
                            "quantity": 245,
                            "volume": 58
                        },
                        {
                            "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: 19

limit   integer  optional    

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

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. This property is only unique in combination with the phase property.

phase   string|null     

The Doppler phase 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   integer     

The number of sales for the item (at any price) on that day, 0 if the market reported no sales that day.

03. Offer Links

Endpoints for offer links.

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)",
            "phase": "Ruby",
            "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)",
            "phase": null,
            "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. This property is only unique in combination with the phase property.

phase   string|null     

The Doppler phase 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.

04. Basic Item Details

Endpoints for basic item details.

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\": 11,
    \"limit\": 11
}"

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": 11,
    "limit": 11
};

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' => 11,
            'limit' => 11,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/basic-item-details'
payload = {
    "page": 11,
    "limit": 11
}
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",
            "phase": "Ruby",
            "image_url": "https://cdn.csgoskins.gg/public/uih/products/aHR0cHM6Ly9zdGVhbWNvbW11bml0eS1hLmFrYW1haWhkLm5ldC9lY29ub215L2ltYWdlLy05YTgxZGxXTHdKMlVVR2NWc19uc1Z0emRPRWR0V3dLR1paTFFIVHhEWjdJNTZLVTBad3dvNE5VWDRvRkpaRUhMYlhBNlExTkw0a21yQWxPQTBfRlZQQ2kydF9mVWtSeE56dFVvcmVhT0JCaHg4emVjQzlMN2RLaWtzN1R3Nlh4TU9uUWxUTUY2NXdtMC1pUXBJbjMwQWJrOHhjNWFqaW5kZENXSXdFNlkxellfVm01MzY2eDBoTm1iRkQ3LzUxMngzODQ-/auto/auto/85/notrim/b50f3b556dec1cf4de48d7ed761abdd6.png",
            "image_url_steam": "https://community.cloudflare.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRfQ1_ESOr_h56LHE59IjtE57e1JwJf1PzEdQJO7c6xkc7dwaWiYe3SlzwIuZBy3uzEp9qg3Vbn-0c4YGyhcY7HIFI8aVHS_lm5366x0qhmo9uG",
            "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: 11

limit   integer  optional    

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

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. This property is only unique in combination with the phase property.

phase   string|null     

The Doppler phase 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.
This is only an array for backwards compatibility. Skins always have one paintkit.
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.

05. Advanced Item Details

Endpoints for advanced item details.

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\": 11,
    \"limit\": 1
}"

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": 11,
    "limit": 1
};

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' => 11,
            'limit' => 1,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://csgoskins.gg/api/v1/advanced-item-details'
payload = {
    "page": 11,
    "limit": 1
}
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",
            "phase": "Ruby",
            "image_url": "https://cdn.csgoskins.gg/public/uih/products/aHR0cHM6Ly9zdGVhbWNvbW11bml0eS1hLmFrYW1haWhkLm5ldC9lY29ub215L2ltYWdlLy05YTgxZGxXTHdKMlVVR2NWc19uc1Z0emRPRWR0V3dLR1paTFFIVHhEWjdJNTZLVTBad3dvNE5VWDRvRkpaRUhMYlhBNlExTkw0a21yQWxPQTBfRlZQQ2kydF9mVWtSeE56dFVvcmVhT0JCaHg4emVjQzlMN2RLaWtzN1R3Nlh4TU9uUWxUTUY2NXdtMC1pUXBJbjMwQWJrOHhjNWFqaW5kZENXSXdFNlkxellfVm01MzY2eDBoTm1iRkQ3LzUxMngzODQ-/auto/auto/85/notrim/b50f3b556dec1cf4de48d7ed761abdd6.png",
            "image_url_steam": "https://community.cloudflare.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRfQ1_ESOr_h56LHE59IjtE57e1JwJf1PzEdQJO7c6xkc7dwaWiYe3SlzwIuZBy3uzEp9qg3Vbn-0c4YGyhcY7HIFI8aVHS_lm5366x0qhmo9uG",
            "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,
                    "legacy_model": true,
                    "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: 11

limit   integer  optional    

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

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. This property is only unique in combination with the phase property.

phase   string|null     

The Doppler phase 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, charms, 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 all markets that report them.

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.
This is only an array for backwards compatibility. Skins always have one paintkit.
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.

legacy_model   boolean     

Whether the pattern uses the old legacy model or the new CS2 model.

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.