×

京东拍立淘按图搜索API接口，json数据返回

知名用户18007905473 知名用户18007905473 发表于2025-10-23 15:56:31 浏览46 评论0

抢沙发发表评论

京东拍立淘按图搜索API接口通过图像识别技术，允许用户上传图片或提供图片URL，在京东商品库中搜索相似商品，并返回结构化的JSON数据。以下是该接口的核心要点与JSON数据返回结构分析：

一、接口核心功能

  1. 图像识别搜索：基于深度学习算法，分析上传图片的外观、颜色、形状等特征，匹配京东平台上的相似商品。

  2. 多场景应用：适用于电商导购、竞品分析、假货识别等场景，提升购物效率与用户体验。

  3. 灵活参数支持：支持图片URL、Base64编码图片、商品类目筛选、分页控制等参数。

二、JSON数据返回结构

成功响应的JSON数据通常包含以下关键字段：

json{"status": "success","code": 200,"message": "请求成功","result": {"total": 100,"items": [{"product_id": "100012345678","product_name": "某品牌智能手机 128GB 星空黑","image_url": "https://example.com/image1.jpg","price": "1999.00","sale_price": "1599.00","score": 0.95,"stock": "有货","category_name": "手机通讯","detail_url": "https://item.jd.com/100012345678.html"},{"product_id": "100012345679","product_name": "某品牌无线耳机 白色","image_url": "https://example.com/image2.jpg","price": "299.00","sale_price": "259.00","score": 0.88,"stock": "有货","category_name": "数码配件","detail_url": "https://item.jd.com/100012345679.html"}]}}

三、关键字段说明

  1. 状态与分页信息：

    • status：请求状态（如success）。

    • code：状态码（200表示成功，400/500表示错误）。

    • message：状态描述（如请求成功）。

    • total：符合条件的商品总数，用于分页控制。

  2. 商品信息：

    • product_id：商品唯一标识符（京东内部SKU编号）。

    • product_name：商品名称（可能包含关键词高亮标记）。

    • image_url：商品主图URL（需拼接完整路径，如https://img10.360buyimg.com/ + 路径）。

    • price：商品原价（单位：元）。

    • sale_price：促销价（如有）。

    • score：匹配度评分（0-1，数值越高匹配度越高）。

    • stock：库存状态（如有货）。

    • category_name：商品所属分类（三级分类，如手机/数码/手机通讯）。

    • detail_url：商品详情页链接（可直接跳转至京东页面）。

四、接口调用流程

  1. 准备工作：

    • 注册京东开放平台账号，完成实名认证。

    • 创建应用，申请京东图片搜索拍立淘API权限，获取App Key和App Secret。

  2. 构建请求：

    • method：固定值jd.union.open.goods.query。

    • app_key：您的应用标识。

    • 360buy_param_json：包含图片URL或Base64编码的JSON字符串（如{"goodsIdList":[{"goodsId":"https://example.com/product.jpg"}]}）。

    • timestamp：当前时间戳（秒级）。

    • sign：通过MD5算法生成的签名（需结合App Secret和参数排序）。

    • 请求地址：https://api.jd.com/routerjson（需替换为最新文档中的地址）。

    • 关键参数：

  3. 发送请求：

    • 使用Python的requests库发送GET请求，并解析返回的JSON数据。

  4. 错误处理：

    • 检查App Key和App Secret是否正确。

    • 确保签名生成算法符合京东要求。

    • 捕获HTTP异常（如400、500错误），并解析返回的error_code和error_message。

五、应用场景

  1. 电商导购：开发购物助手应用，用户上传商品图片，快速找到京东上的相似商品。

  2. 竞品分析：商家查找竞品信息，分析价格、销量、用户评价等，制定营销策略。

  3. 假货识别：通过图像搜索，识别平台上的假货或侵权商品，保护品牌权益。


群贤毕至

访客