作为淘客开发者必看的淘宝客API介绍总帖

淘宝客API介绍总帖

帮你快速概览联盟API,如何获得权限,及如何使用!
API功能开放给拥有自己独立网站或APP,并在联盟平台完成备案的淘客使用。

请先了解api调用的方式:

淘宝客API调用,必须完成媒体备案,创建推广位(即pid)之后,才可生成appkey,进行API调用。
说明:
1、pid如何生成:
淘宝客需先完成媒体备案,在对应媒体ID下,创建推广位。点击了解《淘宝客推广者备案新手指南
2、pid的三段数字含义:
淘宝客pid由三段数字组成 pid=mm_1_2_3(其中1/2/3分别代表一串数字,举例pid=mm_98836808_12970065_68140878),其中1这串数字对应淘宝客的账户id(通常称member);2这串数字对应媒体管理中备案的媒体ID(通常称site);3这串数字对应媒体ID下的具体推广位(通常称adzone)。
3、哪些媒体ID可获得appkey:
媒体备案中,除了“线下-个人、单门店”、“达人个人”、“站内达人平台自动生成的site”这几类媒体ID以外,其他均可申请appkey,每一个媒体ID对应生成一个appkey,调用api时系统会校验是否应用于对应媒体阵地内。如果appkey不匹配或传递参数错误,会不算淘宝客交易,切记!

淘宝联盟提供哪些API服务?

一、能力地图概况

赋能对象:推广者

能力类型 包含内容
物料类 信息查询(商品/店铺、优惠券)  |  精品(精选商品库/榜单/猜你喜欢/商品关联推荐/选品库的等批量商品获取)  | 搜索(商品、店铺)  | 关联推荐(店铺)  | 商品出词
基建类 唤端联动(唤醒/授权免登)  | 转链(商品/店铺转链、单品高效转链、三方转链、活动转链、淘口令、长链转短链)
组织管理类 私域用户管理(渠道管理、会员运营管理)
数据类 订单明细(所有订单/维权退款订单、处罚订单)  | 拉新订单效果
营销类 淘礼金

1、物料类能力

功能点 权限包名称 API名称 API地址 功能描述 如何获得
①信息查询(商品/店铺、优惠券) 淘宝客【公用】物料信息查询 淘宝客-公用-淘宝客商品详情查询(简版) taobao.tbk.item.info.get 输入批量商品id,查询对应淘宝客商品的详情页详细字段(简版) 默认可申请
淘宝客-公用-阿里妈妈推广券详情查询 taobao.tbk.coupon.get 输入商品ID+券ID,或者传入me参数,查询对应阿里妈妈推广券信息
②精品(精选商品库/榜单/猜你喜欢/商品关联推荐/选品库的等批量商品获取) 淘宝客【推广者】物料精选 淘宝客-推广者-物料精选 taobao.tbk.dg.optimus.material 输入pid、物料id,输出对应物料库的店铺/商品/类目/券/拼团等详细字段信息。【看material_id请点击】(聚划算/淘抢购/猜你喜欢/商品关联推荐/大额券/品牌券等物料均在此,且包含pub平台选品库批量获取) 默认可申请
③搜索(商品、店铺) 淘宝客【推广者】物料搜索 淘宝客-推广者-物料搜索 taobao.tbk.dg.material.optional 输入pid(必选)、物料id或各种筛选字段,输出对应商品的店铺/商品/类目/券/拼团等详细字段信息 默认可申请
淘宝客-推广者-店铺搜索 taobao.tbk.shop.get 淘宝客店铺查询
④关联推荐(店铺) 淘宝客【公用】关联推荐 淘宝客-公用-店铺关联推荐 taobao.tbk.shop.recommend.get 输入店铺id,查询与此店铺关联或相近的店铺及店铺店铺详情信息 默认可申请
⑤商品出词 淘宝客【推广者】商品出词 淘宝客-推广者-商品出词 taobao.tbk.item.word.get 商品出词API,提供搜索结果页。 默认可申请

 

2、基建类能力

①转链类

