当前位置:淘客联盟接口开发文档(旧版) > 找同款相似推荐
接口文档

淘宝联盟找同款、高相似推荐、榜单宝贝接口(淘客产品)

迁移提示这是 旧版 文档, 最新文档请点击这里查看

淘宝客找同款是一个有很高实用价值、帮助您转化的一个接口,此API用于用户查找某个商品ID时,你可以找出该商品更多的同款或高相似的商品,以及相似的榜单产品推荐给客户。

经内部测试是一个可以有效提升您的成交转化的接口。


找同款接口是基于SPU级别(指商品类型级别,高相似或相同主图)的同款,接口有三种功能:

1、找同款推荐(高相似主图)

2、相似宝贝推荐(高相似主图)

3、榜单推荐


接口自带高佣转链功能。


两个找同款接口区别:

本接口和另一个以图片找同款接口 picsimilaritem(http://wsd.591hufu.com/doc/tupiansoutongkuanshangpin  )有所不同。

same_items 找同款: 是根据您提供的一个产品id,找主图相同或相似的同款。

picsimilaritem 找同款:是根据您提供的一个产品图片(通常是产品主图),找出淘宝天猫上同款的淘客商品。

两个接口均针对淘宝客产品,不包含无佣金的商品。



一、淘宝客找同款接口说明:


单品推荐物料

DEMO

API介绍

同款宝贝接口

根据入参提供的商品id,查询同款宝贝接口。


返回同款商品信息:

  1. 同款:SPU级别的同款,商品主图基本能看出商品完全相同。

  2. 数量:0-10个,0表示没有查到同款宝贝。

  3. 排序:根据宝贝30天销量、与主宝贝价格差等指标综合排序。

  4. 主要字段:标题、主图、券后价、在售价(券前价)、券、佣金率、卖家类型、30天销量、高效转链URL

相似宝贝接口

根据入参提供的商品id,查询相似宝贝接口。


返回同款商品信息:

  1. 相似:SPU级别的相似宝贝。

  2. 数量:0-10个,0表示没有查到相似宝贝。

  3. 排序:根据宝贝相似程度、30天销量、点击率等指标综合分排序。

  4. 主要字段:标题、主图、券后价、在售价(券前价)、券、佣金率、卖家类型、30天销量、高效转链URL

榜单宝贝接口

根据入参提供的商品id,查询榜单宝贝接口。


返回该商品所属叶子类目榜单TOP20商品信息:

  1. 榜单商品:同叶子类目榜单TOP20商品

  2. 数量:0表示没有榜单商品,20表示返回20个榜单商品

  3. 排序:返回顺序按照榜单编号,按顺序显示 TOP1- TOP20

  4. 主要字段:标题、主图、券后价、在售价(券前价)、热卖销量、券、佣金率、卖家类型、30天销量、高效转链URL


二、找同款API接口使用文档


【使用权限】核心接口会员卡。

【特别注意】请使用的会员在应用中做一下埋点,我们这边可以结合接口成交数据查看转化效率,埋点保存的数据主要为:

(1)展示找同款商品的页面的曝光pv/uv,

(2)主商品(即接口参数中的item_id指定产品)复制口令按钮的点击pv/uv,

(3)推荐商品复制口令按钮的点击pv/uv


【API使用】按以下API地址传参,POST或GET均可

http://api.veapi.cn/tbk/tbk/same_items?vekey=x&item_id=123456&&res_type=1&pid=mm_111_222_333


【参数说明】

字段名称

是否必传

描述

item_id

主区商品ID,用于做商品相关的推荐

pid

mm_xxx_xxx_xxx

res_type

可选值:1-同款推荐(默认);2-相似推荐;3-榜单推荐

page_no

页码数,默认1

page_size

每页产品数,默认10


【返回值说明】

淘宝找同款/相似推荐商品接口响应值分成几部分,结构如下:

结构类别名称类型 描述
item_basic_info String 商品基本信息
promotion_info String 商品的权益信息,例如优惠券、推广链接等
activity_info String 商品所属活动类信息,例如榜单等
publish_info String 商品的淘客推广信息
shop_info String 商品的店铺信息
is_default String 推荐信息-是否抄底


返回值每个类别下字段说明如下:


(1)item_basic_info 商品的基本信息:

子类字段名

描述

item_id

此字段为虚拟的商品id,仅供内部使用,非真实商品ID

user_type

店铺信息-卖家类型,0表示淘宝,1表示天猫,3表示特价版

title

商品标题

volume

商品的30天销量

pict_url

商品的图片

zk_final_price

商品信息-在线售卖价(元)。若属于预售商品,付定金时间内,在线售卖价=预售价

reserve_price

商品信息-一口价通常显示为划线价

benefit

商品的利益点信息,如商务杯 企业私人定制 支持刻字
item_url高佣推广链接


(2)promotion_info 商品的权益信息,例如优惠券、推广链接等:

coupon_amount

优惠券信息-优惠券(元)

coupon_start_fee

优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元

price_after_coupon

商品的券后价(单位元)


(3)activity_info 商品所属活动类信息:

rank_realtime_trade

榜单实时日销量


(4)publish_info 商品的淘客推广信息:


commission_rate

商品的佣金比率(单位%)

click_url

商品的推广链接(

有券为uland链接,无券为sclick链接),和上面的item_url是一样的

fl_price

媒体营销金额(元)


【注意】

1、click_url和item_url链接是一样的,都是高佣转链生成的链接,您不需要再调用一次高佣转链。您可以直接用该链接让客户下单。

2、返回值中item_id并非该商品在淘宝的真实商品ID,它仅供内部数据统计需要,您如果需要商品ID,可以使用本站的dec接口从click_url提取商品信息。



三、接口错误码:

返回值结构:

{

    "error": "15",

    "msg": "无结果",

}


其它错误码请参考 http://wsd.591hufu.com/doc/taobaokeapijiekoucuowuma 



四、找同款落地页设计稿下载:

这里有一份APP或H5落地页设计稿,您可以直接使用或参考。

下载:

链接:https://pan.baidu.com/s/10qKMPXw94uAhslgSi1s4qw?pwd=860t 

提取码:860t

效果展示

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部