淘客万能转链API接口

接口地址：http://bkapi.com/api/GeneralLinkConvert

返回格式：json

请求方式：get

请求示例：http://bkapi.com/api/GeneralLinkConvert?appkey=登录个人中心查看&tbname=xxxxx&pid=mm_xxxx_xxx_xxx&material_list=￥fgKHV6OYxaU￥&item_id_list=y28vooztRt2MPNa7BVcor5fduA-64ayZ7Ty6DnJWyqt9

请求方法

参数	是否必须	参数类型	说明
appkey	必填	String	登录后个人中心查看
tbname	必填	String	淘客账号所对应的用户名,见“个人中心”-“淘宝授权”
pid	必填	String	推广位PID（*必须是授权淘宝号下的推广位）
relation_id	必填	String	渠道管理ID
promotion_type	否	String	1-自购省，2-推广赚（代理模式专属ID，代理模式必填，其它模式不用填写本字段）
material_list	否	String	物料列表，可以为url或淘口令,多个时使用英文逗号拼接传入
seller_id_list	否	String	卖家ID列表,多个时使用英文逗号拼接传入
item_id_list	否	String	商品ID列表,多个时使用英文逗号拼接传入
page_id_list	否	String	会场ID列表,多个时使用英文逗号拼接传入

响应参数：

点击查看淘宝官方文档(源数据返回)

参数	类型	说明
data	Json	返回数据
├　material_url_list	material_url_list[]	转链结果
├ ├　msg	String	物料对应错误描述
├ ├　code	String	物料对应错误码
├ ├　promotion_info_dto	String	营销信息
├ ├ ├　commission_rate	String	佣金率
├ ├　coupon_info_dto	String	券信息
├ ├ ├　coupon_end_time	String	优惠券结束时间
├ ├ ├　activity_id	String	券ID
├ ├ ├　coupon_remain_count	String	优惠券剩余数量
├ ├ ├　coupon_amount	String	券面额
├ ├ ├　coupon_start_time	String	优惠券开始时间
├ ├ ├　coupon_desc	String	优惠券信息，满XX元减XX元
├ ├ ├　coupon_type	String	0-店铺 1-单品
├ ├　link_info_dto	String	链接信息
├ ├ ├　coupon_long_url	String	二合一长链接
├ ├ ├　material_type	String	1—单品 2—店铺 3—会场 4-承接开放 5-优惠券
├ ├ ├　tpwd_origin_url	String	淘口令原始链接，入参物料不为淘口令时，此字段返回null
├ ├ ├　material_id	String	物料ID，需根据material_type判断物料类型，可能为商品ID、卖家ID、会场ID
├ ├ ├　cps_long_url	String	CPS链接长链
├ ├ ├　cps_short_tpwd	String	CPS链接的短口令
├ ├ ├　tk_biz_type	String	1-联盟口令，2-主站口令。入参物料不为淘口令时，此字段返回null
├ ├ ├　coupon_short_tpwd	String	二合一链接的短口令
├ ├ ├　cps_short_url	String	CPS链接短链
├ ├ ├　coupon_short_url	String	二合一链接长链
├ ├ ├　coupon_full_tpwd	String	二合一链接的长口令
├ ├ ├　cps_full_tpwd	String	CPS链接的长口令
├　shop_url_list	shop_url_list[]	店铺转链结果
├ ├　msg	String	物料对应错误描述
├ ├　code	String	物料对应错误码
├ ├　link_info_dto	String	链接信息
├ ├ ├　material_type	String	1—单品 2—店铺 3—会场
├ ├ ├　seller_id	String	卖家ID
├ ├ ├　cps_long_url	String	店铺CPS长链接
├ ├ ├　cps_short_tpwd	String	店铺CPS链接对应短口令
├ ├ ├　cps_short_url	String	店铺CPS短链
├ ├ ├　cps_full_tpwd	String	店铺CPS链接对应长口令
├　event_url_list	event_url_list[]	活动转链信息
├ ├　link_info_dto	Json	链接信息
├ ├ ├　material_type	String	1—单品 2—店铺 3—会场
├ ├ ├　page_id	String	会场ID
├ ├ ├　cps_long_url	String	会场CPS长链接
├ ├ ├　cps_short_tpwd	String	会场CPS链接的短口令
├ ├ ├　cps_short_url	String	会场CPS短链接
├ ├ ├　cps_full_tpwd	String	会场CPS链接的长口令
├　item_url_list	item_url_list[]	单品转链信息
├ ├　promotion_info_dto	String	营销信息
├ ├ ├　commission_rate	String	佣金率
├ ├　coupon_info_dto	String	券信息
├ ├ ├　coupon_end_time	String	优惠券结束时间
├ ├ ├　activity_id	String	券ID
├ ├ ├　coupon_remain_count	String	优惠券剩余数量
├ ├ ├　coupon_amount	String	券面额
├ ├ ├　coupon_start_time	String	优惠券开始时间
├ ├ ├　coupon_desc	String	优惠券信息，满XX元减XX元
├ ├　link_info_dto	String	链接信息
├ ├ ├　coupon_long_url	String	二合一长链接
├ ├ ├　material_type	String	1—单品 2—店铺 3—会场
├ ├ ├　item_id	String	商品ID
├ ├ ├　cps_long_url	String	CPS链接长链
├ ├ ├　cps_short_tpwd	String	CPS链接的短口令
├ ├ ├　coupon_short_tpwd	String	二合一链接的短口令
├ ├ ├　cps_short_url	String	CPS链接短链
├ ├ ├　coupon_short_url	String	二合一链接长链
├ ├ ├　coupon_full_tpwd	String	二合一链接的长口令
├ ├ ├　cps_full_tpwd	String	CPS链接的长口令

响应示例

                                                       

{
  "click_url": "https://s.click.taobao.com/t?union_le%3D%3D",
  "material_oss_url": "https://creative-material-public.oss-cn-shanghai.aliyuncs.com/a/p/20150318020022927.zip",
  "page_end_time": "2025-05-12",
  "page_name": "大牌美妆",
  "page_start_time": "2025-05-06",
  "terminal_type": "2"
}

code说明

code	说明
40001	服务不可用
50001	无结果
isv.invalid-parameter-adzone	入参adzone_id错误