按条码或关键词查询商品详情

查看 条形码查询与商品搜索 的全部接口 →

一个接口两种模式,由 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 数组,未命中很容易处理。字段深度因商品而异:热门商品带完整属性与多店报价,冷门记录可能只返回简略标题。

API 功能

一次调用两种模式 数字 query 解析单个条码的完整商品档案;文本 query 自动切换为关键词搜索并分页返回结果。
深度商品档案 每件商品含标题、描述、类目路径、品牌、制造商、MPN/ASIN/尺寸/重量属性、特性列表、营养成分与图片。
逐店价格对比 online_stores 数组列出店铺名称、价格与链接,无需额外调用即可跨零售商比价。
简单游标分页 搜索模式返回 nextPage 游标,作为 page 传回取下一批结果,直到游标为 null。
覆盖主流条码格式 UPC-A、EAN-13、JAN、ISBN-10 与 ISBN-13 走同一个参数,命中格式在 barcode_formats 中回显。

在线 API 演示

GET /api/project/barcodes-lookup/search-product-details

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/barcodes-lookup/search-product-details?key=<API_KEY>&query=<query>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

如何通过条形码查询商品信息?

把 UPC-A、EAN-13、JAN 或 ISBN 条码数字传给 query 即可,响应返回标题、品牌、类目路径、属性与图片等结构化字段;未收录的条码返回空结果,按未命中处理即可。

怎么用 Python 调用条码查询接口获取商品详情?

用 requests 对本接口发起 GET 请求,query 传条码数字并留空 page,再从网关响应的 data 中读取商品对象。做关键词搜索时,把上一次返回的 nextPage 作为 page 传回即可翻页。

ISBN 书号怎么查询图书名称、作者和封面?

把 ISBN-10 或 ISBN-13 传入 query,命中的图书记录含 title、author 与封面图片地址,barcode_formats 会回显匹配到的 isbn_10 或 isbn_13,适合批量图书编目。

扫码比价功能用什么数据接口实现?

用扫描得到的条码调用本接口,命中记录的 online_stores 数组直接给出各店铺名称、价格与链接,以条码为关联键即可完成跨店比价,无需额外请求。

进销存系统扫码自动录入商品信息怎么实现?

扫码枪读出条码后调用本接口,用返回的标题、类目、制造商与图片预填入库单;未收录的条码返回空结果,可转入人工补录流程。

如何通过条码查询食品的营养成分表?

食品类商品命中后返回 nutrition_facts 与 ingredients 字段。字段深度因商品而异,热门食品信息完整,冷门记录可能只有简略标题,入库前请先判空。

相关指南

查看订阅方案 →