淘宝客找同款是一个有很高实用价值、帮助您转化的一个接口,此API用于用户查找某个商品ID时,你可以找出该商品更多的同款或高相似的商品,以及相似的榜单产品推荐给客户。
经内部测试是一个可以有效提升您的成交转化的接口。
找同款接口是基于SPU级别(指商品类型级别,高相似或相同主图)的同款,接口有三种功能:
1、找同款推荐(高相似主图)
2、相似宝贝推荐(高相似主图)
3、榜单推荐
接口自带高佣转链功能。
本接口和另一个以图片找同款接口 picsimilaritem(http://wsd.591hufu.com/doc/tupiansoutongkuanshangpin )有所不同。
same_items 找同款: 是根据您提供的一个产品id,找主图相同或相似的同款。
picsimilaritem 找同款:是根据您提供的一个产品图片(通常是产品主图),找出淘宝天猫上同款的淘客商品。
两个接口均针对淘宝客产品,不包含无佣金的商品。
单品推荐物料 | DEMO | API介绍 |
同款宝贝接口 | 根据入参提供的商品id,查询同款宝贝接口。 返回同款商品信息:
| |
相似宝贝接口 | 根据入参提供的商品id,查询相似宝贝接口。 返回同款商品信息:
| |
榜单宝贝接口 | 根据入参提供的商品id,查询榜单宝贝接口。 返回该商品所属叶子类目榜单TOP20商品信息:
|
【使用权限】核心接口会员卡。
【特别注意】请使用的会员在应用中做一下埋点,我们这边可以结合接口成交数据查看转化效率,埋点保存的数据主要为:
(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
效果展示