第一次条码查询
在控制台获取你获准使用的 API 密钥，替换示例中的 <API_KEY>。密钥会出现在查询 URL 中，请勿通过链接、截图或日志泄露。
示例将 query 设为公开示例条码 3017620422003（EAN-13）。可直接复制体验条码模式，或用下方表单换成任意 UPC、EAN、JAN、ISBN 编码，也可以输入文本关键词体验搜索模式。只有你主动提交才会发起数据请求，响应内容以当次返回为准。
基础 URL https://api.opendata-api.com
curl -X GET 'https://api.opendata-api.com/api/project/barcodes-lookup/search-product-details?key=<API_KEY>&query=3017620422003'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/barcodes-lookup/search-product-details",
params={
"key": "<API_KEY>",
"query": "3017620422003",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/barcodes-lookup/search-product-details");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"query": "3017620422003",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());请求基础设置
- query 的内容决定模式：纯数字走条码查询，返回单个商品对象，barcode_formats 回显命中的编码（upc_a、ean_13、isbn_10、isbn_13）；文本走关键词搜索，返回 results 数组。两种模式共用一个参数，响应结构不同，请先按输入形态分支处理。
- 只有关键词搜索需要翻页：把上一次响应的 nextPage 作为 page 传回取下一批，直到 nextPage 为 null。条码查询请留空 page；合并多页搜索结果时按条码去重。
- 字段深度因商品而异：热门商品带完整属性、营养成分与多店报价，冷门记录可能只有简略标题。未收录的条码返回 HTTP 200 与空 results 数组，属于正常未命中而非请求失败。
查看响应
同时检查 HTTP 状态与网关返回的 code/message/data 业务状态：HTTP 200 只代表请求到达网关，业务成败以 code 与 message 为准。条码未收录时业务仍是成功响应，只是 data 内 results 为空数组——按未命中处理，不要当作错误重试。
按任务选择接口
- 按条码或关键词找商品
-
数字条码（UPC-A、EAN-13、JAN、ISBN-10/13）直接返回商品详情；文本关键词返回分页结果，用响应中的 nextPage 作为 page 续页直到为 null。无需额外凭据，条码查询留空 page 即可。
商品数据
/api/project/barcodes-lookup/search-product-details 按条码或关键词查询商品详情
完整文档 →说明
一个接口两种模式，由 query 的内容决定。条码模式：传入数字条码——UPC-A、EAN-13、JAN、ISBN-10 或 ISBN-13——响应携带商品对象：barcode_formats 回显命中的编码（视情况含 upc_a、ean_13、isbn_10、isbn_13），另有 title、description、类目路径数组、brand 与 manufacturer、属性表（已知时含 mpn、asin、尺寸与重量）、features 特性列表、食品的 nutrition_facts 与 ingredients、图片地址，图书与媒体还有作者或艺人。许多记录还带 online_stores 数组，列出各店铺名称、价格与链接。搜索模式：传入文本关键词，响应携带 results 数组——每条含条码、标题、类目、图片与制造商——外加 nextPage 游标；把它作为 page 传回取下一批，直到 nextPage 为 null。条码查询请留空 page。未收录的条码返回 HTTP 200 与空 results 数组，未命中很容易处理。字段深度因商品而异：热门商品带完整属性与多店报价，冷门记录可能只返回简略标题。
测试接口 1 个必填 · 1 个可选
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
接口能力
把任意商品条码——UPC-A、EAN-13、JAN 或 ISBN-10/13——变成结构化商品数据，或按关键词搜索 5 亿+ 商品目录，一个 GET 接口即可完成。
- 条码查询：传入 UPC、EAN、JAN 或 ISBN 编码，返回标题、描述、类目路径、品牌与制造商、MPN/ASIN/尺寸/重量属性、特性列表、营养成分、商品图片，图书还含作者
- 多店价格：许多记录带 online_stores 数组，含各店铺名称、价格与链接——现成的跨店比价关联键
- 关键词搜索：传入文本关键词，返回分页结果数组，每条含条码、标题、类目、图片与制造商，附 nextPage 翻页游标
- 统一响应契约：数字查询返回商品对象，文本查询返回带分页的结果数组，未收录条码返回干净的空结果
适用于进销存扫码入库、电商刊登预填、比价引擎、食品营养记录、ISBN 图书编目与批量商品目录数据增强。