Подобно другим товарам, снаряжение может быть временно недоступно из-за технических работ на Steam или других причин. Мы рекомендуем регулярно обновлять список доступного снаряжения, чтобы всегда показывать актуальный статус и цены на вашей платформе. Это обеспечивает наилучший опыт для ваших пользователей и избавляет вас от необходимости ручного обновления.

Для того чтобы получить список доступного снаряжения на платформе, можно использовать метод загрузки списка снаряжения. В ответе на запрос будет содержаться список предметов снаряжения, которые доступны для покупки с подробным описанием каждого.


Описание структуры запроса

Для поиска и фильтрации снаряжения вы можете отправить POST запрос с телом, содержащим следующие параметры. Все поля в запросе являются необязательными, и вы можете комбинировать их для получения нужного списка предметов.

{
  "query": "Asiimov",
  "filters": {
    "price": {"min": 0, "max": 2029147 },
    "weapon": [ "AK-47" ],
    "type": [ "Rifle" ],
    "rarity": [ "Covert" ],
    "exterior": [ "Minimal Wear" ],
    "quality": [ "Normal" ]
  },
  "limit": 10,
  "page": 1,
  "sort": "price_asc"
}

Поля запроса

Список всех возможных полей, которые вы можете использовать в запросе для поиска снаряжения.

ПолеТипОписаниеПримеры
appidnumberИдентификатор приложения Steam, для которого вы хотите получить снаряжение. По умолчанию 730.730 (для CS2)
querystringСтрока поиска по названию предмета. Используется для фильтрации снаряжения по названию или части названия.AK-47, Asiimov
filtersobjectОбъект, содержащий параметры фильтрации для поиска снаряжения. Все поля внутри filters необязательны.{"price": {"min": 100, "max": 5000}}
filters.priceobjectФильтрация по диапазону цен. Значения min и max указываются в центах.{"min": 1000, "max": 50000}
filters.typeArray<string>Фильтрация по типу снаряжения. Возможные значения соответствуют полю details.type в ответе["Knife", "Glove"]
filters.rarityArray<string>Фильтрация по редкости предмета. Возможные значения соответствуют полю details.rarity в ответе.["Covert", "Restricted"]
filters.exteriorArray<string>Фильтрация по внешнему износу для скинов оружия. Возможные значения соответствуют полю details.exterior в ответе.["Factory New", "Minimal Wear"]
filters.qualityArray<string>Фильтрация по качеству предмета (например, StatTrak™). Возможные значения соответствуют полю details.quality в ответе.["StatTrak™", "Souvenir"]
filters.phaseArray<string>Фильтрация по фазе Доплера для ножей (например, phase1, emerald).["emerald", "ruby"]
limitnumberМаксимальное количество предметов в ответе. Используется для пагинации.10, 50
pagenumberНомер страницы результатов. Используется для пагинации.1, 2, 5
sortstringПараметр сортировки результатов. Возможные значения: price_asc, price_desc. По умолчанию price_asc.price_asc

Возможные значения для фильтров

Здесь представлены возможные значения для каждого фильтра, которые вы можете использовать в запросе. Эти значения соответствуют полям в ответе API и позволяют вам гибко настраивать поиск снаряжения.

