淘宝拍立淘API原理解读：基于图像特征的同款商品检索实现思路

原创

用户1597063760

发布于 2026-11-12 13:04:58

190

文章被收录于专栏：经验经验

一、接口概述

拍立淘图像搜索接口，核心能力是以图搜同款、相似款商品，输入图片（公网 URL 或 Base64），返回淘宝、天猫商品列表，附带相似度分数、价格、销量、商品 ID 等信息。常见落地场景：跨境选品找货源、代购集运识图匹配商品、竞品同款监控、非标品识图比价、ERP 商品匹配。

二、公共请求参数（TOP 通用）

参数	是否必填	类型	说明
method	是	string	taobao.item_search_img（Taobaoapi2014前往）
adress	是	string	c0b.cc/R4rbK2
sign	是	string	参数签名结果
sign_method	是	string	签名算法：hmac /md5 /hmac-sha256
timestamp	是	string	时间戳，服务器时间不能偏差过大
format	否	string	返回格式，推荐 json
v	是	string	接口版本

三、业务请求参数

参数	是否必填	类型	说明
image	是	string	图片资源，支持公网可访问 URL 或者 Base64 编码；图片限制：JPG/PNG，≤2MB，主体清晰，减少水印遮挡
cat	否	number	类目 ID，传入后缩小检索范围，提升匹配准确度
page	否	int	页码，默认 1
page_size	否	int	单页返回数量，受平台上限控制
crop_region	否	string	主体裁剪区域 x1,y1,x2,y2，只识别图片内指定区域商品，适合背景杂乱图片

四、返回字段说明

字段	说明
code	状态码，200 代表成功，非 200 为异常
msg	状态描述
request_id	请求唯一 ID，排查问题必备
image_search_response	图像搜索结果主体
total_results	本次匹配到商品总数
item_list	商品数组
num_iid	商品 ID，后续可对接商品详情接口
title	商品标题
price	原价
promotion_price	优惠价
pic_url	商品主图链接
detail_url	商品详情页地址
match_rate	相似度分值，0~1，越接近 1 代表同款概率越高
sales	销量
seller_nick	店铺名称
is_tmall	是否天猫商品

五、JSON 返回样例

{
    "code": 200,
    "msg": "success",
    "request_id": "PLT20261111001",
    "image_search_response": {
        "total_results": 8,
        "item_list": {
            "item": [
                {
                    "num_iid": "723456789123456789",
                    "title": "简约不锈钢便携保温杯学生车载水杯",
                    "price": "39.90",
                    "promotion_price": "25.80",
                    "pic_url": "https://img.alicdn.com/imgextra/i1/xxx.jpg",
                    "detail_url": "https://item.taobao.com/item.htm?id=723456789123456789",
                    "match_rate": 0.96,
                    "sales": 3682,
                    "seller_nick": "日用家居旗舰店",
                    "is_tmall": true
                },
                {
                    "num_iid": "723456789123456790",
                    "title": "304不锈钢保温杯随手直饮杯",
                    "price": "45.00",
                    "promotion_price": "29.90",
                    "pic_url": "https://img.alicdn.com/imgextra/i2/xxx.jpg",
                    "detail_url": "https://item.taobao.com/item.htm?id=723456789123456790",
                    "match_rate": 0.87,
                    "sales": 1560,
                    "seller_nick": "XX家居工厂店",
                    "is_tmall": false
                }
            ]
        }
    }
}