京东按图搜索京东商品(拍立淘) API (.jd.item_search_img)快速抓取数据

4 阅读2分钟

京东按图搜索商品(拍立淘)API(.jd.item_search_img)的使用需遵循以下规范及步骤:

1. 接口基础信息

  • API名称item_search_img(京东图片搜索接口)

  • 功能描述:通过上传图片或图片URL,识别并返回京东平台相似商品信息(如标题、价格、销量、详情页链接等)。

  • 调用方式:HTTP GET/POST请求,支持JSON/XML格式返回。

  • 参数核心

    • imgid:图片ID(京东格式)、外部图片URL或Base64编码图片数据。
    • key & secret:开发者账号的API密钥(需在京东开放平台申请)。
    • 可选参数:分页(page)、排序(sort)、语言(lang)等。

2. 使用流程

步骤1:获取API权限

  • 注册京东开放平台账号,创建应用并申请item_search_img接口权限。
  • 获取app_keyapp_secret,用于接口鉴权。

步骤2:调用API

  • 请求URL示例

    python
    url = "https://api.jd.com/routerjson?api_name=item_search_img&key=YOUR_KEY&secret=YOUR_SECRET&imgid=图片URL或ID"
    
  • Python示例代码(需安装requests库):

    python
    import requests
    
    url = "https://api.jd.com/routerjson"
    params = {
        "api_name": "item_search_img",
        "key": "YOUR_KEY",
        "secret": "YOUR_SECRET",
        "imgid": "jfs/t1/932/25/457/44818/5b8ff7cbE8027c4ed/f334304e50617cab.jpg"  # 或外部图片URL
    }
    
    response = requests.get(url, params=params)
    result = response.json()
    print(result)
    

步骤3:解析返回数据

  • 响应结构

    json
    {
      "status": 0,  # 0表示成功
      "message": "搜索成功",
      "resultCount": 10,  # 商品数量
      "productList": [
        {
          "productId": "123456789",
          "title": "商品标题",
          "price": "99.00",
          "sales": 1000,
          "pic_url": "https://img11.360buyimg.com/n0/商品图片.jpg",
          "detail_url": "https://item.jd.com/123456789.html"
        }
      ]
    }
    
  • 提取关键字段:商品ID、标题、价格、销量、图片链接、详情页链接。

3. 注意事项

  • 权限与限流

    • 需在京东开放平台申请接口权限,未授权调用将返回错误。
    • 遵守API调用频率限制(如每分钟/每日请求上限),超限可能被封禁。
  • 图片格式:支持JPG、PNG等常见格式,建议图片清晰、主体突出。

  • 错误处理

    • 错误码(如status != 0)需结合文档排查(如密钥无效、图片识别失败)。
    • 网络请求异常需添加重试机制或错误日志。
  • 数据合规

    • 遵守京东平台规则,不得滥用接口(如批量爬取非公开数据)。
    • 保护用户隐私,避免泄露敏感信息。

4. 扩展应用场景

  • 商品推荐:在电商网站/APP中集成“以图搜图”功能,提升用户体验。
  • 竞品分析:通过图片识别竞品商品,获取价格、销量等数据。
  • 库存管理:自动识别商品图片,快速匹配库存信息。

如需进一步操作,可参考京东开放平台官方文档或联系客服获取技术支持。