数据 API 接口

鉴权

所有请求需在请求头携带 API 密钥（Bearer Token）：

Authorization: Bearer rk_你的密钥

密钥在 recalls.translia.com →「我的关注」页面生成（仅企业版可见「API 数据接口」面板）。一个账号可生成多把密钥，可随时撤销。

端点

GET https://recalls.translia.com/api/v1/recalls

请求示例：

curl -H "Authorization: Bearer rk_你的密钥" \
  "https://recalls.translia.com/api/v1/recalls?category=auto&country=KR&page_size=20"

查询参数

参数	说明	示例
`category`	品类：auto / consumer / food	auto
`country`	来源国家 / 地区代码	US · EU · UK · JP · KR · CA · AU · NZ
`from` / `to`	发布日期范围（YYYY-MM-DD）	2026-06-01
`origin_china`	仅原产地涉及中国（传 1）	1
`q`	关键词（名称 / 编号 / 制造商）	battery
`page`	页码，默认 1	1
`page_size`	每页条数，默认 50，最大 200	50

响应示例

{
  "ok": true,
  "total": 1234,
  "page": 1,
  "page_size": 20,
  "items": [
    {
      "id": 23710,
      "category": "auto",
      "country": "KR",
      "recall_number": "6280",
      "source_url": "https://www.car.go.kr/...",
      "publish_date": "2026-06-24",
      "origin_china": false,
      "fields":      { "manufacturer": "...", "vehicle_name": "...", "defect_summary": "..." },
      "translation": { "manufacturer": "...", "vehicle_name": "...", "defect_summary": "..." }
    }
  ]
}

返回字段

id：记录唯一 ID（按 id 递增，可用于增量同步）
category / country / recall_number / publish_date
source_url：原始官方公告链接
origin_china：布尔值，原产地是否涉及中国
fields：原文结构化字段对象（按品类不同）
translation：中文译文对象（可能为 null，表示该条尚未翻译）

错误码

401：缺少或无效的 API 密钥
403：该账号无 API 权限（需企业版）

查看套餐与定价预约洽谈

鉴权

端点

查询参数

响应示例

返回字段

错误码

需要 API 接入？