淘宝/天猫的拍立淘（Taobao Image Search）功能允许用户通过上传图片来搜索相似的商品。然而，直接通过API使用这个功能（如taobao.item_search_img）在淘宝/天猫的官方API中并不直接提供。淘宝/天猫的开放平台（Taobao Open Platform, TOP）提供了丰富的API接口，但具体的图片搜索API可能因政策、版权或技术原因而不直接对外公开。
一、商品信息相关
- 基本商品描述：
- 商品名称：明确地展示所识别到的商品的具体名称。例如，如果用户通过拍立淘拍摄了一款运动鞋，返回的商品名称字段中会详细描述该运动鞋的品牌、型号等关键信息，如 “耐克 Air Max 270 运动鞋”。
- 商品规格：包括尺寸、颜色、款式等详细规格信息。比如对于服装类商品，可能返回 “M 码蓝色修身款衬衫” 这样的规格描述。
- 商品价格区间：给出该商品在淘宝 / 天猫平台上的大致价格范围。例如 “价格区间：100 - 200 元”，帮助用户快速了解商品的价格水平。
- 商品图片链接：
- 通常会返回一组与识别到的商品相关的高质量图片链接。这些图片可以是商品的主图、细节图等，用于在应用界面中展示给用户，让用户更直观地了解商品的外观。例如，一个包含多张不同角度展示商品的图片 URL 列表。
- 店铺及卖家信息：
- 店铺名称：告知用户该商品所属的店铺名称，帮助用户了解商品的销售来源。例如 “XX 运动专营店”。
- 卖家信誉评级：可能会返回卖家的信誉等级或者相关的评价指标，如店铺的星级、好评率等。这有助于用户判断卖家的可靠性和商品的质量保障程度。
- 发货地：显示商品的发货地点信息，对于一些用户关注物流速度或者希望购买本地或特定地区商品的情况非常重要。例如 “广东广州发货”。
二、搜索匹配度及推荐相关
- 相似度评分：
- 一个表示拍摄的图像与识别到的商品之间相似程度的数值指标。例如，以百分比的形式呈现，“相似度：80%”，数值越高表示匹配度越高，让用户了解搜索结果的准确性。
- 相关推荐商品列表：
- 除了直接匹配的商品外，还可能返回一些相关的或者类似的商品信息。例如，如果用户拍摄了一款某品牌的手机，除了返回该型号手机的详细信息外，还可能推荐同品牌的其他型号手机或者具有类似功能和价格区间的竞争品牌手机。
- 每个推荐商品也会包含类似上述的基本商品描述和图片链接等信息，形成一个相关商品的推荐列表。
三、购买及交易信息引导
- 购买链接及入口：
- 提供直接跳转到商品购买页面的链接或者入口标识。用户可以通过点击这个链接直接进入淘宝 / 天猫平台上该商品的销售页面进行购买操作。
- 例如，一个包含商品唯一标识符的深度链接，确保用户能够准确地访问到目标商品页面。
- 促销及优惠信息：
- 如果商品正在参与促销活动，会返回相关的促销信息，如 “限时折扣，立减 20 元” 或者 “满减优惠，满 100 减 30” 等。
- 还可能包括优惠券信息，提示用户是否有可领取的针对该商品的优惠券，以及优惠券的面额和使用条件等。
四、用户评价及销量数据
- 用户评价统计：
- 展示该商品的用户评价总体情况，如 “好评率：90%” 或者 “累计评价数：1000+”。这些数据可以让用户初步了解商品的受欢迎程度和质量口碑。
- 热门评价关键词：
- 提取并返回一些用户评价中的热门关键词，帮助用户快速了解商品的优点和缺点。例如对于一款耳机，可能返回 “音质清晰”“佩戴舒适”“续航能力强” 等正面关键词，或者 “连接不稳定” 等负面关键词（如果存在较多此类评价）。
需要注意的是，实际的 API 返回值可能会更加复杂和详细，并且可能会随着淘宝 / 天猫平台的技术更新和业务发展而不断变化和扩展。如果需要准确地解析和使用拍立淘 API 的返回值，建议参考淘宝 / 天猫的官方开发文档或者与他们的技术支持团队进行沟通.
taobao.item_search_img
公共参数
请求地址: https://api-gw.fan-b.com/taobao/item_search_img
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数
请求参数：imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg
参数说明：imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址）
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
page:页数
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| title | String | 0 | 亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮 | 宝贝标题 |
| cid | Int | 0 | 50015374 | |
| list_type | String | 0 | 外观相似宝贝 | 列表类型 |
| pic_url | String | 0 | //g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg | 宝贝图片 |
| promotion_price | String | 0 | 38.71 | 优惠价 |
| price | Float | 0 | 39.50 | 价格 |
| sales | Int | 0 | 7 | 销量 |
| num_iid | Bigint | 0 | 575727312808 | 宝贝ID |
| sample_id | Bigint | 0 | 1627115368 | 商品风格标识ID |
| seller_nick | String | 0 | 专属味道之dzw | 掌柜昵称 |
| is_tmall | Bool | 0 | false | |
| post_fee | String | 0 | 0.00 | 物流费用 |
| area | String | 0 | 广东 东莞 | 店铺所在地 |
| detail_url | String | 0 | //item.taobao.com/item.htm?id=575727312808&ns=1#detail | 宝贝链接 |
了解更多跨境独立站电商代购系统和国内外电商API，可以私信或评论区交流 ，感谢你的关注。
