摘要：taobao.item_search_img淘宝拍立淘是电商图像检索核心接口，广泛用于同款匹配、货源溯源、跨境选品、竞品扒款。本文整理官方标准全量返回字段，包含顶层响应、分页统计、商品单品字段、相似度字段、价格体系、店铺字段，附带标准JSON示例、字段业务用途、开发避坑要点，适合开发者对接、数据清洗、选品系统落地使用。
一、接口基础概述
接口名称：taobao.item_search_img（拍立淘-图片搜商品，Taobaoapi2014移步体验）
能力：传入公网图片URL，返回淘宝/天猫同款、相似款结构化商品数据
数据核心亮点：自带similar_score 视觉相似度分值，是文字搜索无法替代的选品、溯源核心依据
二、顶层响应通用字段
所有请求统一返回外层结构，用于判断请求状态、排查异常
字段类型说明业务用途
codeString响应状态码，0为成功判断接口是否正常返回
msgString响应描述信息排查签名错误、限流、权限不足问题
request_idString请求唯一ID日志排查、问题溯源
dataObject业务数据主体核心解析对象
三、data 分页统计字段（全局数据）
用于判断检索结果体量，适配分页批量选品
字段说明
total_results本次图片检索匹配到的商品总数量
real_total_results真实有效商品总数（过滤下架、违规商品）
page当前页码
page_size每页返回商品数，默认20条
pagecount总页数
四、items[] 单品核心字段（业务重点）
接口核心返回数组，每一条为一款相似/同款商品，选品、溯源、比价全部依赖该层字段
字段类型详细说明 & 业务场景
similar_scoreFloat核心字段，视觉相似度分值 0~1。≥0.75 为精准同款，0.6~0.75 为相似变体，<0.6 无效匹配，用于选品过滤杂质数据
num_iidString商品唯一ID，全局唯一主键，可用于二次抓取商品详情、SKU、评论
titleString商品完整标题，用于关键词复核、类目判断、款式校验
pic_urlString商品主图地址，用于前端展示、二次图像比对
priceString商品原价/挂牌价，用于价格区间统计
promotion_priceString实操最常用，实时促销售价、到手价，比价、利润核算、选品定价核心字段
salesInt累计销量，判断款式热度、爆款潜力、铺货竞争度
detail_urlString商品淘宝原生详情链接，用于跳转、二次采集
is_tmallBoolean是否天猫店铺，true=天猫，false=淘宝C店，用于筛选优质货源
nickString店铺名称，用于货源溯源、商家筛选
seller_nickString卖家账号昵称，用于商家维度统计
areaString卖家发货地区，用于供应链、物流成本分析
post_feeString运费价格，用于完整拿货成本核算
