按商品 ID 获取商家报价
查看 Idealo 商品搜索与商家报价 API 的全部接口 →提交一个 Idealo 数字商品 ID 及其所属国家。在 body 中填写 JSON 文本，例如 {"country":"de","values":["204771161"]}；直接调用网关时，将整段文本作为 body 的字符串值。country 仅接受 de 或 at，德国已验证，奥地利尚未测试。values 必须恰好包含一个 ID 字符串。请从同一国家的商品条目中选取 ID；文档声明创建任务时会拒绝 0 和以零开头的 ID。本操作不涉及店铺账户、价格更新或报价上传。 实际创建响应包含 error:false 和 job_id，需通过 get-job 取回结果。商品 204771161 的终态观测为 status:completed、operation:search-by-id、done=1、total=1、summary.found=1。其 found 记录回显 query，且 result.id=204771161，另有名称 Apple iPhone 16、price_min、price_avg、price_max、offers_count、image_urls、country 和 fetched_at。该次返回中的品牌、描述和评价字段为 null。 结果包含 20 条报价，观测字段包括 title、sellerId、shop_name、shop_url、shop_type、marketplace_name、shop_review_rating、shop_review_count、position、condition、currency、price、shipping、total、voucher、availability_code 和 availability_text。free_return 与 direct_sale 可能为 null；该样本也包含 classification 和 confidence。价格币种为 EUR，部分独立店铺的 marketplace_name 使用字符串 N/A。比价时应结合含运费总价、可售状态和成色，不要只按商品价排序。同一 ID 先前在搜索摘要中的报价数为 82，因此取回的 20 条明细不能证明覆盖全部商家。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/idealo/search-by-id API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/idealo/search-by-id?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}' 查询结果
使用场景
- 精选调价监控清单：刷新已审核的国家与商品 ID，并为每条商家价格记录保留 fetched_at。
- 已选商品比价面板：用户选定具体条目后，展示含运费总价与店铺可售状态。
- 商家竞争位置分析：结合返回的排序位置、店铺评价和成色，分析某件商品的竞争情况。
- 兼顾可售状态的低价提醒：仅当返回报价符合应用设定的含运费价格与履约条件时通知用户。
常见问题
商品 ID 应该从哪里获取？
使用关键词结果中选定的 Idealo 商品 ID，或请求国家下已知商品条目的 ID。ID 要以字符串形式发送，每次只能提交一个。文档约定拒绝 0 及以零开头的 ID；不要将条形码保留前导零的规则套用于商品 ID。
哪些字段可以用于商家价格对比？
实际报价提供了 shop_name、shop_type、price、shipping、total、currency、condition、可售状态字段，以及店铺评价信号与 position。请按返回币种比较 total，同时核对成色和可售状态。值为 null 的标记，以及 marketplace_name=N/A，都不能被解读成店铺作出的肯定承诺。
会返回关键词搜索计数中的所有商家吗？
目前不能确认完整覆盖。商品 204771161 在搜索时显示 offers_count=82，详情结果却包含 20 条报价。应把收到的报价集合视为一次观测，既不要承诺穷尽所有商家，也不要据此认定固定最多返回 20 条。
这个接口会更新我的 Idealo 店铺价格吗？
不会。它只创建只读商品数据查询任务，不上传你的报价、不修改店铺价格、不预留库存，也不下单。提交后请通过 get-job 取回结果。