淘宝/1688/义乌购按图搜索淘宝商品的拍立淘 API 是一种基于图像识别技术的服务接口，具有以下特点和使用方式：
特点：
精准匹配：能够快速准确地识别上传的图片或拍摄的实物，在海量商品数据库中找出相似或完全一致的商品，提高购物搜索的准确性和效率。
个性化推荐：通过分析消费者的搜索历史、购买记录等信息，为消费者提供更加个性化的购物推荐，满足不同消费者的需求和喜好。
简化购物流程：消费者只需上传图片或拍摄实物，即可快速找到心仪的商品，节省了时间和精力。
使用方式（以淘宝的按图搜索商品 API 接口 item_search_img 为例）：
注册账号与创建应用：在淘宝开放平台注册账号，并成为开发者，然后创建一个新的应用，以获取 API Key 和 API Secret。
授权权限：根据淘宝开放平台的要求，为账号授权使用拍立淘 API 的权限。
3.接收搜索结果：系统将匹配到的商品列表返回给用户，列表中包含每个商品的详细信息，如商品 ID、标题、图片 URL、价格、销量、店铺信息、商品详情链接以及相似度得分等。这些信息可以帮助用户更加全面地了解商品，并进行选择和比较。
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:图片地址(仅支持图片链接)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
响应参数
Version: Date:
名称 类型 必须 示例值 描述
items items[] 0 按图搜索淘宝商品（拍立淘）
请求示例：
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
响应示例：
{
"items": {
"pagecount": 3,
"total_results": 60,
"real_total_results": 60,
"item": [
{
"title": "李宁篮球袜男款专业实战短筒运动袜子女夏跑步中长精英美式毛巾底",
"picurl": "https://img.alicdn.com/imgextra/O1CN01i8iOpV1rZSiOwyUYE!!2068455645.jpg",
"promotion_price": "25.00",
"price": "25.00",
"num_iid": "785697155584",
"is_tmall": "false",
"area": "淄博",
"detail_url": "//item.taobao.com/item.htm?id=785697155584"
},
{
"title": "likeid篮球袜美式中长筒袜男夏季专业实战精英袜训练防滑运动袜子",
"picurl": "https://img.alicdn.com/imgextra/O1CN01tzf4lC1RMTNN4FCVw!!623082097.jpg",
"promotion_price": "19.90",
"price": "19.90",
"num_iid": "706255675043",
"is_tmall": "false",
"area": "佛山",
"detail_url": "//item.taobao.com/item.htm?id=706255675043"
},
{
"title": "黑人月精英专业篮球袜加厚毛巾底中筒高筒运动袜子男",
"picurl": "https://img.alicdn.com/imgextra/TB2luFSbTIlyKJjSZFMXXXvVXXa!!546743164.jpg",
"promotion_price": "12.90",
"price": "12.90",
"num_iid": "543839578944",
"is_tmall": "false",
"area": "深圳",
"detail_url": "//item.taobao.com/item.htm?id=543839578944"
},
{
"title": "李宁运动袜子男短筒专业跑步篮球羽毛球女款棉透气防臭毛巾底秋冬",
"picurl": "https://img.alicdn.com/imgextra/O1CN01i8iOpV1rZSiOwyUYE!!2068455645.jpg",
"promotion_price": "29.00",
"price": "29.00",
"num_iid": "751100232040",
"is_tmall": "false",
"area": "淄博",
"detail_url": "//item.taobao.com/item.htm?id=751100232040"
},
{
"title": "实战篮球袜精英款训练斯坦斯stance篮球袜子高筒559中筒359毛巾底",
"picurl": "https://img.alicdn.com/imgextra/O1CN01GJGJlc1fwZNLhfdEe!!2215130674071.jpg",
"promotion_price": "43.90",
"price": "43.90",
"num_iid": "835954755321",
"is_tmall": "false",
"area": "石家庄",
"detail_url": "//item.taobao.com/item.htm?id=835954755321"
},
{
"title": "袜子男防臭防脚气夏季薄款运动抑菌中筒袜吸汗毛巾底篮球袜四季fm",
"picurl": "https://img.alicdn.com/imgextra/O1CN01Y89HYb2KdErlFuBmQ!!4059759579.jpg",
"promotion_price": "20.71",
"price": "20.71",
"num_iid": "787279891547",
"is_tmall": "false",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=787279891547"
},
{
"title": "斗牛篮球精英袜男款高帮加厚毛巾底专业实战长筒防滑透气运动袜子",
"picurl": "https://img.alicdn.com/imgextra/O1CN011VQ3pa1nRthROBUCP!!2212944505087.jpg",
"promotion_price": "19.80",
"price": "19.80",
"num_iid": "751809323321",
"is_tmall": "true",
"area": "金华",
"detail_url": "//item.taobao.com/item.htm?id=751809323321"
},
{
"title": "包邮皇马主客场足球袜灰色白色紫色球袜毛巾底长筒过膝足球袜",
"picurl": "https://img.alicdn.com/imgextra/TB2kc0RbwJlpuFjSspjXXcT.pXa!!85536437.jpg",
"promotion_price": "16.00",
"price": "16.00",
"num_iid": "528042874974",
"is_tmall": "false",
"area": "郑州",
"detail_url": "//item.taobao.com/item.htm?id=528042874974"
},
{
"title": "科比欧文加厚专业篮球袜男中筒精英袜高帮毛巾底防滑透气吸汗防臭",
"picurl": "https://img.alicdn.com/imgextra/O1CN01YjiY1A1eHyLEsYqae!!2908813847.png",
"promotion_price": "29.90",
"price": "29.90",
"num_iid": "636638770741",
"is_tmall": "true",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=636638770741"
},
{
"title": "情缘 袜子男士 足球袜 运动袜 提花袜 定制袜 长筒袜男定制",
"picurl": "https://img.alicdn.com/imgextra/O1CN0130nTa524Rl8JXBJqz!!0-item_pic.jpg",
"promotion_price": "12.80",
"price": "12.80",
"num_iid": "845255066462",
"is_tmall": "false",
"area": "鹤壁",
"detail_url": "//item.taobao.com/item.htm?id=845255066462"
},
{
"title": "儿童专用篮球袜男童女童专业秋冬加厚中筒纯棉袜实战训练运动袜子",
"picurl": "https://img.alicdn.com/imgextra/O1CN01wduMDu21IeIqyyIKI!!6000000006962-0-yinhe.jpg",
"promotion_price": "13.90",
"price": "13.90",
"num_iid": "710555714441",
"is_tmall": "false",
"area": "佛山",
"detail_url": "//item.taobao.com/item.htm?id=710555714441"
},
{
"title": "春秋款透气中筒篮球袜纯棉男女儿童大码彩色黄绿蓝色运动训练",
"picurl": "https://img.alicdn.com/imgextra/O1CN011FkxCc1gCb4jaQfos!!3418834106.jpg",
"promotion_price": "26.80",
"price": "26.80",
"num_iid": "675462541686",
"is_tmall": "false",
"area": "重庆",
"detail_url": "//item.taobao.com/item.htm?id=675462541686"
},
{
"title": "3双岩也中筒长袜子男生运动篮球实战透气速干健身白色毛巾底潮ins",
"picurl": "https://img.alicdn.com/imgextra/O1CN01F2kqlI24WnU7roHZk!!2912737399.jpg",
"promotion_price": "39.90",
"price": "39.90",
"num_iid": "839482989746",
"is_tmall": "false",
"area": "佛山",
"detail_url": "//item.taobao.com/item.htm?id=839482989746"
},
{
"title": "Uponey篮球袜男美式毛巾底透气精英中筒防滑训练长筒实战运动袜子",
"picurl": "https://img.alicdn.com/imgextra/O1CN015m6htf1pYt3Jt5mkM!!552855373.jpg",
"promotion_price": "29.00",
"price": "29.00",
"num_iid": "750145478658",
"is_tmall": "false",
"area": "青岛",
"detail_url": "//item.taobao.com/item.htm?id=750145478658"
},
{
"title": "HG篮球袜男高帮中筒毛巾底实战长筒精袜专业运动袜子闪袭系列",
"picurl": "https://img.alicdn.com/imgextra/O1CN01r1zqmE1pYskTiE3jM!!552855373.jpg",
"promotion_price": "21.00",
"price": "21.00",
"num_iid": "653241419632",
"is_tmall": "false",
"area": "青岛",
"detail_url": "//item.taobao.com/item.htm?id=653241419632"
},
{
"title": "李宁运动袜子男士吸汗透气跑步篮球袜防嗅抗菌女短中筒精硫棉夏季",
"picurl": "https://img.alicdn.com/imgextra/O1CN01kkCB3k1erF6BlXQTK!!3851683924.jpg",
"promotion_price": "29.00",
"price": "29.00",
"num_iid": "775037189585",
"is_tmall": "false",
"area": "南京",
"detail_url": "//item.taobao.com/item.htm?id=775037189585"
},
{
"title": "跨境篮球袜男款专业加厚毛巾底防滑吸汗中筒袜精英袜高帮运动袜子",
"picurl": "https://img.alicdn.com/imgextra/O1CN01ACnac92NPRpb7Fo48!!0-item_pic.jpg",
"promotion_price": "52.32",
"price": "52.32",
"num_iid": "845586474670",
"is_tmall": "false",
"area": "石家庄",
"detail_url": "//item.taobao.com/item.htm?id=845586474670"
},
{
"title": "实战专业篮球毛巾加厚运动精英袜中筒男中筒防滑高帮训练透气长筒",
"picurl": "https://img.alicdn.com/imgextra/O1CN01GwZNBO229Ju9OFIRW!!2341307077.jpg",
"promotion_price": "10.80",
"price": "10.80",
"num_iid": "783158595757",
"is_tmall": "false",
"area": "广州",
"detail_url": "//item.taobao.com/item.htm?id=783158595757"
},
{
"title": "袜子女春夏秋季女士毛巾底中筒袜吸湿透气纯棉运动篮球袜短袜女袜",
"picurl": "https://img.alicdn.com/imgextra/O1CN01RS0usy1KaUArb2hZI!!1674221180.jpg",
"promotion_price": "2.88",
"price": "2.88",
"num_iid": "705555992925",
"is_tmall": "false",
"area": "石家庄",
"detail_url": "//item.taobao.com/item.htm?id=705555992925"
},
{
"title": "有志者UZIS实战训练篮球袜男专业防滑中长筒网眼透气运动袜斗牛士",
"picurl": "https://img.alicdn.com/imgextra/O1CN01aqkEh524wu0B8wfWN!!2207237977456.jpg",
"promotion_price": "23.00",
"price": "23.00",
"num_iid": "773859448281",
"is_tmall": "false",
"area": "长沙",
"detail_url": "//item.taobao.com/item.htm?id=773859448281"
}
],
"page_size": 20,
"page": 1,
"_ddf": "cdy"
},
"error_code": "0000",
"reason": "ok",
"secache": "805dd061d51a733c7a85711ba0a36267",
"secache_time": 1729492509,
"secache_date": "2024-10-21 14:35:09",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:83 max:10000 all[3190=83+38+3069];expires:2030-10-30",
"execution_time": "2.298",
"server_time": "Beijing/2024-10-21 14:35:09",
"client_ip": "61.131.237.50",
"callargs": {
"imgid": "http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT!!2200811456689.jpg"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "",
"server_memory": "4.35MB",
"request_id": "gw-1.6715f61ad53ba",
"last_id": "3628194757"
}
注意事项：
遵守 API 的使用规则，注意调用频率限制，避免过度请求导致 API 访问被限制。
确保上传的图片质量和清晰度，以提高搜索的准确率。
对于涉及用户隐私和数据安全的问题，需要格外关注，确保在使用 API 的过程中符合相关法规要求。
及时关注平台更新和 API 文档变化，确保接口的稳定性和可用性。
