运行中付费热门生活服务

商品条码查询PRO

API

官方权威的商品条码查询接口，返回国内注册商品条码的登记信息。与 barcode-lookup 定位不同： - 官方商品图只在本接口 images ；免费版 barcode-lookup 不含图片，也不再提供 image 字段 - 本接口官方权威：返回厂商注册名称、产品登记信…

接入文档

由极数本源提供·更新于昨天

先试用，再接接口

不用写代码。打开工具页跑一遍 GS1 条形码解析，看清结果再来订阅。

打开GS1 条形码解析

2.4M

累计调用

3023ms

平均响应

99.61%

服务可用性

5 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案

QPS 2

今日已用 … / 5 次/日…

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每天 2 次 · 每秒 1 次

登录免费

当前方案

每天 5 次 · 每秒 2 次

黄金会员

每天 5,000 次 · 每秒 10 次

钻石会员

每天 10,000 次 · 每秒 30 次

企业会员

企业接口额度 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/barcode-gs1/raw.md

打开文档

接入文档

打开

在线工具

打开GS1 条形码解析

接口请求地址

https://v1.apizero.cn/api/barcode-gs1

接口请求方式

GET

请求参数格式

URL QUERY

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/barcode-gs1?code=6921168509256

接口信息备注

会员版返回标准字段外的 height/width/depth/gross_weight/studio，以及 official 原始条目。未登记 found=false。免费版请用 barcode-lookup。

请求参数说明

codestring

必填 · 商品条形码（8/12/13/14 位纯数字，或 16 位 AI(01) 前缀 + GTIN-14） · 示例：6921168509256

名称	类型	说明
code	string	必填 · 商品条形码（8/12/13/14 位纯数字，或 16 位 AI(01) 前缀 + GTIN-14） · 示例：6921168509256

请求头说明

Authorizationstring

必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

名称	类型	说明
Authorization	string	必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

返回字段说明

barcodestring

13 位标准 EAN-13 条码

gtin14string

14 位 GTIN（左侧补 0 标准化）

foundboolean

是否查到登记信息；false 时其余业务字段为 null

registeredboolean

条码是否已正式注册

registration_messagestring

注册状态说明文本

namestring

完整产品名（含品牌+规格）

brandstring

品牌名称

general_namestring

产品通用名

featurestring

产品特征描述

categorystring

产品分类（含 GPC 分类编号）

specificationstring

规格

net_contentstring

净含量

sale_datestring

上市日期（YYYY-MM-DD）

manufacturerstring

发布企业名称（官方注册主体）

imagesstring[]

商品图 URL

product_create_datestring

商品创建时间

use_daysinteger

条码从登记到现在已用天数

category_codestring

GPC 全球品类编码

heightstring

包装高度（毫米）

widthstring

包装宽度（毫米）

depthstring

包装深度（毫米）

gross_weightstring

毛重

studiostring

包装尺寸原文

officialobject

原始登记条目（含 gtin/gpc/firm_name/gtinstatus 等全部键）

keywordstring

keyword

branch_codestring

branch_code

gtinstring

gtin

specificationstring

specification

is_privateboolean

is_private

firm_namestring

firm_name

brandcnstring

brandcn

picture_filenamestring

picture_filename

descriptionstring

description

logout_flagstring

logout_flag

have_ms_productnumber

have_ms_product

base_create_timestring

base_create_time

branch_namestring

branch_name

base_sourcestring

base_source

gpcstring

gpc

gpcnamestring

gpcname

saledatestring

saledate

saledateyearnumber

saledateyear

base_last_updatedstring

base_last_updated

gtinstatusnumber

gtinstatus

RegulatedProductNamestring

RegulatedProductName

certificateNumberstring

certificateNumber

official_hitboolean

是否拿到官网档案。true=有档（尺寸仍可能为空）；false=走了备源

official_detail_hitboolean

