京东图片搜索商品API使用指南-平芜编程栈

前言

一、摘要

二、接口概述

三、Python 请求示例

四、结语

前言

京东图片搜索商品 API 是京东开放平台提供的一项基于图像识别技术的接口服务，支持开发者通过图片（URL 或 Base64 编码）检索京东平台上的同款、相似商品，为电商导购、商品比价、内容电商等场景提供核心技术支撑。本文将从摘要、接口概述、Python 请求示例、结语四个维度，详细介绍该 API 的使用方式。

一、摘要

京东图片搜索商品 API 依托京东的计算机视觉技术和商品大数据，实现了 “以图找货” 的核心能力。开发者通过传入商品图片的相关标识（如图片 URL、Base64 编码），接口会返回匹配到的京东商品列表，包含商品 ID、名称、价格、链接、相似度等关键信息。该接口广泛应用于电商 APP 的拍立淘功能、第三方导购平台的商品匹配、线下商品的线上溯源等场景，能够有效降低用户搜索成本，提升商品转化效率。
需要注意的是，该 API 属于京东开放平台的授权接口，需完成开发者注册、应用创建、资质审核等步骤后才能获取调用权限，且接口调用存在频率限制和签名验证机制。

二、接口概述

2.1 接入前提
1. 开发者注册：访问 c0b.cc/R4rbK2 完成企业 / 个人开发者注册。
2. 账号获取：在平台控制台，获取AppKey（应用密钥）和AppSecret（应用秘钥）。
3. 权限申请：申请 “图片搜索商品” 相关接口的调用权限，完成资质审核。
4. 签名学习：京东 API 采用签名机制验证请求合法性，需掌握签名生成规则。
2.2 接口核心信息
项目说明
1.请求方式
POST（推荐，支持大体积图片 Base64 编码）/GET。
2.数据格式
JSON（请求体）/FORM（表单提交）。
3.公共请求参数
AppKey、Timestamp（时间戳）、Sign（签名）、Format（返回格式）。
4.业务请求参数
ImageUrl（图片 URL）、ImageBase64（图片 Base64 编码，二选一）、Scene（场景，如同款 / 相似）。
5.返回数据
商品列表（商品 ID、名称、价格、链接、相似度）、请求状态码、错误信息等。
6.调用频率限制
不同开发者等级有不同限制，通常个人开发者 QPS（每秒调用次数）为 1-5。
2.3 签名生成规则
京东 API 签名用于验证请求的合法性，生成步骤如下：
1. 将所有请求参数（公共参数 + 业务参数）按参数名ASCII 码升序排列。
2. 将排序后的参数拼接为key1=value1&key2=value2的字符串。
3. 在字符串末尾拼接AppSecret，得到待签名字符串。
4. 对待签名字符串进行MD5 加密（大写），得到Sign值。

三、Python 请求示例

3.1 准备工作
1. 确保已安装requests库（用于发送 HTTP 请求）：

pip install requests

2.已获取AppKey和AppSecret，并开通接口权限。

3.2 代码实现

说明：以下示例为基于平台规范的模拟实现，实际接口地址和参数需以平台文档为准。

# 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 # 请求示例 url 默认请求参数已经做URL编码 url = "jd/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=https://img13.360buyimg.com/n1/jfs/t1/227724/13/10901/137957/658ce427F3fa0fecd/e310c1eae499d322.jpg" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

3.3 关键说明

图片参数：image_url和image_base64二选一，推荐使用image_url（减少请求体积），若图片为本地文件，可先上传至云存储获取 URL，或转为 Base64 编码。
签名验证：签名是请求成功的关键，需确保参数排序、拼接、加密步骤正确。
错误处理：需捕获请求超时、接口返回错误码等异常，保证程序健壮性。