apikey

string

是

接口秘钥，请登录后台获取

material_id

String

是

4092

官方提供的物料Id；物料id汇总贴：https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a

pid

String

否

mm_xx_xx_xx

推广位id

page_size

Number

否

20

页大小，默认20，1~100

page_no

Number

否

1

第几页，默认：1

relation_id

Number

否

渠道关系ID，仅适用于渠道推广场景

item_id

String

否

qeqscd1231-uqwenqe

淘宝客新商品ID；用于相似商品推荐（注意：使用相似商品推荐material_id=13256必传，并请先签署协议https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)；另关于《淘宝客新商品ID升级》参考白皮书：https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud

item_id

String

商品信息-淘宝客新商品id；使用说明参考《淘宝客新商品ID升级》白皮书：https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud

item_basic_info

BasicMapData

商品基础信息

title

String

商品信息-商品标题

short_title

String

商品信息-商品短标题

pict_url

String

商品信息-商品主图

white_image

String

商品信息-商品白底图

level_one_category_id

Number

商品信息-一级类目ID

level_one_category_name

String

商品信息-一级类目名称

category_id

Number

商品信息-叶子类目id

category_name

String

商品信息-叶子类目名称

seller_id

Number

店铺信息-卖家id

user_type

Number

店铺信息-卖家类型，0表示淘宝，1表示天猫，3表示特价版

shop_title

String

店铺信息-店铺名称

volume

Number

商品信息-30天销量；数据统计截止昨日非实时更新

sub_title

String

商品信息-商品子标题

brand_name

String

商品信息-品牌名称

price_promotion_info

PromotionInfoMapData

价格促销信息

reserve_price

String

商品信息-一口价通常显示为划线价

zk_final_price

String

促销信息-销售价格，无促销时等于一口价，有促销时为促销价。若属于预售商品，付定金时间内，在线售卖价=预售价

final_promotion_price

String

促销信息-预估到手价(元)。若属于预售商品，付定金时间内，预估到手价价=定金+尾款的预估到手价

final_promotion_path_list

FinalPromotionPathMapData[]

到手价优惠路径列表

promotion_title

String

优惠名称，如“商品券”、“跨店满减”、“单品直降”等

promotion_desc

String

优惠利益点文案，如“1件7.92折”、“每200减20”等

promotion_fee

String

实际优惠金额（元）

promotion_start_time

String

优惠开始时间

promotion_end_time

String

优惠结束时间

promotion_id

String

优惠ID

future_activity_promotion_price

String

预热预估到手价（元）

future_activity_promotion_path_list

FutureActivityPromotionPathMapData[]

预热到手价优惠路径列表

promotion_tag_list

PromotionTagMapData[]

标签信息列表

predict_rounding_up_price

String

促销信息-预估凑单价（元）。预估凑单叠加优惠后的商品单价

predict_rounding_up_price_desc

String

促销信息-凑单价说明，描述凑单价的实现说明。如 “可凑单”或“需买X件”

more_promotion_list

MorePromotionMapData[]

更多活动优惠

predict_rounding_up_path_list

PredictRoundingUpPathMapData[]

预估凑单优惠路径

publish_info

PublishInfo

淘客推广信息

income_rate

String

商品信息-收入比率(%)；商品佣金比率+补贴比率

click_url

String

链接-宝贝推广链接

coupon_share_url

String

链接-宝贝+券二合一页面链接

sp_campaign_list

SpCampaign[]

定向计划集合-仅支持联系商务或运营小二申请定向计划合集字段权限

sp_cid

String

定向计划活动ID

sp_name

String

定向计划名称

sp_rate

String

定向佣金率

sp_lock_status

String

定向是否锁佣，0=不锁佣 1=锁佣

sp_apply_link

String

定向计划申请链接

sp_status

String

定向计划是否可用 1-可用 0-不可用

future_activity_commission_rate

String

预热活动到手价对应的佣金比率

future_activity_time

String

预热价活动开始时间

income_info

IncomeInfo

商品佣金信息

commission_rate

String

商品佣金比率

commission_amount

String

商品佣金金额

subsidy_rate

String

补贴比率

subsidy_amount

String

补贴金额

subsidy_upper_limit

String

补贴上限；仅在单笔订单命中补贴上限时返回结果否则出参为空

cpa_reward_type

String

额外奖励活动类型，如果一个商品有多个奖励类型，返回结果使用空格分割，0=预售单单奖励，1=618超级U选单单补

cpa_reward_amount

String

额外奖励活动金额，活动奖励金额的类型与cpa_reward_type字段对应，如果一个商品有多个奖励类型，返回结果使用空格分割

tmall_rank_info

TmallRankInfo

天猫榜单信息

tmall_rank_text

String

白茶热销榜·第5名

榜单排行描述

tmall_rank_url

String

榜单url

presale_info

PresaleInfo

预售信息

presale_start_time

Number

预售商品-付定金开始时间（毫秒）

presale_end_time

Number

预售商品-付定金结束时间（毫秒）

presale_tail_start_time

Number

预售商品-付尾款开始时间（毫秒）

presale_tail_end_time

Number

预售商品-付尾款结束时间（毫秒）

presale_deposit

String

预售商品-定金（元）

presale_discount_fee_text

String

预售商品-优惠信息

favorites_info

FavoritesInfo

选品库信息

topn_info

TopNInfoDTO

前N件佣金信息-前N件佣金生效或预热时透出以下字段

topn_quantity

Number

前N件剩余库存

topn_total_count

Number

前N件初始总库存

topn_start_time

String

前N件佣金开始时间

topn_end_time

String

前N件佣金结束时间

topn_rate

String

前N件佣金率

scope_info

ScopeInfo

商品库范围信息

superior_brand

String

是否品牌精选，0不是，1是