Hidove Api
用户中心 color_lens
keyboard_voice
语音合成
image
图床API
library_music
音乐解析

接口名称: 通用物料搜索API【导购】

创造时间: 2019-09-28 18:32:38

apiUrl: https://api.abcyun.co/api/taobao/dg_material_optional

请求类型: get/post

返回类型: json

请求例子: https://api.abcyun.co/api/taobao/dg_material_optional/token/5d8f31cf6a8ab/?setAdzoneId=12345678

调用次数: 31

最后调用时间: 2020-01-26 20:08:35

说明

请求参数

名称 类型 必须 示例值 描述
setAdzoneId Number true 12345678 mm_xxx_xxx_12345678三段式的最后一段数字
setQ String false 女装 商品筛选-查询词
setCat String false 16,18 商品筛选-后台类目ID。用,分割,最大10个,该ID可以通过taobao.itemcats.get接口获取到
setStartDsr Number false 10 商品筛选(特定媒体支持)-店铺dsr评分。筛选大于等于当前设置的店铺dsr评分的商品0-50000之间
setPageSize Number false 20 页大小,默认20,1~100
setPageNo Number false 1 第几页,默认:1
setPlatform Number false 1 链接形式:1:PC,2:无线,默认:1
setEndTkRate Number false 1234 商品筛选-淘客佣金比率上限。如:1234表示12.34%
setStartTkRate Number false 1234 商品筛选-淘客佣金比率下限。如:1234表示12.34%
setEndPrice Number false 10 商品筛选-折扣价范围上限。单位:元
setStartPrice Number false 10 商品筛选-折扣价范围下限。单位:元
setIsOverseas Boolean false false 商品筛选-是否海外商品。true表示属于海外商品,false或不设置表示不限
setIsTmall Boolean false false 商品筛选-是否天猫商品。true表示属于天猫商品,false或不设置表示不限
setSort String false tk_rate_des 排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price)
setItemloc String false 杭州 商品筛选-所在地
setMaterialId Number false 2836 官方的物料Id,不传时默认为2836
setHasCoupon Boolean false false 优惠券筛选-是否有优惠券。true表示该商品有优惠券,false或不设置表示不限
setIp String false 13.2.33.4 ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供
setNeedFreeShipment Boolean false true 商品筛选-是否包邮。true表示包邮,false或不设置表示不限
setNeedPrepay Boolean false true 商品筛选-是否加入消费者保障。true表示加入,false或不设置表示不限
include_pay_rate_30 Boolean false true 商品筛选(特定媒体支持)-成交转化是否高于行业均值。True表示大于等于,false或不设置表示不限
setIncludeGoodRate Boolean false true 商品筛选-好评率是否高于行业均值。True表示大于等于,false或不设置表示不限
setIncludeRfdRate Boolean false true 商品筛选(特定媒体支持)-退款率是否低于行业均值。True表示大于等于,false或不设置表示不限
setNpxLevel Number false 2 商品筛选-牛皮癣程度。取值:1不限,2无,3轻微
setEndKaTkRate Number false 1234 商品筛选-KA媒体淘客佣金比率上限。如:1234表示12.34%
setStartKaTkRate Number false 1234 商品筛选-KA媒体淘客佣金比率下限。如:1234表示12.34%

响应参数

