本接口功能是以一张图片搜索相似款产品,这些产品均为淘宝联盟的商品,无有佣金。并且根据您的pid直接转链,无需授权。佣金为高佣。
本接口picsimilaritem和另一个找同款商品接口same_items(http://wsd.591hufu.com/doc/zhaotongkuanxiangsituijian )有所不同:
same_items找同款: 是根据您提供的一个产品id,找主图相同或相似的同款。
picsimilaritem找同款:是根据您提供的一个产品图片(通常是产品主图),找出淘宝天猫上同款的淘客商品。
两个接口均针对淘宝客产品,不包含无佣金的商品。
以图找同款接口特色:
相似产品推荐:以图像搜索技术为基础,通过淘宝联盟商品库实现快速提供相似商品推荐的功能。
淘客自动转链:可将淘宝联盟推荐商品自动转换为与您淘宝联盟账号匹配的淘客链接,通过淘客链接可对已有流量进行变现,享受返佣。
优惠信息关联:如果淘宝联盟推荐商品包含优惠券信息,可实现优惠券自动关联和发放,提升转化率。
可用于手机厂商、综合电商、垂直类电商的拍照购物场景,以及新闻APP、相册APP、内容电商APP等商品推荐的场景。
【使用权限】目前核心接口会员卡可用,后期成本如有变动,可能会改成专用卡单独收费。到时另行通知。
【调用方式】post 或 get
【转链说明】接口返回值可以直接转链,无需提供sessionkey和授权,但需事先提供你的pid备案,通常需要1-2天备案。通过后即可调用。当然,不备案也可以使用本接口,用于查询同款商品信息,后续您自己根据itemId等值再进行转链生成淘客推广链接亦可。
【接口地址】
http://api.veapi.cn/tbk/tbk/picsimilaritem?vekey=xxx&pid=mm_1111_2222_3333&pic=https%3A......jpg
【参数说明】
vekey 必须,本站接口密钥,从会员中心
pic 必须,你要找同款或近似款的商品图片,支持格式有png,jpg,jpeg,bmp,gif,webp。可以是http开始的图片网络地址,也可以是post提交的base64编码的图片内容。
图片像素分辨率必须介于100-4000之间,最大不要超过2M。推荐你自己本地服务器上的图片url地址。
pid 可选,您的推广位,完整字段如mm_1111_222_3333,直接用于生成高佣转链,如果不提供pid参数则只返回无推广链接的信息。如果提供pid参数,则该Pid必须时备案过的。请联系客服 。
relationId 可选:您的淘客渠道ID
page 可选,页码,默认1
pageSize 可选,每页返回值,默认10,最大20.推荐使用默认值
region 可选,您自己选中的图片区域,格式为x1,x2,y1,y2
, 其中x1,y1
是左上角的点,x2,y2
是右下角的点。如90,316,156,506,比如现在有一些应用在一张图片上切出多个区域,分别推荐图中的衣服,手提包,拉杆箱等等。
fields 可选,当您不需要返回那么多字段时,可以指定哪些字段返回。默认PicUrl,ReservePrice,Title,Url,ZkFinalPrice字段必返回。
例:把vekey换成你自己的即可在浏览器URL中查看
http://api.veapi.cn/tbk/tbk/picsimilaritem?vekey=xxxx&pic=https%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fhttps%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi4%2F2354641172%2FO1CN01lW5ho91KWosoEOtgw_%21%212354641172.jpg_430x430q90.jpg
返回值如下图:
字段含义说明:
返回字段名 | 类型 | 含义 |
RankScore | String | 商品相似性的排名分数。取值范围:0~1。 |
ItemId | String | 商品ID。 |
Title | String | 商品信息-商品标题。 |
ShortTitle | String | 商品信息-商品短标题(移动端建议使用)。 |
SubTitle | String | 商品信息-商品子标题。 |
PicUrl | String | 商品信息-商品主图。 |
ReservePrice | String | 商品信息-一口价通常显示为划线价。 |
ZkFinalPrice | String | 商品信息-在线售价(元)。若属于预售商品,付定金时间内,在线售卖价=预售价格。 |
PriceAfterCoupon | String | 商品信息-券后价。 |
UserType | Integer | 店铺信息-卖家类型。0淘宝,1天猫,3淘特 |
Provcity | String | 商品信息-宝贝所在地。 |
Nick | String | 店铺信息-卖家昵称。 |
SellerId | String | 店铺信息-卖家ID。 |
Volume | Integer | 商品信息-30天销量。 |
LevelOneCategoryName | String | 商品信息-叶子类目名称。 |
CategoryName | String | 商品信息-一级类目名称。 |
CouponTotalCount | String | 优惠券信息-优惠券总量。 |
CouponRemainCount | Integer | 优惠券信息-优惠券剩余量。 |
CouponStartTime | String | 优惠券信息-优惠券开始时间。 |
CouponEndTime | String | 优惠券信息-优惠券结束时间。 |
CouponStartFee | String | 优惠券信息-优惠券启用门槛,如:满299元减20元。 |
CouponAmount | Integer | 优惠券(元)若属于预售商品,该优惠券付尾款可用,付定金不可用。 |
CouponInfo | String | 优惠券信息-优惠券满减信息。 |
CommissionRate | String | 商品信息-佣金比率。如:1550表示15.5%。 |
CouponShareUrl | String | 链接-宝贝+券二合一页面链接。 |
DeeplinkCouponShareUrl | String | 优惠券-手淘唤醒链接。tbopen://m. |
Url | String | 链接-宝贝推广链接。 |
DeeplinkUrl | String | 链接-宝贝推广的深度唤醒链接。 |
ShopTitle | String | 店铺信息-店铺名称。 |
MaxCommission | Object | 商品信息-高佣信息。 |