微店图片搜索API接口解析（附 JSON 样例）

摘要

在私域分销选品、内部货源比对、同款商品识别业务中，业务上存在 “上传一张商品图片，检索微店平台同款 / 相似商品” 的需求。

一、整体方案架构

通过weidian.item.shop.list.get商品列表 API 拿到授权店铺全部product_id；

调用weidian.item.detail.get商品详情 API，获取每一件商品主图、标题、价格、sku 等；

将商品图片上传到第三方图像检索引擎（阿里云图像搜索），建立商品图片索引库，绑定product_id作为业务主键；

业务接收用户上传查询图片，调用第三方图搜服务，返回匹配相似度；

根据返回的业务主键product_id，回查本地数据库，组装微店商品结果返回前端。

二、接口介绍

1.公共参数

名称 类型 必须 描述

key String 是 调用key（必须以GET方式拼接在URL中）

secret String 是 调用密钥

api_name String 是 API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]

cache String 否 [yes,no]默认yes，将调用缓存的数据，速度比较快

result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读

lang String 否 [cn,en,ru]翻译语言，默认cn简体中文

version String 否 API版本

2.请求基础信息：

接口名称：micro.item_search_img（微店图片搜索API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

接口版本：2.0

请求参数：imgid:图片地址（仅支持url）

参数说明：imgid:图片地址（仅支持url）

sort:排序[bid2,_bid2,_sale,sale]

(bid2:总价,sale:销量,,加_前缀为从大到小排序)

3.请求示例

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.xxx.cn/micro/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgurl=图片地址"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

三、适用业务场景

私域 ERP 内部：在自己管理的一批微店授权店铺内，图片找同款货源

分销选品系统：对授权店铺商品做内部图片比对，识别同款不同链接商品

商品查重：检测店铺内重复上架的同款商品

四、高频开发踩坑实录

图片防盗链问题：微店返回原图有防盗链，下载图片后再提交给图像检索服务，不可直接把微店 CDN 地址传给第三方图搜。

索引库同步延迟：微店新增 / 删除商品，需要增量同步图像索引，否则检索结果出现脏数据。

相似度阈值调优：背景杂乱图片会降低 similarity 分值，业务上要合理设置阈值，避免大量无关结果。

价格单位：从数据库读出微店原始数据依然是 “分”，输出对外接口务必做单位转换。

五、业务拓展联动其它微店接口

weidian.item.shop.list.get：拉取商品 ID 集合，作为图搜数据源；

weidian.item.detail.get：获取商品图片、SKU、分销佣金，构建本地商品库；

AI 大模型：图搜结果出来之后，结合图片做标题改写、分销文案生成。