商品条码查询PRO

barcode-gs1GET
GEThttps://v1.apizero.cn/api/barcode-gs1

概述

官方权威的商品条码查询接口,返回国内注册商品条码的登记信息。 与 `barcode-lookup` 定位不同: - 官方商品图只在本接口 `images`;免费版 barcode-lookup 不含图片,也不再提供 image 字段 - 本接口**官方权威**:返回厂商注册名称、产品登记信息、上市日期、官方商品图等可追溯的官方数据 - 本接口**仅覆盖国内注册条码**(6/690 开头),进口商品或非注册条码会返回 found=false - 适合合规核验、溯源、上架审核等对数据权威性要求高的场景 支持输入格式:8 / 12 / 13 / 14 位纯数字,或 16 位 AI(01) 前缀 + GTIN-14。 返回数据包含:产品名称、品牌、通用名、分类(含分类编号)、规格、净含量、上市日期、厂商企业名、官方商品图、条码激活日期、产品创建日期、企业注册日期、已用天数等核心字段,部分情况下额外提供生产国、企业地址、参考售价、厂商识别代码等扩展字段。 【调用额度说明】 本接口额度以本页为准(与平台 VIP 在多数接口上的默认日免费额度不同): - 匿名试用:每日 2 次 - 登录免费:每日 5 次 - 黄金 VIP:每日 5,000 次 - 企业 VIP:按平台 VIP 日额度 - 高频场景:建议购买本接口基础版月卡 / 年卡(更高总量与 QPS);超出后也可按次计费

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/barcode-gs1/raw.md
打开 Markdown

鉴权

匿名可调用:QPS 1、日 2 次(仅供试用);登录后:QPS 40、日 5 次;黄金会员:QPS 80、日 5000 次;钻石会员:QPS 80、日 10000 次;企业会员:QPS 120、日 1000000 次。批量查询请控制在QPS 120以内。

获取 API Key

请求头

Authorizationstring必填

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

商品条码查询

GETURL QUERY·APPLICATION/JSON

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

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

code(编码)string必填

商品条形码(8/12/13/14 位纯数字,或 16 位 AI(01) 前缀 + GTIN-14)

例6921168509256

返回结果

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

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

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/barcode-gs1?code=6921168509256"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快(QPS)

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
按次付费 · 点数包 · 月套餐
QPS 限制
QPS 40
登录免费额度
5 次(已认证)
匿名每日额度
2 次(无 API Key)
黄金会员
每天 5,000 次 · QPS 80
钻石会员
每天 10,000 次 · QPS 80
企业会员
本接口约 79,800 次/月 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 2.1.12026-09-12

    点明商品图 images 仅本接口提供,免费版 barcode-lookup 不含图

  • 2.1.02026-08-28

    响应字段对齐现网回包:去掉 qr_active_date / company_register_date / country / address / price;补 height / width / depth / gross_weight / studio / official / official_hit

  • 2.0.02026-05-11

    本地命中第 10/20/30... 次时自动后台调服务拉最新数据,高频条码自动保鲜,响应字段补全:补充 country / address / price / category_code 等扩展字段(部分源提供),免责声明完善:新增完整法律免责条款,明确数据归属、知识产权、责任豁免边界

  • 1.0.02026-05-08

    首次上线

免责声明

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

【准确性免责】

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

【知识产权声明】

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

【责任豁免】

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

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

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

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

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