功能点 权限包名称 API名称 API地址 功能描述 如何获得
活动转链 淘宝客【推广者】官方活动转链(更新版) 淘宝客-推广者-官方活动信息获取 taobao.tbk.activity.info.get 从官方活动列表页取出官方活动ID,支持二方、三方 默认可申请
淘口令 淘宝客【公用】淘口令生成 淘宝客-公用-淘口令生成 taobao.tbk.tpwd.create 提供淘客生成淘口令接口,淘客输入口令内容、logo、url等参数,生成淘口令关键key如:¥SADadW¥,后续进行文案包装组装用于传播。输入商品信息,广告位信息,转成淘口令。目前淘口令的有效期是30天,我们的API没有做特殊逻辑,有效期等同于淘口令有效期 默认可申请
长链转短链 淘宝客【公用】长链转短链 淘宝客-公用-长链转短链 taobao.tbk.spread.get 输入一个原始的链接,转换得到指定的传播方式,如二维码,淘口令,短连接;现阶段只支持短连接。短连接有效期300天 默认可申请

以下为邀约制

功能点 权限包 API名称 API地址 功能描述 如何获得
①单品高效转链 淘宝客【推广者】单品券高效转链 淘宝客-推广者-单品券高效转链 taobao.tbk.coupon.convert 根据商品ID,Me参数,可查询最高佣金比例,券的相关数据,也可直接输出转链的二合一页面 邀约制
②商品/店铺转链 淘宝客【推广者】商品或店铺链接转换 淘宝客-推广者-商品链接转换 taobao.tbk.item.convert 普通商品转链,营销/定向/通用。媒体可以指定走什么计划,如果不传指定参数1进来,走营销,如果指定参数1,就走定向(若有关系)或通用 邀约制
淘宝客-推广者-店铺链接转换 taobao.tbk.shop.convert 店铺转链接,通用计划
③三方转链 淘宝客【推广者】三方分成链接转换 淘宝客-推广者-商品三方分成链接转换 taobao.tbk.item.share.convert 三方分成商品通用类链接或营销类链接 邀约制
淘宝客-推广者-店铺三方分成链接转换 taobao.tbk.shop.share.convert 三方分成店铺转链接

 

3、组织管理类

①、私域用户管理

1-1:渠道管理:提供淘宝客发展帮助自己推广的渠道,并对其进行管理的能力。默认渠道id数20万。

如需申请【点击功能介绍及申请帖】

1-2:会员运营管理:提供帮助淘宝客沉淀自己的会员,进行精准的二次营销、会员管理和营销返利等服务的能力。

如需申请【点击功能介绍及申请帖】

以上两者统一的API权限包:

填写申请表时,提交appkey,即可默认获得,同时还可默认获得两个订单权限包淘宝客【推广者】推广订单及数据查询+淘宝客【推广者】处罚订单查询

功能点 权限包名称 API名称 API地址 功能描述 如何获得
私域用户管理 淘宝客【公用】私域用户管理 淘宝客-公用-私域用户邀请码生成 taobao.tbk.sc.invitecode.get 邀请码生成功能 如需申请【点击功能介绍及申请帖】
淘宝客-公用-私域用户备案 taobao.tbk.sc.publisher.info.save 根据邀请码,查询相应的渠道关系id或会员运营id
淘宝客-公用-私域用户备案信息查询 taobao.tbk.sc.publisher.info.get 输入渠道类型/会员类型,或再输入渠道关系id/会员运营id,查询对应各id备案填写的信息

私域用户管理规范:https://rule.alimama.com/#!/product/index?type=detailid=405knowledgeId=9350

《私域用户管理能力之新手指南(for媒体)》

 

4、数据类能力

①拉新数据

基础:默认可申请

功能点 权限包名称 API名称 API地址 功能描述 如何获得
拉新订单效果 淘宝客【推广者】新用户订单及数据查询 淘宝客-推广者-新用户订单明细查询 taobao.tbk.dg.newuser.order.get 查询拉新新人手机号、时间、订单、推广者等信息 默认可申请
淘宝客-推广者-拉新活动对应数据查询 taobao.tbk.dg.newuser.order.sum 输入pid和活动id,查看每个拉新活动对应的数据

