京东图片搜索相似商品API开发指南

一、前言 京东图片搜索API（拍立淘）是京东开放平台基于图像识别技术提供的商品搜索服务，允许开发者通过上传商品图片获取京东平台上的相似商品列表。该接口广泛应用于电商比价、智能导购、商品管理等领域，通过视觉搜索技术突破传统文字搜索的局限，提供更直观的商品发现体验。前往体验：c0b.cc/R4rbK2 。

二、接口概述

1.核心功能

图像识别搜索‌：支持本地图片上传或网络图片URL，通过机器学习算法匹配相似商品。

多维度筛选‌：可按商品分类、价格区间等条件过滤搜索结果。

智能排序‌：支持按相似度、销量、价格等维度排序展示。

分页获取‌：单次请求最多返回100条商品数据，支持分页参数控制。

2.技术特性

请求方式 HTTPS POST/GET，数据格式JSON

认证机制 AppKey + AccessToken双重验证

并发能力 单节点支持1000+ QPS请求

图片要求 JPEG/PNG格式，建议分辨率800×600以上

响应时间 平均300-500ms（依赖图片复杂度）

三、Python请求示例

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " 
app_key = "YOUR_APP_KEY" img id = "图片地址" # 目标图片地址
# 请求示例 url 默认请求参数已经做URL编码
url = "jd/item_search_img/?key=<您自己的apiKey>&imgid=图片地址"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

代码功能说明：

1.封装JDImageSearch类实现完整的API调用流程。

2.支持本地图片和网络图片两种搜索方式。

3.实现京东要求的签名生成算法。

4.包含错误处理和结果解析逻辑。

5.提供分类筛选和分页控制功能。