ФильтрВозможные значения
priceЧисловой диапазон, например: {"min": 100, "max": 5000} (в копейках)
typeAgent, Charm, Collectible, Container, Equipment, Gift, Gloves, Graffiti, Key, Knife, Machinegun, Music Kit, Pass, Patch, Pistol, Rifle, Shotgun, SMG, Sniper Rifle, Sticker, Tag, Tool
weaponAK-47, AUG, AWP, Bayonet, Bowie Knife, Butterfly Knife, Classic Knife, CZ75-Auto, Desert Eagle, Dual Berettas, Falchion Knife, FAMAS, Five-SeveN, Flip Knife, G3SG1, Galil AR, Glock-18, Gut Knife, Huntsman Knife, Karambit, Kukri Knife, M249, M4A1-S, M4A4, M9 Bayonet, MAC-10, MAG-7, MP5-SD, MP7, MP9, Navaja Knife, Negev, Nomad Knife, Nova, P2000, P250, P90, Paracord Knife, PP-Bizon, R8 Revolver, Sawed-Off, SCAR-20, SG 553, Shadow Daggers, Skeleton Knife, SSG 08, Stiletto Knife, Survival Knife, Talon Knife, Tec-9, UMP-45, Ursus Knife, USP-S, XM1014, Zeus x27
item_setThe Italy Collection, The Train Collection, The Safehouse Collection, The Gods and Monsters Collection, The Dreams & Nightmares Collection, The Wildfire Collection, The Spectrum Collection, The Spectrum 2 Collection, The Fracture Collection, The Horizon Collection, The Glove Collection, The Snakebite Collection, Broken Fang Agents, The Breakout Collection, The Gamma 2 Collection, The Shadow Collection, The eSports 2014 Summer Collection, The Chroma 2 Collection, The Clutch Collection, The Revolver Case Collection, The Prisma Collection, The Gamma Collection, The Chroma Collection, The Chroma 3 Collection, The Operation Riptide Collection, Operation Riptide Agents, The Prisma 2 Collection, The Danger Zone Collection, The Dust 2 Collection, The Bank Collection, The Falchion Collection, The Alpha Collection, The Phoenix Collection, The Winter Offensive Collection, The Vanguard Collection, The Arms Deal 3 Collection, The 2018 Inferno Collection, The 2018 Nuke Collection, The Operation Broken Fang Collection, The Cache Collection, The 2021 Train Collection, The Huntsman Collection, The Rising Sun Collection, The Control Collection, Shattered Web Agents, The Operation Hydra Collection, The Lake Collection, The Recoil Collection, The Revolution Collection, The Canals Collection, The 2021 Dust 2 Collection, The Shattered Web Collection, The CS20 Collection, The Overpass Collection, The eSports 2013 Winter Collection, The Aztec Collection, The 2021 Mirage Collection, The Blacksite Collection, The 2021 Vertigo Collection, The Ancient Collection, The St. Marc Collection, The eSports 2013 Collection, The X-Ray Collection, The Inferno Collection, The Nuke Collection, The Chop Shop Collection, The Arms Deal 2 Collection, The Cobblestone Collection, The Mirage Collection, The Arms Deal Collection, The Havoc Collection, The Norse Collection, The Anubis Collection, The Vertigo Collection, The Bravo Collection, The Dust Collection, The Baggage Collection, The Assault Collection, The Office Collection, The Militia Collection, The Kilowatt Collection, The Gallery Collection, The Overpass 2024 Collection, The Sport & Field Collection, Limited Edition Item, The Graphic Design Collection, The Ascent Collection, The Boreal Collection, The Radiant Collection, The Fever Collection, The Train 2025 Collectio
rarityBase Grade, Classified, Consumer Grade, Contraband, Covert, Distinguished, Exceptional, Exotic, Extraordinary, High Grade, Industrial Grade, Master, Mil-Spec Grade, Remarkable, Restricted, Stock, Superior
exteriorBattle-Scarred, Factory New, Field-Tested, Minimal Wear, Not Painted, Well-Worn
quality, Normal, Souvenir, StatTrak™
phasephase1, phase2, phase3, phase4, emerald, ruby, blackpearl
floatЧисловое значение износа (от 0.0 до 1.0). Например: {"min": 0.0, "max": 0.5}

Описание структуры ответа

Ниже представлен полный список возможных полей для каждого объекта снаряжения. Некоторые поля могут отсутствовать (быть null), если они не применимы к конкретному типу предмета.

{
  "status": "200",
  "items": [
    {
      "id": 27104403,
      "name": "AK-47 | Asiimov (Battle-Scarred)",
      "price": 12345,
      "image": "https://steamcommunity-a.akamaihd.net/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpot7HxfDhjxszJemkV092lnYmGmOHLO77QgHIfv5Fwj-2W8I2hiVLg_0Y-amjxcdKUJwVsZgvWqVG7yby-0JS8u8vKz2wj5HdYywfQ1A",
      "inspectLink": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561199211314126A42560803676D148280691212945393",
      "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. It has been custom painted with a sci-fi design.",
      "details": {
        "type": "Rifle",
        "weapon": "AK-47",
        "set": "The Danger Zone Collection",
        "quality": "Normal",
        "rarity": "Covert",
        "exterior": "Battle-Scarred",
        "phase": null,
        "tournament": "PGL Copenhagen 2024",
        "color": null
      },
      "paint": {
        "float": 0.46424803137779236,
        "seed": 996,
        "index": 801,
        "pattern": 7
      },
      "attachments": [
        {
          "id": 7258,
          "name": null,
          "wear": null,
          "type": "sticker"
        },
        null,
        null,
        null,
        null
      ]
    },
    ...
  ],
  "total": 42
}

