运行中付费热门HOT生活服务

商品条码查询PRO

API

官方权威的商品条码查询接口，返回国内注册商品条码的登记信息。与 barcode-lookup 定位不同： - 本接口官方权威：返回厂商注册名称、产品登记信息、上市日期、官方商品图等可追溯的官方数据 - 本接口仅覆盖国内注册条码 (6/690 开头)，进口商品或非注册条码会…

文档

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

46万

累计调用

847ms

平均响应

99.59%

服务可用性

5 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案

QPS 2

今日已用 0 / 5 次/日0.0%

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

无 Key 调用

每日 2 次 · QPS 1

登录免费

当前方案

每日 5 次 · QPS 2

黄金会员

每日 5,000 次 · QPS 15

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

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

接口请求地址

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。

请求参数说明

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

请求头说明

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

返回字段说明

名称	类型	说明
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	产品特征描述
category	string	产品分类（含 GPC 分类编号）
specification	string	规格
net_content	string	净含量
sale_date	string	上市日期（YYYY-MM-DD）
manufacturer	string	发布企业名称（官方注册主体）
images	string[]	商品图 URL
product_create_date	string	商品创建时间
use_days	integer	条码从登记到现在已用天数
category_code	string	GPC 全球品类编码
height	string	包装高度（毫米）
width	string	包装宽度（毫米）
depth	string	包装深度（毫米）
gross_weight	string	毛重
studio	string	包装尺寸原文
official	object	原始登记条目（含 gtin/gpc/firm_name/gtinstatus 等全部键）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "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

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

名称

类型

说明

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

产品特征描述

category

string

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

specification

string

规格

net_content

string

净含量

sale_date

string

上市日期（YYYY-MM-DD）

manufacturer

string

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

images

string[]

商品图 URL

product_create_date

string

商品创建时间

use_days

integer

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

category_code

string

GPC 全球品类编码

height

string

包装高度（毫米）

width

string

包装宽度（毫米）

depth

string

包装深度（毫米）

gross_weight

string

毛重

studio

string

包装尺寸原文

official

object

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

tips

string

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

{ "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" }