维易淘宝客API接口中的超级搜索接口super,即可以做为高佣转链使用,又可以搜索关键字查询产品。
把super做为高佣API就不说了,可以查看上面文档。这里主要介绍做关键字搜索时的字段含义:
使用场景:
当顾客打开你的APP、小程序、网站或公众号等淘宝客程序时,想找一些产品,比如女装,这时需要展示符合条件的女装产品列表,这时就可以使用super接口,只要把接收到的关键字转给super超级搜索接口就行(要去掉你的程序设定的一些命令,比如微信机器会设定“找女装”,就要去掉“找”字,因为这个是你程序的搜索启动命令,并非产品关键字)。
调用的接口也是很简单:
http://apis.vephp.com/super?vekey=你的vekey¶=女装
当维易超级搜索API接口找到搜索结果后,它输出以下字段:
error和msg字段: 当有返回值时,error为0,msg是成功注释。当error不为0时,表示失败或没有找到值。
search_type 字段: 值为1表示接口使用了搜索产品关键字功能,2表示接口使用了转链功能。
result_list 字段含义:
重要说明:
(1)字段commission_rate:产品佣金,要除100表示百分比,比如5000表示50%,可以用它来在列表页给顾客一个预估返现。
(2)几个优惠券字段,比如coupon_info,可以做为您判断优惠券信息使用,如无此字段或为空,则表示无券有佣金。
(3)zk_final_price 是商品折扣价格,就是产品在淘宝上折后价,你的程序的“券后价”是用此值减优惠券金额得到的。
(4)优惠券面额从coupon_info中提取,格式固定是"满xx元减yy元"
"category_id": "50012036", 类目ID
"commission_rate" => 5000 佣金(5000表示50%,即除以100)
"coupon_end_time" => 2018-07-15 优惠券结束时间,如无此字段则表示没有优惠券
"coupon_info" => 满21.00元减15元 优惠券信息,如无此字段则表示没有优惠券
"coupon_remain_count" => 29100 优惠券余量,如无此字段则表示没有优惠券
"coupon_start_time" => 2018-07-13 优惠券开始时间,如无此字段则表示没有优惠券
"coupon_total_count" => 30000 优惠券总量,如无此字段则表示没有优惠券
"item_url" => https://item.ta...?id=543574320825 产品地址
"num_iid" => 543574320825 产品ID
"pict_url" => https://img.alicdn.com...-item_pic.jpg 产品主图
"provcity" => 上海 卖家地址
"reserve_price" => 58 原价(未打折前原始标价,不是券前价哦)
"seller_id" => 2112920217 卖家ID
"shop_dsr" => 48354 店铺DSR评分
"shop_title" => 九州树叶旗舰店 卖家昵称
"small_images" => 其它主图,有时也没有其它主图,因此需要判断
(
"0" => https://img.alicdn.com/...12920217.jpg
"1" => ...
)
"title" => 荷叶茶冬瓜荷...天然决明正品子 产品标题
"tk_total_commi" => 647960 月支出佣金
"tk_total_sales" => 86240 淘客30天月推广量
"user_type" => 1 卖家类型,0表示淘宝产品,1表示天猫商城
"volume" => 159777 30天销量
"zk_final_price" => 21.9 商品折后价(券前价,就是产品在淘宝上折后价,你的程序的“券后价”是用此值减优惠券金额得到的)
完整如下:
coupon_start_time 优惠券信息-优惠券开始时间
coupon_end_time 优惠券信息-优惠券结束时间
info_dxjh 商品信息-定向计划信息
tk_total_sales 商品信息-淘客30天推广量
tk_total_commi 商品信息-月支出佣金(该字段废弃,请勿再用)
coupon_id 优惠券信息-优惠券id
num_iid 商品信息-宝贝id(该字段废弃,请勿再用)
title 商品信息-商品标题
pict_url 商品信息-商品主图
small_images 商品信息-商品小图列表
reserve_price 商品信息-商品一口价格
zk_final_price 折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价
user_type 店铺信息-卖家类型。0表示集市,1表示天猫
provcity 商品信息-宝贝所在地
item_url 链接-宝贝地址
include_mkt 商品信息-是否包含营销计划
include_dxjh 商品信息-是否包含定向计划
commission_rate 商品信息-佣金比率。1550表示15.5%
volume 商品信息-30天销量(饿了么卡券信息-总销量)
seller_id 店铺信息-卖家id
shop_title 店铺信息-店铺名称
coupon_total_count 优惠券信息-优惠券总量
coupon_remain_count 优惠券信息-优惠券剩余量
coupon_info 优惠券信息-优惠券满减信息
commission_type MKT表示营销计划,SP表示定向计划,COMMON表示通用计划 商品信息-佣金类型。MKT表示营销计划,SP表示定向计划,COMMON表示通用计划
shop_dsr 店铺信息-店铺dsr评分
coupon_share_url 链接-宝贝+券二合一页面链接
url 链接-宝贝推广链接
level_one_category_name 商品信息-一级类目名称
level_one_category_id 商品信息-一级类目ID
category_name 商品信息-叶子类目名称
category_id 商品信息-叶子类目id
short_title 商品信息-商品短标题
white_image 商品信息-商品白底图
oetime 拼团专用-拼团结束时间
ostime 拼团专用-拼团开始时间
jdd_num 拼团专用-拼团几人团
jdd_price 拼团专用-拼团拼成价,单位元
uv_sum_pre_sale 预售专用-预售数量
x_id 链接-物料块id(测试中请勿使用)
coupon_start_fee 优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元
coupon_amount 优惠券(元) 若属于预售商品,该优惠券付尾款可用,付定金不可用
item_description 季凉被 全棉亲肤 商品信息-宝贝描述(推荐理由)
nick 店铺信息-卖家昵称
orig_price 拼团专用-拼团一人价(原价),单位元
total_stock 拼团专用-拼团库存数量
sell_num 拼团专用-拼团已售数量
stock 拼团专用-拼团剩余库存
tmall_play_activity_info 营销-天猫营销玩法
item_id Number 商品信息-宝贝id
real_post_fee 商品邮费
【双11参数——仅双11大促时有】
lock_rate 锁住的佣金率
lock_rate_end_time 锁佣结束时间
lock_rate_start_time 锁佣开始时间
presale_discount_fee_text 预售商品-优惠
presale_tail_end_time 预售商品-付尾款结束时间(毫秒)
presale_tail_start_time 预售商品-付尾款开始时间(毫秒)
presale_end_time 预售商品-付定金结束时间(毫秒)
presale_start_time 预售商品-付定金开始时间(毫秒)
presale_deposit 预售商品-定金(元)
ysyl_tlj_send_time 预售有礼-淘礼金发放时间
ysyl_commission_rate 预售有礼-佣金比例( 预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 )
ysyl_tlj_face 预售有礼-预估淘礼金(元)
ysyl_click_url 预售有礼-推广链接
ysyl_tlj_use_end_time 预售有礼-淘礼金使用结束时间
ysyl_tlj_use_start_time 预售有礼-淘礼金使用开始时间
sale_begin_time 本地化-销售开始时间
sale_end_time 本地化-销售结束时间
distance 本地化-到门店距离(米)
usable_shop_id 本地化-可用店铺id
usable_shop_name 本地化-可用店铺名称
sale_price 活动价
kuadian_promotion_info 跨店满减信息
superior_brand 是否品牌精选,0不是,1是
reward_info 比价场景专用,当系统检测到入参消费者ID购买当前商品会获得《天天开彩蛋》玩法的彩蛋时,该字段显示1,否则为0
is_brand_flash_sale 是否品牌快抢,0不是,1是
order_lead_time 本地化-配送时间
user_rating 本地化-用户评分
delivery_min_price 本地化-起送价
delivery_fee 本地化-配送费
original_delivery_fee 本地化-配送费原价
delivery_type 本地化-配送类型;0:蜂鸟专送 1:蜂鸟快送 2:商家自配 3: 全城送
recommend_reasons 本地化-推荐理由
sale_tags 本地化-营销标签
ood_pic 本地化-商品图片
food_title 本地化-商品标题
food_promotion_price 本地化-商品促销价
food_reserve_price 本地化-商品原价
match_score 物料评估-匹配分
commi_score 物料评估-收益分
hot_flag 是否是热门商品,0不是,1是
topn_quantity 前N件剩余库存
topn_total_count 前N件初始总库存
topn_end_time 前N件佣金结束时间
topn_start_time 前N件佣金开始时间
topn_rate 前N件佣金率
bybt_brand_logo 百亿补贴品牌logo
bybt_pic_url 百亿补贴白底图
bybt_item_tags 百亿补贴商品特征标签,eg.今日发货、晚发补偿、限购一件等
bybt_coupon_amount 百亿补贴专属券面额,仅限百亿补贴场景透出
bybt_show_price 百亿补贴页面实时价
bybt_lowest_price 全网对比参考价格
bybt_end_time 商品的百亿补贴开始时间
bybt_start_time 商品的百亿补贴结束时间
tt_sold_count 商品入驻淘特后产生的所有销量量级,不特指某段具体时间
maifan_promotion_end_time 猫超买返卡活动结束时间
maifan_promotion_start_time 猫超买返卡活动开始时间
maifan_promotion_discount 猫超买返卡面额
maifan_promotion_condition 猫超买返卡总数,-1代表不限量,其他大于等于0的值为总数
cpa_reward_type 额外奖励活动类型,如果一个商品有多个奖励类型,返回结果使用空格分割,0=单单奖励(已失效),1=超级单单奖励(已失效),2=年货节单单奖励
cpa_reward_amount 额外奖励活动金额,活动奖励金额的类型与cpa_reward_type字段对应,如果一个商品有多个奖励类型,返回结果使用空格分割
activity_id 合作伙伴单单补ID,用作“年货节超级单单补”活动合作伙伴奖励统计依据
page_result_key 本地化-lbs分页标识,请在下一次翻页时作为入参传入
希望对您有帮助。如有其它需求可联系维易接口API。