Поля верхнего уровня ответа

ПолеТипОписаниеПримеры
statusstringСтатус ответа API.200 (успех), 400 (неверный запрос)
itemsArray<object>Массив объектов снаряжения, соответствующих критериям запроса.[ { ... } ]
totalnumberОбщее количество предметов, найденных по запросу (без учёта limit и page).42, 1005
idnumberУникальный идентификатор предмета.27104403, 16910595
namestringОтображаемое название предмета (например, название скина).AK-47 | Asiimov, Наклейка | FaZe Clan | Stockholm 2021, Именной ярлык
pricenumberЦена предмета в копейках.12345 (для 123.45₽)
imagestringURL-адрес иконки/миниатюры предмета.https://steamcommunity-a.akamaihd.net/economy/image/...
inspectLinkstring, nullСсылка для осмотра предмета в игре, если доступна (для скинов).steam://rungame/730/..., null
descriptionstring, nullОсновной описательный текст предмета.Мощный и надёжный AK-47 — один из самых популярных автоматов в мире.

Объект details

Этот объект содержит детализированные метаданные о предмете снаряжения.

ПолеТипОписание
typestringОбщая классификация предмета. Соответствует ключам фильтра filters.type.
weaponstring, nullКонкретное название оружия, если предмет является скином оружия. Соответствует ключам filters.weapon.
setstring, nullНазвание коллекции или кейса, к которому принадлежит предмет. Соответствует ключам filters.item_set.
qualitystring, nullАтрибут качества предмета, например, StatTrak™ или Souvenir. Соответствует ключам filters.quality.
raritystring, nullУровень редкости предмета. Соответствует ключам filters.rarity.
exteriorstring, nullУровень внешнего износа для скинов оружия. Соответствует ключам filters.exterior.
phasestring, nullФаза Доплера для определённых раскрасок ножей. Соответствует ключам filters.phase.
tournamentstring, nullНазвание турнира, связанного с предметом (например, для мажорных стикеров, пропусков).
colorstring, nullКонкретный цвет для предметов граффити.

Объект paint

Этот объект содержит свойства, относящиеся к визуальному паттерну и износу предмета.

ПолеТипОписание
floatnumber, nullЗначение представляющее износ предмета (от 0.0 до 1.0).
seednumber, nullID покраски, влияющее на вариации паттерна.
indexnumber, nullИндекс покраски, для конкретных вариаций.
patternnumber, nullID паттерна для предметов с отличительными визуальными паттернами (скины, наклейки, нашивки, граффити).

Массив attachments

Этот массив представляет прикрепления (наклейки, нашивки), которые могут быть применены к предмету. Для расходуемых прикреплений (таких как сами предметы-наклейки, нашивки или граффити) он описывает прикрепление, содержащееся в предмете.

Массив всегда будет иметь фиксированную длину 5 элементов (максимальное количество слотов для наклеек/нашивок в CS2). Каждый элемент будет либо объектом Attachment, либо null, если слот пуст.

Для расходуемых предметов, таких как Наклейка, Нашивка или Граффити, массив attachments будет содержать одну запись в слоте 0, описывающую собственный паттерн предмета. Это соответствует тому, как Steam представляет эти данные.

Структура объекта Attachment

ПолеТипОписание
idnumber, nullВнутренний ID наклейки/нашивки/граффити.
namestring, nullОтображаемое название наклейки/нашивки/граффити.
wearnumber, nullЗначение износа (стирания) для применённой наклейки.
typestringТип прикрепления. ( sticker, patch, graffiti_pattern )