名称 类型 示例值 描述
total_results Number 1212 搜索到符合条件的结果总数
result_list MapData [] resultList
coupon_start_time String 2017-10-29 优惠券信息-优惠券开始时间
coupon_end_time String 2017-10-29 优惠券信息-优惠券结束时间
info_dxjh Json {"19013551":"2850","74510538":"2550"} 商品信息-定向计划信息
tk_total_sales String 11 商品信息-淘客30天推广量
tk_total_commi String 323 商品信息-月支出佣金(该字段废弃,请勿再用)
coupon_id String d62db1ab8d9546b1bf0ff49bda5fc33b 优惠券信息-优惠券id
num_iid Number 556633720749 商品信息-宝贝id(该字段废弃,请勿再用)
title String 毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款 商品信息-商品标题
pict_url String https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg 商品信息-商品主图
small_images String[] https://img.alicdn.com/i4/3077291146/TB2NA3poDnI8KJjSszgXXc8ApXa_!!3077291146.jpg 商品信息-商品小图列表
reserve_price String 102.00 商品信息-商品一口价格
zk_final_price String 88.00 商品信息-商品折扣价格
user_type Number 1 店铺信息-卖家类型。0表示集市,1表示天猫
provcity String 杭州 商品信息-宝贝所在地
item_url String https://item.taobao.com/item.htm?id=564591813536 链接-宝贝地址
include_mkt String false 商品信息-是否包含营销计划
include_dxjh String false 商品信息-是否包含定向计划
commission_rate String 1550表示15.5% 商品信息-佣金比率。1550表示15.5%
volume Number 123 商品信息-30天销量
seller_id Number 232332 店铺信息-卖家id
coupon_total_count Number 22323 优惠券信息-优惠券总量
coupon_remain_count Number 111 优惠券信息-优惠券剩余量
coupon_info String 满299元减20元 优惠券信息-优惠券满减信息
commission_type String MKT表示营销计划,SP表示定向计划,COMMON表示通用计划 商品信息-佣金类型。MKT表示营销计划,SP表示定向计划,COMMON表示通用计划
shop_title String xx旗舰店 店铺信息-店铺名称
shop_dsr Number 13 店铺信息-店铺dsr评分
coupon_share_url String uland.xxx 链接-宝贝+券二合一页面链接
url String s.click.xxx 链接-宝贝推广链接
level_one_category_name String 女装 商品信息-一级类目名称
level_one_category_id Number 20 商品信息-一级类目ID
category_name String 连衣裙 商品信息-叶子类目名称
category_id Number 162201 商品信息-叶子类目id
short_title String xxsd 商品信息-商品短标题
white_image String https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg 商品信息-商品白底图
oetime String 2018-08-21 11:23:43 拼团专用-拼团结束时间
ostime String 2018-08-21 11:23:43 拼团专用-拼团开始时间
jdd_num Number 10 拼团专用-拼团几人团
jdd_price String 5 拼团专用-拼团拼成价,单位元
uv_sum_pre_sale Number 23 预售专用-预售数量
x_id String uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc 链接-物料块id(测试中请勿使用)
coupon_start_fee String 29.00 优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元
coupon_amount String 10.00 优惠券信息-优惠券面额。如:满299元减20元
item_description String 季凉被 全棉亲肤 商品信息-宝贝描述(推荐理由)
nick String 旗舰店 店铺信息-卖家昵称
orig_price String 25 拼团专用-拼团一人价(原价),单位元
total_stock Number 5555 拼团专用-拼团库存数量
sell_num Number 1111 拼团专用-拼团已售数量
stock Number 4444 拼团专用-拼团剩余库存
tmall_play_activity_info String 前n件x折 营销-天猫营销玩法
item_id Number 5678899993 商品信息-宝贝id

返回示例

