Content
Taoke 31
Taoke-MCP is a service for link conversion and product promotion across Taobao, JD, and Pinduoduo, based on Model Context Protocol.
taobao.searchMaterial
淘宝客-服务商-物料搜索升级版[taobao.tbk.sc.material.optional.upgrade]
【非必填】1-动态ID转链场景,2-消费者比价场景(不填默认为1),示例值:1
【非必填】商品筛选-后台类目ID。用,分割,最大10个,示例值:16,18
【非必填】智能匹配-设备号加密类型:MD5,示例值:MD5
【非必填】智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID,或者OAID,示例值:IMEI
【非必填】智能匹配-设备号加密后的值(MD5加密需32位小写),示例值:xxx
【非必填】商品筛选-预估到手价范围上限。单位:元,示例值:10
【非必填】商品筛选-淘客收入比率上限(商品佣金比率+补贴比率)。如:1234表示12.34%,示例值:1234
【非必填】是否获取前N件佣金信息,0否,1是,其他值否,示例值:0
【非必填】优惠券筛选-是否有优惠券。true表示该商品有优惠券,false或不设置表示不限,示例值:false
【非必填】商品筛选-好评率是否高于行业均值。True表示大于等于,false或不设置表示不限,示例值:true
【非必填】商品筛选-成交转化是否高于行业均值。True表示大于等于,false或不设置表示不限,示例值:true
【非必填】商品筛选-退款率是否低于行业均值。True表示大于等于,false或不设置表示不限,示例值:true
【非必填】ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供,示例值:13.2.33.4
【非必填】商品筛选-是否海外商品。true表示属于海外商品,false或不设置表示不限,示例值:false
【非必填】商品筛选-是否天猫商品。true表示属于天猫商品,false或不设置表示不限,示例值:false
【非必填】商品筛选-所在地,示例值:杭州
【非必填】物料id,不传时默认物料material_id=80309,示例值:80309
【非必填】线报内容筛选—内容生产截止时间,13毫秒时间戳,示例值:1695281620000
【非必填】线报内容筛选—内容生产开始时间,13毫秒时间戳,示例值:1695281620000
【非必填】线报状态筛选,0-全部 1-过期 2-实时生效 3-未来生效 不传默认过滤有效,示例值:0
【非必填】商品筛选-是否包邮。true表示包邮,false或不设置表示不限,示例值:true
【非必填】商品筛选-是否加入消费者保障。true表示加入,false或不设置表示不限,示例值:true
【非必填】商品筛选-牛皮癣程度。取值:1不限,2无,3轻微,示例值:2
【非必填】第几页,默认:1,示例值:1
【非必填】页大小,默认20,1~100,示例值:20
【非必填】1-自购省,2-推广赚(代理模式专属ID,代理模式必填,非代理模式不用填写该字段),示例值:2
【非必填】商品筛选-查询词,示例值:女装
【非必填】渠道关系ID,仅适用于渠道推广场景,示例值:3243
【非必填】排序_des(降序),排序_asc(升序),销量(total_sales),淘客收入比率(tk_rate),营销计划佣金(tk_mkt_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),预估到价格(final_promotion_price),匹配分(match),示例值:tk_rate_des
【非必填】会员运营ID,仅适用于会员运营场景,示例值:2323
【非必填】商品筛选-店铺dsr评分。筛选大于等于当前设置的店铺dsr评分的商品0-50000之间,示例值:10
【非必填】商品筛选-预估到手价范围下限。单位:元,示例值:10
【非必填】商品筛选-淘客收入比率下限(商品佣金比率+补贴比率)。如:1234表示12.34%,示例值:1234
【非必填】人群ID,仅适用于物料评估场景material_id=41377,示例值:1
taobao.convertLink
转推广链接[淘宝客-服务商-万能转链]:可以为url或淘口令,商城链接等转成推广链接
【非必填】1-动态ID转链场景,2-消费者比价场景,4-,示例值:1
【非必填】商品转链,包含字段:item_id, sku_id, is_target_coupon, coupon_id, external_id, dx, manage_pub_id
【非必填】商品ID列表,多个时使用英文逗号拼接传入,示例值:qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9
【非必填】链接/口令转链,包含字段:material_url, is_target_coupon, coupon_id
【非必填】物料列表,可以为url或淘口令,多个时使用英文逗号拼接传入(邀约制权限有申请门槛,权限分为①联盟推广链接转链;②天猫/淘宝复制链接转链;如有相关需求请在权限申请时同步说明),示例值:https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu
【非必填】会场页面转链,包含字段:page_id, target_item_list
【非必填】会场ID列表,多个时使用英文逗号拼接传入,示例值:123456
【非必填】1-自购省,2-推广赚(代理模式专属ID,代理模式必填,其它模式不用填写本字段),示例值:2
【非必填】启明系统任务ID,示例值:123
【非必填】渠道管理ID(如是主站选品推广场景,必须入参该字段,且bizSceneId字段需入参2-消费者比价场景,否则二次转链失败),示例值:123456
【非必填】卖家ID列表,多个时使用英文逗号拼接传入,示例值:123456
【非必填】店铺转链,包含字段:shop_id
【非必填】会员运营id,示例值:123
【非必填】会场页面内定坑商品
【非必填】加密用户标识,示例值:adjso7389rbnasd
taobao.parseLink
解析淘宝客链接或淘口令[淘宝客-服务商-万能解析]
【非必填】有origin_pid使用场景需入参,示例值:origin_pid
【非必填】链接/口令转链
【非必填】渠道管理ID(如是主站选品推广场景,必须入参该字段,且bizSceneId字段需入参2-消费者比价场景,否则二次转链失败),示例值:123456
taobao.convertActivity
转换淘宝活动链接[淘宝客-服务商-官方活动转链]
【必填】官方活动会场ID,从淘宝客后台“我要推广-活动推广”中获取,示例值:123
【非必填】渠道关系id,示例值:123
【非必填】自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道,示例值:demo
taobao.getOrderDetails
查询淘宝联盟订单信息[淘宝客-服务商-所有订单查询]
【必填】订单查询结束时间,订单开始时间至订单结束时间,中间时间段日常要求不超过3个小时,但如618、双11、年货节等大促期间预估时间段不可超过20分钟,超过会提示错误,调用时请务必注意时间段的选择,以保证亲能正常调用!,示例值:2019-04-23 12:28:22
【非必填】跳转类型,当向前或者向后翻页必须提供,-1: 向前翻页,1:向后翻页,示例值:1
【非必填】member组ID,示例值:100
【非必填】推广者角色类型,2:二方,3:三方,不传,表示所有角色,示例值:2
【非必填】筛选订单类型,1:所有订单,2:渠道订单,3:会员运营订单,默认为1,示例值:1
【非必填】第几页,默认1,1~100,示例值:1
【非必填】页大小,默认20,1~100,示例值:20
【非必填】位点,除第一页之外,都需要传递;前端原样返回。,示例值:2222_334666
【非必填】查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询,4:按照订单更新时间;,示例值:1
【必填】订单查询开始时间,示例值:2019-04-05 12:18:22
【非必填】淘客订单状态,12-付款,13-关闭,14-确认收货,3-结算成功;不传,表示所有状态,示例值:12
taobao.spreadRequests
批量转换淘宝链接为短链接[淘宝客-公用-长链转短链]
【必填】请求列表,内部包含多个url
taobao.createPromotionZone
创建淘宝客推广位[淘宝客-服务商-创建推广者位]
【必填】广告位名称,最大长度64字符,示例值:广告位
taobao.createTpwd
淘口令生成[淘宝客-公用-淘口令生成]
【非必填】兼容旧版本api参数,无实际作用,示例值:nomeaningValue
【非必填】兼容旧版本api参数,无实际作用,示例值:nomeaningValue
【非必填】兼容旧版本api参数,无实际作用,示例值:nomeaningValue
【必填】联盟官方渠道获取的淘客推广链接,请注意,不要随意篡改官方生成的链接,否则可能无法生成淘口令,示例值:https://s.click.taobao.com/YI3Uopu
【非必填】兼容旧版本api参数,无实际作用,示例值:nomeaningValue
taobao.getPunishOrder
处罚订单查询[淘宝客-服务商-处罚订单查询]
【必填】入参的对象
taobao.getItemInfo
淘宝客商品详情查询[淘宝客-公用-淘宝客商品详情查询(简版)]
【非必填】1-动态ID转链场景,2-消费者比价场景,3-商品库导购场景(不填默认为1),示例值:1
【非必填】ip地址,影响邮费获取,如果不传或者传入不准确,邮费无法精准提供,示例值:11.22.33.43
【非必填】商品库服务账户(场景id3权限对应的memberid),示例值:1
【必填】商品ID串,用,分割,最大40个,示例值:123,456
【非必填】链接形式:1:PC,2:无线,默认:1,示例值:1
【非必填】1-自购省,2-推广赚(代理模式专属ID,代理模式必填,非代理模式不用填写该字段),示例值:2
【非必填】渠道关系ID,示例值:1
taobao.getOptimusPromotion
权益物料精选[淘宝客-服务商-权益物料精选][官方提供的权益物料Id。有价券-37104、大额店铺券-37116、天猫店铺券-62191、券券补-61809 更多权益物料id敬请期待!]
【非必填】第几页,默认:1,示例值:1
【非必填】页大小,每次请求限到10以内,示例值:10
【必填】官方提供的权益物料Id。有价券-37104、大额店铺券-37116、天猫店铺券-62191、券券补-61809 更多权益物料id敬请期待!,示例值:123
taobao.vegas-send-report
查询淘宝红包发放个数[淘宝客-服务商-查询红包发放个数]
【非必填】查询红包类型,1-超级红包,2-福利购,3-签到红包,4-福利直降,5-幸运赢免单,不传时默认查询超级红包数据,示例值:1
【非必填】已下线,后续不需要填写,示例值:1
【必填】统计日期,示例值:20191201
【非必填】页码,示例值:1
【非必填】每页大小,示例值:10
【非必填】渠道关系id,示例值:111
【非必填】查询维度,不填写默认是pid维度,示例值:pid/relation
jd.position.query
查询京东推广位信息[京东联盟-推广位查询]
【非必填】页码,默认1
【非必填】每页条数,默认20,上限100
【必填】联盟推广位类型,3:私域推广位,4:联盟后台推广位
jd.position.create
创建京东推广位[京东联盟-推广位创建]
【非必填】站点ID,无ID时使用环境变量JD_SITE_ID,未设置则为0
【必填】推广位名称列表,最多创建50个
【必填】站点类型,3:无线站,4:PC站
【必填】联盟推广位类型,3:私域推广位,4:联盟后台推广位
jd.promotion.byunionid.get
生成京东商品推广链接[京东联盟-转推广链接]
【非必填】链接类型,1-长链接,2-短链接,3-长链接+短链接,默认1
【非必填】渠道ID
【非必填】优惠券领取链接,填写则生成二合一推广链接
【非必填】自定义扩展信息,建议json格式
【非必填】礼金批次ID
【必填】推广物料ID,如商品skuId、活动ID、商品链接等
【非必填】推广位ID,如不填写则生成无推广位链接
【非必填】子联盟ID,用于区分子账号推广效果
jd.goods.query
查询京东商品信息[京东联盟-商品查询]
【非必填】一级类目ID
【非必填】二级类目ID
【非必填】三级类目ID
【非必填】是否是优惠券商品,1:有优惠券,0:无优惠券
【非必填】是否是爆款,1:爆款商品,0:非爆款商品
【非必填】是否是拼购商品,1:拼购商品,0:非拼购商品
【非必填】搜索关键词,支持多个关键词,用英文逗号分隔
【非必填】商品类型:自营[g],POP[p]
【非必填】页码,默认1
【非必填】每页数量,默认20,上限50
【非必填】京东商品ID数组,最多支持查询20个sku
【非必填】排序方式,asc:升序,desc:降序,默认降序
【非必填】排序字段(price:单价,commissionShare:佣金比例,commission:佣金,inOrderCount30Days:30天引单量)
jd.coupon.query
查询京东优惠券信息[京东联盟-优惠券查询]
【必填】优惠券链接集合,最多支持100个
pdd.goods.detail
多多进宝商品详情查询[pdd.ddk.oauth.goods.detail]
【非必填】商品主图类型:1-场景图,2-白底图,默认为0
【非必填】商品goodsSign,支持通过goodsSign查询商品。goodsSign是加密后的goodsId, goodsId已下线,请使用goodsSign来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252
【非必填】是否获取sku信息,默认false不返回。(特殊渠道权限,需额外申请)
【非必填】风控参数
【非必填】搜索id,建议填写,提高收益。来自pdd.ddk.goods.recommend.get、pdd.ddk.goods.search、pdd.ddk.top.goods.list.query等接口
pdd.cms.prom.url
生成商城推广链接[pdd.ddk.oauth.cms.prom.url.generate]
【非必填】0, "1.9包邮";1, "今日爆款"; 2, "品牌清仓"; 4,"PC端专属商城(已下线,会生成默认商城)"
【非必填】是否生成手机跳转链接。true-是,false-否,默认false
【非必填】是否返回 schema URL
【非必填】是否生成短链接,true-是,false-否
【非必填】是否生成拼多多福利券微信小程序推广信息
【非必填】搜索关键词
【非必填】单人团多人团标志。true-多人团,false-单人团 默认false
pdd.goods.pid.generate
多多进宝推广位创建[pdd.ddk.oauth.goods.pid.generate]
【非必填】媒体id
【必填】要生成的推广位数量,默认为10,范围为:1~100
【非必填】推广位名称,例如["名称1","名称2"]
pdd.goods.pid.query
多多客已生成推广位信息查询[pdd.ddk.oauth.goods.pid.query]
【非必填】返回的页数
【非必填】返回的每页推广位数量
【非必填】推广位列表,例如:["60005_612"]
pdd.goods.prom.url
生成多多进宝商品推广链接[pdd.ddk.oauth.goods.prom.url.generate]
【非必填】多多礼金ID
【非必填】自定义礼金标题,用于向用户展示渠道专属福利,不超过12个字
【非必填】是否使用多多客专属推广计划
【非必填】是否生成带授权的单品链接。如果未授权,则会走授权流程
【非必填】是否生成店铺收藏券推广链接
【非必填】是否生成qq小程序
【非必填】是否返回 schema URL
【非必填】是否生成短链接,true-是,false-否
【非必填】是否生成拼多多福利券微信小程序推广信息
【非必填】是否生成小程序schema长链
【非必填】商品goodsSign列表,例如:["c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN"],支持批量生链。goodsSign是加密后的goodsId, goodsId已下线,请使用goodsSign来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252
【非必填】素材ID,可以通过商品详情接口获取商品素材信息
【非必填】true--生成多人团推广链接 false--生成单人团推广链接(默认false)1、单人团推广链接:用户访问单人团推广链接,可直接购买商品无需拼团。2、多人团推广链接:用户访问双人团推广链接开团,若用户分享给他人参团,则开团者和参团者的佣金均结算给推手
【非必填】搜索id,建议填写,提高收益。来自pdd.ddk.goods.recommend.get、pdd.ddk.goods.search、pdd.ddk.top.goods.list.query等接口
【非必填】特殊参数
【非必填】生成商品链接类型 0-默认 1-百补相似品列表
pdd.goods.recommend
运营频道商品查询API[pdd.ddk.oauth.goods.recommend.get]
【非必填】活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,10851-千万补贴,11879-千万神券,10913-招商礼金商品,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,其他的值请忽略
【非必填】猜你喜欢场景的商品类目,20100-百货,20200-母婴,20300-食品,20400-女装,20500-电器,20600-鞋包,20700-内衣,20800-美妆,20900-男装,21000-水果,21100-家纺,21200-文具,21300-运动,21400-虚拟,21500-汽车,21600-家装,21700-家具,21800-医药;
【非必填】进宝频道推广商品: 1-今日销量榜,3-相似商品推荐,4-猜你喜欢(和进宝网站精选一致),5-实时热销榜,6-实时收益榜。默认值5
【非必填】是否使用工具商专属推广计划,默认为false
【非必填】商品主图类型:1-场景图,2-白底图,默认为0
【非必填】商品goodsSign列表,相似商品推荐场景时必传,仅取数组的第一位,例如:["c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN"]。goodsSign是加密后的goodsId, goodsId已下线,请使用goodsSign来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252
【非必填】一页请求数量;默认值 : 20
【非必填】翻页时建议填写前页返回的list_id值
【非必填】从多少位置开始请求;默认值 : 0
【非必填】推广位id
【非必填】风控参数
pdd.goods.search
多多进宝商品查询[pdd.ddk.oauth.goods.search]
【非必填】活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,10851-千万补贴,11879-千万神券,10913-招商礼金商品,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,其他的值请忽略
【非必填】屏蔽商品类目包:1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药
【非必填】自定义屏蔽一级/二级/三级类目ID,自定义数量不超过20个;使用pdd.goods.cats.get接口获取cat_id
【非必填】商品类目ID,使用pdd.goods.cats.get接口获取
【非必填】是否使用工具商专属推广计划,默认为false
【非必填】商品主图类型:1-场景图,2-白底图,默认为0
【非必填】商品goodsSign列表,例如:["c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN"],支持通过goodsSign查询商品。goodsSign是加密后的goodsId, goodsId已下线,请使用goodsSign来替代。使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252
【非必填】是否为品牌商品
【非必填】商品关键词,与opt_id字段选填一个或全部填写。可支持goods_id、拼多多链接(即拼多多app商详的链接)、进宝长链/短链(即为pdd.ddk.goods.promotion.url.generate接口生成的长短链)
【非必填】翻页时建议填写前页返回的list_id值
【非必填】店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)
【非必填】店铺类型数组,例如:[1,2]
【非必填】商品标签类目ID,与keyword字段选填一个或全部填写,使用pdd.goods.opt.get获取
【非必填】默认值1,商品分页数
【非必填】默认100,每页商品数量
【非必填】筛选范围列表 样例:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}]
【非必填】风控参数
【非必填】排序方式:0-综合排序;1-按佣金比率升序;2-按佣金比例降序;3-按价格升序;4-按价格降序;5-按销量升序;6-按销量降序;7-优惠券金额排序升序;8-优惠券金额排序降序;9-券后价升序排序;10-券后价降序排序;11-按照加入多多进宝时间升序;12-按照加入多多进宝时间降序;13-按佣金金额升序排序;14-按佣金金额降序排序;15-店铺描述评分升序;16-店铺描述评分降序;17-店铺物流评分升序;18-店铺物流评分降序;19-店铺服务评分升序;20-店铺服务评分降序;27-描述评分击败同类店铺百分比升序,28-描述评分击败同类店铺百分比降序,29-物流评分击败同类店铺百分比升序,30-物流评分击败同类店铺百分比降序,31-服务评分击败同类店铺百分比升序,32-服务评分击败同类店铺百分比降序
【非必填】是否使用个性化推荐,true表示使用,false表示不使用,默认true。
【非必填】是否只返回优惠券的商品,false返回所有商品,true只返回有优惠券的商品
pdd.goods.zs.unit.url
多多进宝转链接口[pdd.ddk.oauth.goods.zs.unit.url.gen]
【非必填】是否返回 schema URL
【非必填】是否生成微信shortlink链接,仅支持单品,单个渠道每天生成的shortLink数量有限,请合理生成shortLink链接
【非必填】是否生成微信LongLink
【必填】需转链的链接,支持拼多多商品链接、进宝长链/短链(即为pdd.ddk.goods.promotion.url.generate接口生成的长短链)
pdd.member.authority.query
查询是否绑定备案[pdd.ddk.oauth.member.authority.query]
【非必填】推广位id,如果不传则使用环境变量中的PID
pdd.order.detail.get
获取订单详情[pdd.ddk.oauth.order.detail.get]
【必填】订单号
【非必填】订单类型:1-推广订单;2-直播间订单
pdd.order.list.increment.get
按照更新时间段增量同步推广订单信息[pdd.ddk.oauth.order.list.increment.get]
【必填】最近24小时内多多进宝商品订单更新时间--查询时间结束。note:此时间为时间戳,指格林威治时间 1970 年01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数
【非必填】第几页,从1到10000,默认1,注:使用最后更新时间范围增量同步时,必须采用倒序的分页方式(从最后一页往回取)才能避免漏单问题。
【非必填】返回的每页结果订单数,默认为100,范围为10到100,建议使用40~50,可以提高成功率,减少超时数量。
【必填】最近24小时内多多进宝商品订单更新时间--查询时间开始。note:此时间为时间戳,指格林威治时间 1970 年01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数
pdd.resource.url.gen
拼多多主站频道推广[pdd.ddk.oauth.resource.url.gen]
【非必填】是否返回 schema URL
【非必填】是否生成拼多多福利券微信小程序推广信息
【非必填】频道来源:4-限时秒杀,39997-充值中心, 39998-活动转链,39996-百亿补贴,39999-电器城,40000-领券中心,50005-火车票
【非必填】原链接
support.contact
获取技术支持联系方式 - 当遇到工具调用失败、配置问题或其他错误时使用
【可选】遇到的问题描述,如'淘宝链接转换失败'、'京东API时间戳错误'等
support.troubleshoot
获取故障排查指南 - 提供常见问题的诊断步骤
【可选】问题类别:environment(环境变量), api(API调用), docker(Docker部署), network(网络), other(其他)