是否命中官网商品详情（尺寸 / 图片等）。true=详情页命中；false=仅有列表项或走了备源

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

名称

类型

说明

barcode

string

13 位标准 EAN-13 条码

gtin14

string

14 位 GTIN（左侧补 0 标准化）

found

boolean

是否查到登记信息；false 时其余业务字段为 null

registered

boolean

条码是否已正式注册

registration_message

string

注册状态说明文本

name

string

完整产品名（含品牌+规格）

brand

string

品牌名称

general_name

string

产品通用名

feature

string

产品特征描述

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "barcode": "6921168509256",
    "gtin14": "06921168509256",
    "found": true,
    "registered": true,
    "registration_message": "该商品条码已在中国物品编码中心注册，编码信息已按规定通报。",
    "name": "农夫山泉饮用天然水",
    "brand": "农夫山泉",
    "general_name": "水（瓶装、桶装等）",
    "feature": null,
    "category": "水（瓶装、桶装等）(10000232)",
    "specification": "550毫升",
    "net_content": "550毫升",
    "sale_date": "2008-07-24",
    "manufacturer": "农夫山泉股份有限公司",
    "images": [
      "https://oss.gds.org.cn/userfile1/uploadb/gra/sj211126172650708225/06921168509256/06921168509256.1.jpg"
    ],
    "product_create_date": "2008-11-07T19:39:39.28",
    "use_days": 6469,
    "category_code": "10000232",
    "height": "227毫米",
    "width": "64毫米",
    "depth": "64毫米",
    "gross_weight": "586克",
    "studio": "高度：227毫米 宽度：64毫米 深度：64毫米 毛重：586克 净含量：550毫升",
    "official": {
      "keyword": "农夫山泉",
      "branch_code": "3301",
      "gtin": "06921168509256",
      "specification": "550毫升",
      "is_private": false,
      "firm_name": "农夫山泉股份有限公司",
      "brandcn": "农夫山泉",
      "picture_filename": "/userfile1/uploadb/gra/sj211126172650708225/06921168509256/06921168509256.1.jpg",
      "description": "",
      "logout_flag": "0",
      "have_ms_product": 0,
      "base_create_time": "2008-11-07T19:39:39.28",
      "branch_name": "浙江分中心",
      "base_source": "www",
      "gpc": "10000232",
      "gpcname": "水（瓶装、桶装等）",
      "saledate": "2008-07-24T00:00:00",
      "saledateyear": 2008,
      "base_last_updated": "2024-07-24T11:45:49",
      "gtinstatus": 1,
      "RegulatedProductName": "农夫山泉饮用天然水",
      "certificateNumber": null
    },
    "official_hit": true
  },
  "tips": "极数本源 · https://apizero.cn"
}

免责声明

【数据来源声明】本接口返回公开的商品条码注册信息。极数本源仅提供查询服务，不持有、不修改商品资料的所有权。

【准确性免责】

数据准确性、完整性、时效性由原数据提供方负责，本平台不做任何明示或默示的担保
商品资料以企业向编码中心申报的最新信息为准；如查询结果与实物存在差异，请以实物包装或厂商声明为准
"found=false / 未注册 / 未找到"结果仅代表服务数据库当前未收录该条码，不构成对商品本身合法性、真伪或存在性的判断
本接口为辅助查询工具，不能替代官方鉴别、监管核验或司法鉴定

【知识产权声明】

接口返回的商品名称、品牌名称、商标、商品图片、企业名称、注册编码等所有知识产权归原权利人所有
调用方调用本接口所获取的数据，仅可用于合法的内部核验、数据展示、信息聚合等用途
调用方对所获取数据的使用方式自行负责，因下列任一行为引发的全部法律责任由调用方独立承担：
· 任何违反中华人民共和国法律法规及当地适用法律的活动
· 复制、仿冒、伪造商品身份或编码信息
· 恶意抢注、囤积或侵犯第三方商标、专利、著作权及其他知识产权
· 虚假宣传、误导消费者、商业诋毁或不正当竞争
· 未经原权利人授权对外销售、转让、二次分发本接口数据或基于本接口构建商品数据库对外牟利
· 利用本接口数据从事走私、伪劣商品销售、洗钱、欺诈等违法犯罪活动
· 其他侵犯第三方合法权益或公共利益的行为

