维易淘宝客API接口中,超级搜索super搜索返回值字段的含义

时间:2022-03-02 34319 主题:淘客超级搜索
导读《维易淘宝客API接口中,超级搜索super搜索返回值字段的含义》要点:维易淘宝客API接口中的超级搜索接口super,即可以做为高佣转链使用,又可以搜索关键字查询产品

维易淘宝客API接口中的超级搜索接口super,即可以做为高佣转链使用,又可以搜索关键字查询产品。

【super接口文档】


把super做为高佣API就不说了,可以查看上面文档。这里主要介绍做关键字搜索时的字段含义:

使用场景:

当顾客打开你的APP、小程序、网站或公众号等淘宝客程序时,想找一些产品,比如女装,这时需要展示符合条件的女装产品列表,这时就可以使用super接口,只要把接收到的关键字转给super超级搜索接口就行(要去掉你的程序设定的一些命令,比如微信机器会设定“找女装”,就要去掉“找”字,因为这个是你程序的搜索启动命令,并非产品关键字)。

调用的接口也是很简单:

http://apis.vephp.com/super?vekey=你的vekey&para=女装


当维易超级搜索API接口找到搜索结果后,它输出以下字段:


维易淘宝客API接口中,超级搜索super搜索返回值字段的含义



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。

转载请注明本页网址:https://www.veapi.cn/taokelianmeng/201.html
阅读排行

淘宝联盟订单查询接口的子订单号和父订单号是什么区别?怎样区分每个订单

但是如果没处理好,可能会导致重复计算或其它错误,在使用维易淘客API的订单查询接口时,其中有子订单号和父订单号,这两个可以做为区分,子订单号和父订单号的意义是
2024-04-26
淘客/抖客/多多进宝专题

暂无淘宝客专题教程


在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部