按条形码匹配商品与报价
查看 Idealo 商品搜索与商家报价 API 的全部接口 →每次查询一个由 8–14 位数字组成的 GTIN、EAN、UPC 或 JAN 条码。请始终保留为字符串，包括前导零。在 body 中填写 JSON 文本，例如 {"country":"de","values":["4008400401621"]}；直接调用网关时，将这段文本作为 body 的字符串值。JSON 对象中的 country 只能为 de 或 at，values 必须恰好包含一个条码字符串。实际成功验证只覆盖德国。 观测到的创建响应含 error:false 和 job_id。通过 get-job 取回后，德国 EAN 4008400401621 查询已完成，返回一条 found 的 Ferrero Nutella 商品，id 为 4375366，带有匹配的 ean、country:de、fetched_at、image_urls、category_ids、price_min、price_avg、price_max、offers_count，以及九条 EUR 报价。每条报价包括标题、shop_name、price、shipping、total、成色与可售状态，并带 classification:product_page_match 和 confidence:high；商品的 page_type 为 product。品牌、描述等部分元数据为 null。 比价前必须同时核对商品身份与数量。该 EAN 对应 Nutella 450g，但某条返回报价是 15 x 450g 多件装，且同样标为 product_page_match/high。这些标记本身不能证明是单件或完全相同规格。文档还提到其他页面类型的匹配，但实际观测未覆盖，不能据此承诺统一的分类准确率或完整商家覆盖。审核目录映射后，请连同返回的 ean、商品 ID、国家和时间戳一起保存。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/idealo/search-by-gtin API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/idealo/search-by-gtin?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}' 查询结果
使用场景
- 供应商条码查价：先将供应商 EAN 目录与选定 Idealo 商品匹配，再评估采购机会。
- SKU 与 GTIN 映射审计：核对返回 ean 及商品身份，再把内部 SKU 关联到外部比价记录。
- 食品单位价格分析：根据报价标题及独立核实的数量，区分单瓶商品与多件装。
- 条码匹配异常处理：将规格不明、标识不可用或装量不符的记录转人工审核，而非自动放行。
常见问题
EAN 或 UPC 应该怎样编码提交？
在 values 中放入一个仅含数字、长度为 8–14 位的字符串，country 设为 de 或 at。保留前导零，不要传 JSON 数字，也不要放多个条码。公开参数 body 承载的是整个 JSON 对象序列化后的文本。
条码匹配成功，能保证每条报价的装量相同吗？
不能。EAN 4008400401621 对应 Nutella 450g，但实际结果包含一条 15 x 450g 多件装报价。比较总价或计算单位价格前，请核对标题、数量与规格。
classification、confidence 和 page_type 应该怎么用？
将它们作为辅助匹配信息，而非数量完全一致的证明。已验证商品页的多件装报价也返回 product_page_match 和 high。其他页面类型及其匹配表现尚未经过实际调用验证。
实际条码查询返回了什么？
已完成的德国 Nutella 任务返回一条 found 记录，含 ean 4008400401621、商品 ID 4375366、九条 EUR 报价、商品价、运费、含运费总价、可售状态和 fetched_at。品牌与描述为 null。报价数及有值字段只代表该次观测，不保证每个条码都返回相同内容。