tao-mcp

淘宝物料搜索参数

基于淘宝开放平台API文档

淘宝开放平台 API 文档:taobao.tbk.dg.material.optional

参数名类型是否必填描述
start_dsrnumber非必填商品筛选-店铺 dsr 评分。筛选大于等于当前设置的店铺 dsr 评分的商品 0-50000 之间,示例值:10
page_sizenumber非必填页大小,默认 20,1~100,示例值:20
page_nonumber非必填第几页,默认:1,示例值:1
end_tk_ratenumber非必填商品筛选-淘客收入比率上限(商品佣金比率+补贴比率)。如:1234 表示 12.34%,示例值:1234
start_tk_ratenumber非必填商品筛选-淘客收入比率下限(商品佣金比率+补贴比率)。如:1234 表示 12.34%,示例值:1234
end_pricenumber非必填商品筛选-预估到手价范围上限。单位:元,示例值:10
start_pricenumber非必填商品筛选-预估到手价范围下限。单位:元,示例值:10
is_overseasboolean非必填商品筛选-是否海外商品。true 表示属于海外商品,false 或不设置表示不限,示例值:false
is_tmallboolean非必填商品筛选-是否天猫商品。true 表示属于天猫商品,false 或不设置表示不限,示例值:false
sortstring非必填排序_des(降序),排序_asc(升序),销量(total_sales),淘客收入比率(tk_rate),营销计划佣金(tk_mkt_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),预估到价格(final_promotion_price),匹配分(match),示例值:tk_rate_des
itemlocstring非必填商品筛选-所在地,示例值:杭州
catstring非必填商品筛选-后台类目 ID。用,分割,最大 10 个,示例值:16,18
qstring非必填商品筛选-查询词,示例值:女装
material_idnumber非必填物料 id,不传时默认物料 material_id=80309,示例值:80309
has_couponboolean非必填优惠券筛选-是否有优惠券。true 表示该商品有优惠券,false 或不设置表示不限,示例值:false
ipstring非必填ip 参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供,示例值:13.2.33.4
npx_levelnumber非必填商品筛选-牛皮癣程度。取值:1 不限,2 无,3 轻微,示例值:2
include_rfd_rateboolean非必填商品筛选-退款率是否低于行业均值。True 表示大于等于,false 或不设置表示不限,示例值:true
include_good_rateboolean非必填商品筛选-好评率是否高于行业均值。True 表示大于等于,false 或不设置表示不限,示例值:true
include_pay_rate_30boolean非必填商品筛选-成交转化是否高于行业均值。True 表示大于等于,false 或不设置表示不限,示例值:true
need_prepayboolean非必填商品筛选-是否加入消费者保障。true 表示加入,false 或不设置表示不限,示例值:true
need_free_shipmentboolean非必填商品筛选-是否包邮。true 表示包邮,false 或不设置表示不限,示例值:true
device_valuestring非必填智能匹配-设备号加密后的值(MD5 加密需 32 位小写),示例值:xxx
device_encryptstring非必填智能匹配-设备号加密类型:MD5,示例值:MD5
device_typestring非必填智能匹配-设备号类型:IMEI,或者 IDFA,或者 UTDID,或者 OAID,示例值:IMEI
relation_idstring非必填渠道关系 ID,仅适用于渠道推广场景,示例值:3243
special_idstring非必填会员运营 ID,仅适用于会员运营场景,示例值:2323
get_topn_ratenumber非必填是否获取前 N 件佣金信息,0 否,1 是,其他值否,示例值:0
biz_scene_idstring非必填1-动态 ID 转链场景,2-消费者比价场景(不填默认为 1),示例值:1
promotion_typestring非必填1-自购省,2-推广赚(代理模式专属 ID,代理模式必填,非代理模式不用填写该字段),示例值:2
mgc_start_timestring非必填线报内容筛选—内容生产开始时间,13 毫秒时间戳,示例值:1695281620000
mgc_end_timestring非必填线报内容筛选—内容生产截止时间,13 毫秒时间戳,示例值:1695281620000
mgc_statusstring非必填线报状态筛选,0-全部 1-过期 2-实时生效 3-未来生效 不传默认过滤有效,示例值:0
ucrowd_idnumber非必填人群 ID,仅适用于物料评估场景 material_id=41377,示例值:1