API Skins
JSONCS2 物品 API

每件 CS2 物品, 用 JSON 描述

每款饰品、印花、探员、挂件和武器箱是什么:武器、磨损和磨损值范围、StatTrak™ 和纪念品、稀有度、收藏品、掉落它的武器箱以及图片。每个 market_hash_name 一条记录,可直接筛选。

付费方案 $14.99 / 30 天起 · 用 Steam 登录

实时响应

清楚你在 给什么定价。

这是 API 对这些物品的返回。同一个 market_hash_name 将它与价格、求购单和成交 API 关联起来。

0

件物品,每件一条记录

0

种类型,从饰品到武器箱

0

个可组合的筛选条件

0

次请求获取整个目录

接口

一件、多件或全部分页

与其他 API 相同的密钥和相同的 30 天限额:无论一页有多少物品,都算一次请求。

单件物品

一件物品的全部信息,按每个平台都使用的名称查询。

GET /v1/items/{market_hash_name}

批量

对多件物品重复 market_hash_name,一次描述整个库存。

GET /v1/items?market_hash_name=…

全部物品

一次应答返回整个目录,或分页获取,可按类型、武器、收藏品、武器箱、稀有度和品质筛选。

GET /v1/items?type=skin&weapon=awp

五分钟拿到第一个结果

普通 HTTP。 无需学习 SDK。

  1. 1用 Steam 登录并选择付费方案。
  2. 2在 API 文档页面复制你的密钥。
  3. 3在 X-API-KEY 请求头中发送它,然后读取 JSON。
type Item = {
    market_hash_name: string;
    name: string;
    type: "skin" | "sticker" | "agent" | "charm" | "patch" | "music_kit" | "graffiti" | "collectible" | "container";
    category: string | null;
    weapon: { id: string; name: string } | null;
    pattern: string | null;
    wear: { id: "fn" | "mw" | "ft" | "ww" | "bs"; name: string } | null;
    min_float: number | null;
    max_float: number | null;
    quality: "Normal" | "StatTrak™" | "Souvenir" | "★" | "★ StatTrak™";
    stattrak: boolean;
    souvenir: boolean;
    rarity: { id: string; name: string; color: string } | null;
    label: string | null;
    team: "both" | "ct" | "t" | null;
    collections: { id: string; name: string }[];
    containers: { id: string; name: string }[];
    details: Record<string, string>;
    image: string | null;
    url: string;
};

const API_KEY = process.env.APISKINS_API_KEY!;
const market_hash_name = "StatTrak™ AWP | Asiimov (Field-Tested)";

const response = await fetch(`https://api.apiskins.com/v1/items/${encodeURIComponent(market_hash_name)}`, {
    headers: { "X-API-KEY": API_KEY },
});

if (!response.ok) {
    throw new Error(`API Skins answered ${response.status}: ${(await response.json()).error}`);
}

const item: Item = await response.json();

用它构建的产品

人们用物品数据构建什么

交易平台和商店

无需自建目录即可按武器、磨损、稀有度和收藏品筛选。

搜索和库存

一次请求把 market_hash_name 变成图片、稀有度颜色和磨损值范围。

交易机器人

只交易你想要的物品类型:不要印花、只要刀、只要一个收藏品。

粉丝站和工具

收藏品和武器箱页面、汰换计算器和配装工具,全部来自同一数据源。

限额

所有付费方案均包含

比较方案

免费

免费

  • 100 次请求 / 30 天
  • 60 次请求 / 分钟
  • 不包含

Trader

$14.99 / 30 天

  • 5,000 次请求 / 30 天
  • 120 次请求 / 分钟
  • 包含

Pro

$49.99 / 30 天

  • 25,000 次请求 / 30 天
  • 300 次请求 / 分钟
  • 包含

Business

$119.99 / 30 天

  • 100,000 次请求 / 30 天
  • 300 次请求 / 分钟
  • 包含

一个密钥

同一个密钥可用于所有 API

常见问题

关于物品 API 的常见问题

每件可交易的 CS2 物品:各种磨损的饰品、StatTrak™ 和纪念品、刀和手套、印花、探员、挂件、布章、音乐盒、涂鸦、收藏品和武器箱,共 34,937 条记录。Valve 发布新物品时会加入。
是的,和价格、求购订单、销售一样:每个得到应答的请求算一次,无论包含多少物品,所以一次应答获取整个目录就是一次请求。套餐见价格页面。
能:每件物品在饰品下都有自己的页面,包括磨损值范围、收藏品、武器箱以及它现在在哪里最便宜。
不包含,它只描述物品。价格来自价格 API,求购单来自求购单 API,成交来自成交 API,全部通过 market_hash_name 关联。

完整目录, 所有付费方案均包含。

每件物品都有描述,一个密钥。同一个密钥也可用于价格、求购单和成交 API。