本接口主要用于批量查询商品信息,以及检测是否为淘客商品或下架。
http://api.veapi.cn/tbk/getitems?vekey=xxx&ids=651196798743,646724659836,650353754885
参数:
ids 参数:必选,你要检测的批量商品ID列表,用英文逗号相连。如 646724659836,650353754885,一次最大40个ID。
如果是字符型ID,则支持B段入参数,或A-B全段字符型ID入参。如:
(1) B段ID入参:krVR92U8kAGPDqvT5,BVORbxsrv3jZYn2HD6
(2)A-B段完整ID入参:5mmRxkntxt0G74DC0OWHYCV-krVR92U8kAGPDqvT5,4DDqWdyigtYWnr7tQPxtQCg-BVORbxsrv3jZYn2HD6
(3)数字ID入参:646724659836,650353754885
【id入参特别提示】
请不要把上述三种类型的ID混合在一起入参,混合式的ID参数只能查询第一个ID代表的格式,比如第一个是数字ID,则全部入参中的数字ID会被查询到,而字符ID会查询失败。
比如:ids=BVORbxsrv3jZYn2HD6,652100129322,第一个是字符型ID的B段,则只能查询入参ID中的所有B段IDBVORbxsrv3jZYn2HD6,反过来ids=652100129322,BVORbxsrv3jZYn2HD6 只能查询到652100129322等所有数字ID
接口返回值如下图:
字段含义如下:
erro : 出错时error不为0
msg:提示字段
id_count : 总共查询的ID数,是去掉重复的ID数后的数
success : 成功数
fail : 失败数,fail+success=id_count
fail_ids : 如果有失败的ID,则在这里输出,这些ID是下架的或非淘客的商品ID。如果没有失败ID,则本字段为空。
返回的产品字段参数:
cat_leaf_name 叶子类目名称
cat_name 一级类目名称
free_shipment 是否包邮
hot_flag 是否是热门商品,0不是,1是
item_url 商品链接
ju_online_end_time 聚划算信息-聚淘结束时间(毫秒)
ju_online_start_time 聚划算信息-聚淘开始时间(毫秒)
ju_pre_show_end_time 聚划算信息-商品预热结束时间(毫秒)
ju_pre_show_start_time 聚划算信息-商品预热开始时间(毫秒)
material_lib_type 商品库类型,支持多库类型输出,以英文逗号分隔“,”分隔,1:营销商品主推库,如果值为空则不属于1这种商品类型
nick 店铺名称
num_iid 商品ID
pict_url 主图
presale_deposit 预售商品-定金(元)
presale_end_time 预售商品-付定金结束时间(毫秒)
presale_start_time 预售商品-付定金开始时间(毫秒)
presale_tail_end_time 预售商品-付定金结束时间(毫秒)
presale_tail_start_time 预售商品-付尾款开始时间(毫秒)
provcity 商品所在地
reserve_price 商品一口价格
seller_id 卖家id
small_images 商品小图列表
superior_brand 是否品牌精选,0不是,1是
title 商品标题
tmall_play_activity_end_time 天猫限时抢可售 -结束时间(毫秒)
tmall_play_activity_start_time 天猫限时抢可售 -开始时间(毫秒)
user_type 卖家类型,0表示集市,1表示商城,3表示特价版
volume 30天销量
zk_final_price 折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价