可以查询的配件数据,不是让你去爬的

31,488 条散热系统配件、289 个品牌的 JSON 接口 —— OEM 交叉号、适配车型,以及大多数目录不给的芯体尺寸。

快速开始申请免费密钥
匿名调用
每 IP 200 次/天
免费密钥
1,000 次/天
商用
更高额度,单独申请

快速开始

不带密钥也能调,受匿名日额度限制。加上 X-API-Key 请求头即可提额。

# anonymous
curl "https://api.ikosdb.com/api/search?q=16400-0H120"

# with a key
curl -H "X-API-Key: ikos_yourkey" \
     "https://api.ikosdb.com/api/search?q=toyota+avensis"
{
  "query": "16400-0H120",
  "total_matched": 2,
  "total_display": 2,
  "groups": [{
    "category": "Radiator",
    "products": [{
      "code": "116464",
      "brand": "TOYOTA",
      "model": "Avensis 2.0 24 AT/1A2",
      "oem": "164000H120",
      "oem_clean": "164000H120 164000H121",
      "core": "378x625x26",
      "confidence": 92,
      "category": "Radiator"
    }]
  }],
  "quota": {"mode": "anon", "limit": 200, "used": 1, "remaining": 199}
}

鉴权

以下两种方式任选,推荐用请求头。

# header (preferred)
X-API-Key: ikos_yourkey

# query parameter
?q=16400-0H120&key=ikos_yourkey

接口

端点返回
GET /api/search?q=按 OEM 号、品牌、车型、货号或品类搜索。匹配时忽略空格、连字符和点号,164000H120 与 16400-0H120 等价。
GET /api/vin?vin=解析 17 位 VIN,返回适配该车的配件。
GET /api/stats全库覆盖度统计。
GET /api/key/status查询本人当日额度与用量,不计数。

返回字段

字段含义
code货号 / ERP 编码,同时是产品页路径:/part/{code}/
brand该件归档的整车厂牌。
model来源画册的车型与发动机 / 驱动形式描述。
oemOEM 号原格式,保留连字符。
oem_clean空格分隔的归一化交叉号集合(全部已知可互换号)。
core芯体尺寸 宽 x 高 x 厚,单位 mm。来源画册未标注时为空 —— 我们不猜。
confidence内部置信度 0–100,由多源一致性与尺寸合理性聚合而成。
slug稳定记录标识。
category归一化品类,如 Radiator、Condenser、Thermostat。
keywords附加搜索关键词(若有)。

署名要求

免费与标准密钥必须在展示数据的页面、应用或导出文件上,保留一处可见的来源链接。放在页脚或结果表旁边即可:

<a href="https://ikosdb.com/" rel="dofollow">Parts data by IKOS</a>

我们确认链接存在后才发密钥。没有署名,这批数据就没有理由免费。

禁止事项

额度与合理使用

匿名调用按 IP 设日上限,避免整库被遍历。持密钥可提额,并可通过 /api/key/status 查看自身用量。额度按 UTC 0 点重置。

嵌入你的网站

不需要密钥、不需要后端、不用维护任何脚本。把一段 <iframe> 贴到页面里,访客就能查件号 —— 带 IKOS 标识、结果链到产品页。免费,不用注册。

复制这段代码。宽度自适应,560px 高度刚好放下搜索框加六条结果。

<iframe src="https://ikosdb.cn/embed?theme=light" width="100%" height="560"
        style="border:0;max-width:760px" title="IKOS 件号查询"></iframe>

可选参数:theme=dark、brand=TOYOTA、q=16400-0H120 预填。额度按访客 IP 计。需要去掉 IKOS 标识、换成你自己联系方式的贴牌版本,可联系我们 —— 见下方申请表。

申请密钥

免费密钥发给在数据之上真正做了东西的站点和工具。请告诉我们数据会出现在哪里 —— 我们看过页面再批。

每天审一次。不要信用卡,也不会有销售来打你电话。