GET/v1/items/allDEVELOPER+
全部饰品
一次不分页的调用返回完整的已收录目录:一个裸 JSON 数组,包含每件饰品的各市场最新价格与聚合值(上限 50,000 行)。数据量大;交互式使用请优先用分页的饰品搜索。价格为整数美分。
以裸 JSON 数组(无分页封装)一次性导出整个已收录目录,上限 50,000 行。每条带各市场的 latestPrices 与一个 priceAggregates 块。数据量大,请做好缓存;交互式、带过滤的读取请优先用饰品搜索。
Enterprise 套餐的批量读取:GET /v2/prices/latest 以一份 gzip 压缩快照返回每件饰品各市场的最新在售价与求购价,每 10 分钟重建一次,并支持 ETag,在下一次重建之前重复轮询只会得到 304。
参数
无查询参数。
响应字段
AllItemsItem完整目录数组中的一件饰品。响应是由它组成的裸数组(无封装)。
嵌套与共享结构链接到 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