Skip to main content
GET/v1/items/allDEVELOPER+

全部饰品

一次不分页的调用返回完整的已收录目录:一个裸 JSON 数组,包含每件饰品的各市场最新价格与聚合值(上限 50,000 行)。数据量大;交互式使用请优先用分页的饰品搜索。价格为整数美分。

以裸 JSON 数组(无分页封装)一次性导出整个已收录目录,上限 50,000 行。每条带各市场的 latestPrices 与一个 priceAggregates 块。数据量大,请做好缓存;交互式、带过滤的读取请优先用饰品搜索。

Enterprise 套餐的批量读取:GET /v2/prices/latest 以一份 gzip 压缩快照返回每件饰品各市场的最新在售价与求购价,每 10 分钟重建一次,并支持 ETag,在下一次重建之前重复轮询只会得到 304。

参数

无查询参数。

响应字段

AllItemsItem完整目录数组中的一件饰品。响应是由它组成的裸数组(无封装)。
idstring
规范饰品 id。
namestring
Market hash name。
latestPricesAllItemsPrice[]
各市场最新价格。
priceAggregatesAllItemsAggregatenullable
跨市场聚合值,或 null。

嵌套与共享结构链接到 API 对象 参考页。

错误

401缺少 Authorization 头、认证方案不支持,或密钥未知、未激活、已过期、已吊销。
403密钥有效,但订阅未激活/已过期,或套餐不含此接口。
429超出速率限制;见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算,所有密钥共享。
5xx上游快照不可用或服务端问题。请退避后重试。

使用此端点的指南(英文)

export SKINPRICER_API_KEY="sp_live_•••"

curl "https://pricing.skinpricer.com/v1/items/all" \
  -H "Authorization: ApiKey $SKINPRICER_API_KEY"
// npm i @skinpricer/sdk
import { SkinpricerClient } from "@skinpricer/sdk";

const client = new SkinpricerClient({
  apiKey: process.env.SKINPRICER_API_KEY!,
  authScheme: "ApiKey",
});

const all = await client.items.all();
console.log(all.length, "items");
import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/items/all",
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

需要认证的接口:请在你自己的客户端中携带 API 密钥调用(见代码示例)。

响应 200
[
  {
    "id": "cmlofca920lka01yozajhixt3",
    "name": "Glock-18 | Water Elemental (Factory New)",
    "latestPrices": [
      {
        "market": "tradeit-store",
        "effectiveUsdCents": 6894,
        "fetchedAt": "2026-06-16T05:35:20.086Z",
        "originalCurrency": "USD"
      }
    ],
    "priceAggregates": {
      "minPrice": 6240,
      "maxPrice": 11891,
      "avgPrice": 7999.88,
      "medianPrice": 7130,
      "stdDev": 1891.24,
      "updatedAt": "2026-06-23T22:05:25.547Z"
    }
  }
]
响应头
X-RateLimit-Limit: <每分钟配额,由套餐决定>
X-RateLimit-Remaining: <本分钟剩余次数>
X-RateLimit-Reset: <距重置的秒数>
X-RateLimit-Remaining-Month: <本月剩余次数,仅限有月度上限的套餐>
X-Request-ID: req_xxxxxxxxxxxxxxxx

使用与许可

API 及其数据的使用受我们的服务条款(英文)约束:不得转售或再分发数据,不得用于构建竞争性服务, 不得超出套餐的速率限制;在条款允许展示数据的场景下须注明数据来源为 SkinPricer。滥用行为可能被限流或封禁。