②订单明细数据

功能点 权限包名称 API名称 API地址 功能描述 如何获得
订单明细(所有订单/维权退款订单) 淘宝客【推广者】推广订单及数据查询 淘宝客-推广者-所有订单查询 taobao.tbk.order.details.get(老apitaobao.tbk.order.get计划下线。点击看通知) 输入查询时间,返回对应订单卖家、商品、金额、佣金、媒体等详细数据 申请私域用户管理功能中开放。其他为邀约制
淘宝客-推广者-维权退款订单查询 taobao.tbk.relation.refund 维权退款的订单,支持二方和三方的渠道or会员订单
订单明细(处罚订单) 淘宝客【推广者】处罚订单查询 淘宝客-推广者-处罚订单查询 taobao.tbk.dg.punish.order.get 新增处罚订单查询API,提供媒体调用查询能力。 申请私域用户管理功能中开放。其他为邀约制

 

5、营销类能力

论坛帖申请规则【请点击】

功能点 权限包名称 API名称 API地址 功能描述 如何获得
淘礼金 淘宝客【推广者】淘礼金营销 淘宝客-推广者-淘礼金创建 taobao.tbk.dg.vegas.tlj.create 淘礼金创建 默认可申请,但需先申请淘礼金权限才可使用API
淘宝客-推广者-淘礼金发放及使用报表 taobao.tbk.dg.vegas.tlj.instance.report 淘礼金引导的效果报表

 

二、如何获取权限

默认可申请自助点击申请即可获取

1、完成阿里妈妈账号注册、完成推广阵地的备案:

进入淘宝联盟推广管理—>媒体备案管理,提交后,若审核通过会后提示审核通过。

2、准入及清退规则:

准入规则:符合以下标准的 淘宝客推广者可以申请:

①、须为阿里妈妈激活会员,并绑定符合阿里妈妈要求的支付宝账户。

②、阿里妈妈账户内因特定类型的淘宝客违规而产生的生效中的累计扣分<18分。解读

③、网站或无线APP备案审核通过。

④、网站或无线APP正确部署淘点金组件。

⑤、账户对应的关联账号未在阿里妈妈存在历史违规作弊情形。

清退规则:出现以下情节,阿里妈妈将禁止调用API权限或终止该推广者的API使用权限,因此导致的推广内容无法展现、收入无法统计支取等由推广者自行负责。

①、不符合API权限包开放规则。

②、拥有api权限的推广者连续30天对应API无调用量或无成交量。解读

③、拥有高级API权限(即邀约制API)的媒体,月日均点击量小于5万或月日均alipay金额小于10万。

④、申请的api权限用于非申请时提供的媒体备案渠道内,或未经阿里妈妈事先同意擅自开放给第三方进行调用。

⑤、随意删减、修改淘宝客API接口,或调用淘宝客API接口用以开发插件类应用或依附于客户端(含浏览器)的插件。

⑥、泄露淘宝客API权限的用户名和密码等隐私信息。

⑦、违反《阿里妈妈推广者规范》其他规范的。

3、获取步骤:

① 在阿里妈妈后台完成备案,且审核通过,即可获得淘宝客基础的API的申请权限,点击查看即可在淘宝开放平台中看到对应的权限包和所包含的API。

appkey申请通过之后,点击对应的“查看”

进入阿里开放平台(https://open.taobao.com)对应的appkey应用下,查看appkey的调用和API权限包

(参考淘礼金的权限包的模式,默认可申请的API权限包,均可看到,去申请)

② 高级权限获取在符合初级入门要求基础上,邀约制,小二会根据媒体的发展情况,邀约达成合作意向后开通。

 

三、FAQ

1、API的调用量是多少?

目前单一api没有调用量的限制,但是TOP平台对APP证书的调用量进行了限制,为10W/天。媒体可以进入自己的TOP平台进行查询,当日调用量超过90%时,可申请自助提升调用量(提升量仅当日有效)路径:

2、API怎么用呢?

建议可以参考api使用说明文档https://open.taobao.com/doc2/docIndex.htm

原文链接 https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628679?_k=0y7493