【责任豁免】

调用方因使用本接口数据产生的一切纠纷、损失、行政处罚、民事赔偿、刑事责任等法律后果，均由调用方独立承担，与极数本源平台无关
本平台对因服务数据错误、服务中断、网络故障、不可抗力等情形导致的间接或直接损失不承担任何赔偿责任
本平台对因调用方违反本声明造成的第三方索赔，调用方应主动出面解决，并使本平台免受任何损失；如本平台被迫支付任何费用，有权向调用方全额追偿

【服务变更权】为保障合规运营、服务政策适配及风险控制，本平台保留以下权利且无需事先通知：

调整或限制本接口的可用范围、调用频率、字段输出
在服务接口风控、政策调整、商业条款变化时暂停或下线本接口
对涉嫌违规调用的 API Key、IP、账户实施限流、封禁或终止服务
应监管部门、原数据权利人或司法机关要求，配合提供调用记录或屏蔽特定数据

【关键业务建议】对于药品追溯、特种设备核验、食品安全监管、海关申报、司法证据等高合规要求场景，请以主管部门或权利人提供的正式材料为准，本接口仅供辅助参考，不作为合规依据或法律证据。

【接受条款】调用本接口即视为调用方（包括其授权的最终用户）已完整阅读、理解并同意上述全部条款。如不同意任意一条，请立即停止调用本接口。

加载接口文档…

名称

类型

说明

code

string

必填 · 商品条形码（8/12/13/14 位纯数字，或 16 位 AI(01) 前缀 + GTIN-14） · 示例：6921168509256

名称

类型

说明

Authorization

string

{ "code": 0, "msg": "成功", "data": { "barcode": "6921168509256", "gtin14": "06921168509256", "found": true, "registered": true, "registration_message": "该商品条码已在中国物品编码中心注册，编码信息已按规定通报。", "name": "农夫山泉饮用天然水", "brand": "农夫山泉", "general_name": "水（瓶装、桶装等）", "feature": null, "category": "水（瓶装、桶装等）(10000232)", "specification": "550毫升", "net_content": "550毫升", "sale_date": "2008-07-24", "manufacturer": "农夫山泉股份有限公司", "images": [ "https://oss.gds.org.cn/userfile1/uploadb/gra/sj211126172650708225/06921168509256/06921168509256.1.jpg" ], "product_create_date": "2008-11-07T19:39:39.28", "use_days": 6469, "category_code": "10000232", "height": "227毫米", "width": "64毫米", "depth": "64毫米", "gross_weight": "586克", "studio": "高度：227毫米宽度：64毫米深度：64毫米毛重：586克净含量：550毫升", "official": { "keyword": "农夫山泉", "branch_code": "3301", "gtin": "06921168509256", "specification": "550毫升", "is_private": false, "firm_name": "农夫山泉股份有限公司", "brandcn": "农夫山泉", "picture_filename": "/userfile1/uploadb/gra/sj211126172650708225/06921168509256/06921168509256.1.jpg", "description": "", "logout_flag": "0", "have_ms_product": 0, "base_create_time": "2008-11-07T19:39:39.28", "branch_name": "浙江分中心", "base_source": "www", "gpc": "10000232", "gpcname": "水（瓶装、桶装等）", "saledate": "2008-07-24T00:00:00", "saledateyear": 2008, "base_last_updated": "2024-07-24T11:45:49", "gtinstatus": 1, "RegulatedProductName": "农夫山泉饮用天然水", "certificateNumber": null }, "official_hit": true }, "tips": "极数本源 · https://apizero.cn" }