本文为您介绍SearchByPic接口的语法及示例,用于向淘宝联盟版在线调用。
使用说明
本接口用于向淘宝联盟版在线调用。
QPS限制
查询操作默认5QPS。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | SearchByPic | 系统规定参数。取值:SearchByPic。 |
PicContent | String | 是 | xxx | 图片内容。
|
CategoryId | Integer | 否 | 88888888 | 图片类目。具体请参考类目参考。 如果设置类目,则以设置的为准;如果不设置类目,则由系统进行类目预测,预测的类目结果可以在Response中获取 。 |
Pid | String | 否 | mm_xxx_xxx_xxx | PID。具体请参考PID。 使用V1.1.0及以上版本的SDK可用该字段。 |
UserType | Long | 否 | 0 | 卖家类型。
|
Crop | Boolean | 否 | true | 是否需要进行主体识别。默认true。
|
Region | String | 否 | 280,486,232,351 | 图片的主体区域,格式为 若用户设置了Region,则不论Crop参数为何值,都将以用户输入Region进行搜索。 |
Start | Integer | 否 | 0 | 返回结果的起始位置。取值范围:0~499。默认值为0。 |
Num | Integer | 否 | 10 | 返回结果的数目。取值范围:1~20。默认值为10。 |
Fields | String | 否 | Url,UserType | 需要返回的字段list。不同的字段用逗号分割。默认PicUrl,ReservePrice,Title,Url,ZkFinalPrice字段必返回。 |
RelationId | Long | 否 | 1125526 | 渠道ID。用于淘宝联盟中的渠道区分。 |
返回数据
示例
请求示例
{
"picContent": "${Base64ImageContent}",
"pid":"mm_xxx_xxx_xxx"
}
正常返回示例
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"code" : 0,
"data" : {
"auctions" : [ {
"rankScore" : 0.9877,
"result" : {
"itemId" : "22222",
"shortTitle" : "xxx套装",
"subTitle" : "xxx套装",
"categoryName" : "USB风扇",
"commissionRate" : "90",
"couponAmount" : 2,
"couponEndTime" : "2021-08-31",
"couponInfo" : "满15.0元减2.0元",
"couponRemainCount" : 72287,
"couponShareUrl" : "//uland.taobao.com/coupon/edetail?xxx",
"couponStartFee" : "15.000000",
"couponStartTime" : "2021-07-06",
"couponTotalCount" : "100000",
"levelOneCategoryName" : "3C数码配件",
"maxCommission" : {
"maxCommissionClickUrl" : "https://s.click.taobao.com/txxxx",
"maxCommissionCouponShareUrl" : "https://uland.taobao.com/xxxxx",
"maxCommissionRate" : "0.90"
},
"nick" : "urkazf旗舰店",
"picUrl" : "//img.alicdn.com/pic.jpg",
"provcity" : "广东 深圳",
"reservePrice" : "65.8",
"sellerId" : "2207366944297",
"shopTitle" : "urkazf旗舰店",
"title" : "【官方推荐】电风扇",
"url" : "//s.click.taobao.com/t?xxx",
"userType" : 1,
"volume" : 12515,
"zkFinalPrice" : "15.8",
"priceAfterCoupon" : "12.8",
"DeeplinkUrl" : "tbopen://m.taobao.com/tbopen/index.html?",
"DeeplinkCouponShareUrl" : "tbopen://m.taobao.com/tbopen/index.html?"
}
} ]
},
"picInfo" : {
"mainRegion" : {
"multiCategoryId" : [ {
"categoryId" : 88888888,
"score" : 0.79521
}, {
"categoryId" : 22,
"score" : 0.13365
}, {
"categoryId" : 9,
"score" : 0.00778
}, {
"categoryId" : 7,
"score" : 0.00685
} ],
"region" : "428,750,64,739"
},
"multiRegion" : [ {
"region" : "428,750,64,739"
}, {
"region" : "428,750,64,739"
} ]
},
"requestId" : "xx-FDF7-xxx-A794-xxx",
"success" : true
}
错误码
请参见错误码。
该文章对您有帮助吗?
- 本页导读 (1)
- 使用说明
- QPS限制
- 调试
- 请求参数
- 返回数据
- 示例
- 错误码