GET/v1/itemsDEVELOPER+

饰品搜索

列出并搜索已收录的饰品目录，附实时价格。每条结果都是与 /v1/pricing/:marketHashName 相同的跨市场快照，分页返回。可用 search 与 markets 过滤。价格为整数美分。

一次调用同时完成发现与定价：分页浏览已收录的目录，可选用 search 与 markets 过滤。search 是分词的 AND 前缀全文查询（每个词都必须前缀匹配），匹配范围包括名称、基础名称、slug、武器、图案、稀有度以及一段组合搜索文本，而不是单一子串。每条 data 都是与 /v1/pricing/:marketHashName 相同的跨市场快照，因此渲染列表时无需再为每件饰品单独请求。

用 pagination（currentPage / lastPage / nextPage）逐页遍历。要一次性导出整个目录，配套接口 /v1/items/all 以裸数组返回所有饰品（数据量更大）。

按游戏区分的版本：GET /v2/items 通过必填参数 game=cs2|rust 同时服务两款游戏，支持 search / markets / page / perPage（页码 1 到 10,000，每页最多 100 件）。没有 /v2/items/all，请改为分页遍历。见游戏：CS2 与 Rust。

参数

searchstring可选

查询参数。分词全文搜索：按空白拆分的每个词都按不区分大小写的前缀匹配，且所有词都必须匹配（AND），匹配范围包括饰品名称、基础名称、slug、武器、图案、稀有度以及一段组合搜索文本。因此 redline ft 会同时按两个词收窄结果。它不是单一的字面子串匹配。

marketsstring可选

查询参数。用于限定每件饰品价格范围的市场 id CSV。

pageinteger可选

查询参数。从 1 开始的页码。默认 1。

perPageinteger可选

查询参数。每页饰品数，1 到 100。默认 10。

响应字段

ItemSearchResponse分页的目录搜索结果，附每件饰品的价格。

dataPricingResponse[]

每件饰品一个跨市场快照（与价格快照接口结构相同）。

paginationPaginationMeta

分页元数据。

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

错误

401缺少 Authorization 头、认证方案不支持，或密钥未知、未激活、已过期、已吊销。

403密钥有效，但订阅未激活/已过期，或套餐不含此接口。

429超出速率限制；见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算，所有密钥共享。

5xx上游快照不可用或服务端问题。请退避后重试。

另见单件饰品快照批量最低 / 最高价游戏：CS2 与 Rust

配套接口

GET/v1/items/all

一次不分页的调用返回完整目录：一个裸 JSON 数组，包含每件已收录饰品的各市场最新价格与聚合值（上限 50,000 条）。数据量大；交互式使用请优先用分页接口。

完整参考 →

使用此端点的指南（英文）

export SKINPRICER_API_KEY="sp_live_•••"

curl -G "https://pricing.skinpricer.com/v1/items" \
  --data-urlencode "search=redline" \
  --data-urlencode "perPage=20" \
  -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 page = await client.items.search({ search: "redline", perPage: 20 });
console.log(page.data.length, "of", page.pagination.total, "items");

import os
import requests

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

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

响应 200

{
  "data": [
    {
      "canonicalItemId": "cmlofca920lka01yozajhixt3",
      "name": "Glock-18 | Water Elemental (Factory New)",
      "aggregate": {
        "minPrice": 6500,
        "maxPrice": 8012,
        "avgPrice": 7102,
        "medianPrice": 7119,
        "stdDev": 439.12,
        "marketCount": 10,
        "freshMarketCount": 9,
        "listingCount": 710,
        "updatedAt": "2026-06-23T21:59:48.717Z"
      },
      "markets": [
        {
          "market": "csfloat",
          "price": 6500,
          "currency": "USD",
          "fetchedAt": "2026-06-23T21:52:27.427Z",
          "ingestedAt": "2026-06-23T21:55:56.000Z",
          "quoteSize": 132,
          "ingestLatencyMs": 208573,
          "isStale": false
        }
      ],
      "buyOrders": [
        {
          "market": "buff163",
          "price": 6543,
          "currency": "USD",
          "fetchedAt": "2026-06-23T21:59:48.717Z",
          "ingestedAt": "2026-06-23T21:59:48.000Z",
          "quoteSize": 45,
          "totalQuantity": 45,
          "ingestLatencyMs": 0,
          "isStale": false
        }
      ],
      "bestAsk": {
        "market": "csfloat",
        "price": 6500,
        "updatedAt": "2026-06-23T21:52:27.427Z",
        "isStale": false
      },
      "bestBid": {
        "market": "buff163",
        "price": 6543,
        "updatedAt": "2026-06-23T21:59:48.717Z",
        "isStale": false
      },
      "spreadBps": null,
      "marketCount": 10,
      "freshMarketCount": 9,
      "calculatedAt": "2026-06-23T22:07:15.808Z"
    }
  ],
  "pagination": {
    "perPage": 1,
    "currentPage": 1,
    "from": 1,
    "to": 1,
    "total": 15,
    "lastPage": 15,
    "prevPage": null,
    "nextPage": 2
  }
}

响应头

X-RateLimit-Limit: <每分钟配额，由套餐决定>

X-RateLimit-Remaining: <本分钟剩余次数>

X-RateLimit-Reset: <距重置的秒数>

X-RateLimit-Remaining-Month: <本月剩余次数，仅限有月度上限的套餐>

X-Request-ID: req_xxxxxxxxxxxxxxxx