{
    "result_list":{
        "map_data":[
            {
                "category_id":50010850,
                "category_name":"连衣裙",
                "commission_rate":"1300",
                "commission_type":"MKT",
                "coupon_amount":"20",
                "coupon_end_time":"2019-05-26",
                "coupon_id":"3eb48d3acca7406598529fbb9e3141ae",
                "coupon_info":"满100.00元减20元",
                "coupon_remain_count":100000,
                "coupon_share_url":"//uland.taobao.com/coupon/edetail?e=YueRrl1nFfoNfLV8niU3RwXoB%2BDaBK5LQS0Flu%2FfbSp4QsdWMikAalrisGmre1Id522H2TxuqpLO70GbM27i5ILUiszpxF%2F1bBob79wv3ztIqF%2FwovWb0Vh9ZikglvUVVJP6Pef8rSzKLv7nO9SBvAB57Q2hxpYqkAMwydjxvxPgfoDzsg4Ai7%2F1qAe9vHmrCsTX31Fe8vH%2BO0s7EIRp1dssii%2F7skwC&&app_pvid=59590_11.176.130.186_153663_1558266573177&ptl=floorId:2836;app_pvid:59590_11.176.130.186_153663_1558266573177;tpp_pvid:100_11.14.183.71_4986_5171558266573186178&xId=aRYbDIVBx6Fj0rNVU2VzrkmtNHs9tK9WtqaLf83xb6IseDkHHmcJ16jvUTuHrpoTjT1buNReTkYJXPahateQ2C&union_lens=lensId:0bb082ba_0c5a_16acfecf214_9c2e",
                "coupon_start_fee":"100.00",
                "coupon_start_time":"2019-05-19",
                "coupon_total_count":100000,
                "include_dxjh":"true",
                "include_mkt":"true",
                "info_dxjh":"{"1795883":"975","6477263":"1040"}",
                "item_description":"",
                "item_id":556768394717,
                "item_url":"https://item.taobao.com/item.htm?id=556768394717",
                "level_one_category_id":16,
                "level_one_category_name":"女装/女士精品",
                "nick":"maokinglei",
                "num_iid":556768394717,
                "pict_url":"https://img.alicdn.com/bao/uploaded/i3/50596962/TB2XwJQrCYTBKNjSZKbXXXJ8pXa_!!50596962.jpg",
                "provcity":"浙江 杭州",
                "reserve_price":"242",
                "seller_id":50596962,
                "shop_dsr":48470,
                "shop_title":"花猫女装 花猫家精品女装 高性价比",
                "short_title":"胜过商场货!独家设计春秋碎花雪纺",
                "small_images":{
                    "string":[
                        "https://img.alicdn.com/i3/50596962/TB18UnuSFXXXXaRXVXXXXXXXXXX_!!0-item_pic.jpg",
                        "https://img.alicdn.com/i3/50596962/TB2JkJuX.afF1Jjy1XbXXaYiXXa_!!50596962.jpg",
                        "https://img.alicdn.com/i3/50596962/TB2qadsX5GfF1Jjy0FjXXXZdVXa_!!50596962.jpg",
                        "https://img.alicdn.com/i1/50596962/TB2czAAam.EF1JjSZPcXXaxaFXa_!!50596962.jpg"
                    ]
                },
                "title":"胜过商场货!独家设计!春秋碎花雪纺长袖连衣裙女长款女神裙子夏",
                "tk_total_commi":"8421.47",
                "tk_total_sales":"288",
                "url":"//s.click.taobao.com/t?e=m%3D2%26s%3Dv%2FOH1XWJ3%2F8cQipKwQzePOeEDrYVVa64lwnaF1WLQxlyINtkUhsv0KXGYS2dcWMt%2BJ2KrlVamBqRlC7P50rx8cP13e4rs6323QOCWZ7DZaYf5sxW8TK%2FnHPyM8a%2FpHduQ46khh5dizl0KojPd70hMOiS02gIHdmI%2FVJqtNeEg5ML8zORzELl0AuCSIYiYJPSeSs%2FtMqHDVVxKmPmpIKZsA%3D%3D&scm=null&pvid=100_11.14.183.71_4986_5171558266573186178&app_pvid=59590_11.176.130.186_153663_1558266573177&ptl=floorId:2836;pvid:100_11.14.183.71_4986_5171558266573186178;app_pvid:59590_11.176.130.186_153663_1558266573177&xId=aRYbDIVBx6Fj0rNVU2VzrkmtNHs9tK9WtqaLf83xb6IseDkHHmcJ16jvUTuHrpoTjT1buNReTkYJXPahateQ2C&union_lens=lensId:0bb082ba_0c5a_16acfecf214_9c2e",
                "user_type":0,
                "volume":663,
                "white_image":"https://img.alicdn.com/bao/uploaded/TB2czAAam.EF1JjSZPcXXaxaFXa_!!50596962.jpg",
                "x_id":"aRYbDIVBx6Fj0rNVU2VzrkmtNHs9tK9WtqaLf83xb6IseDkHHmcJ16jvUTuHrpoTjT1buNReTkYJXPahateQ2C",
                "zk_final_price":"169.4"
            }
        ]
    },
    "total_results":18217,
    "request_id":"78txg4f1a84z"
}
设置文档主题

主题色

主色

强调色