按 Idealo 商品链接创建查询
查看 Idealo 商品搜索与商家报价 API 的全部接口 →使用已知 Idealo 商品链接查询，而非关键词或条码。在 body 中填写含 country 与 values 的 JSON 对象文本，values 必须恰好包含一个 URL 字符串；直接调用网关时，将整段文本作为 body 的字符串值。country 仅接受 de 或 at，商品链接必须属于相同国家。占位示例使用的是关键词结果中实际出现过的德国商品链接，不是编造的地址。不要提交类目页、任意店铺链接或多个链接。 文档声明创建响应会返回 job_id，随后通过 get-job 取回结果。此路径用于读取指定商品条目及商家报价，但尚无成功的实际 URL 查询响应，因此受理表现与准确结果字段仍未验证。不能把 ID 或条码任务中观测到的详细字段，当成本路径已验证的响应。正式依赖前，应使用当前有效、国家匹配的商品链接单独测试。请保留提交链接与最终逐条状态，并核对任何返回的商品身份。
API 功能
从已选定的商品链接开始 使用用户或选品人员已经确认的 Idealo 商品 URL，无需重复含糊的关键词发现步骤。
商品 URL 与国家保持一致 文档要求链接属于提交的 de 或 at 站点；德国链接不能直接代表奥地利商品选择。
单个商品链接输入约定 values 只放一个商品 URL 字符串；该路径不是类目采集器，也不支持单次导入多个链接。
单独说明链接查询的验证范围 URL 查询有文档但尚未实测；其请求受理与响应结构不能由 ID、条码查询的成功观测代替验证。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
POST
/api/project/idealo/search-by-url API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/idealo/search-by-url?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}'
curl -X POST 'https://api.opendata-api.com/api/project/idealo/search-by-url?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}' 查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 选品链接导入：先验证人工整理表格中的商品 URL 与国家，再分别创建查询任务。
- 粘贴商品链接查询：让用户直接指定已知 Idealo 商品条目，无需猜测搜索关键词。
- 精选优惠链接复核：核查推荐商品时，将提交的商品链接与取回的结果状态一并保留。
- 链接路径试运行：在应用启用 URL 价格监控前，使用审核过的商品链接做该路径的独立冒烟测试。
常见问题
可以提交任意网店链接或类目 URL 吗？
不可以。文档约定输入为一个 Idealo 商品 URL，且必须与 country 指定国家一致。任意商家链接与类目页不在声明的输入范围内。请求结构仅支持 de 和 at。
商品 URL 查询经过实际验证了吗？
没有。成功观测覆盖的是关键词、商品 ID 和条码流程，不包括本路径。占位示例中的已知链接只证明该条目曾出现在搜索结果中，不证明 URL 查询已受理它或返回了特定报价结构。
什么情况下适合用商品链接，而不是关键词？
用户已经选定具体商品条目，或工作从审核过的商品链接表格开始时，适合使用 URL。它能避免关键词选择歧义，但仍需单独测试该路径，并检查最终任务结果。
一次请求能导入多个商品链接吗？
不能。values 必须恰好包含一个 URL 字符串。不同链接请分别验证、安排任务，并将每个提交 URL、国家与返回的任务 ID 保存在一起。