API文档中心

热门接口：产品ID找同款全量维权查询万能转链字符串ID转换 （有API需求可联系本站）

免授权自定义会员运营SID跟单万能转链接口-仅支持淘客商品

调用权限：核心接口会员卡调用
 接口测试 
接口使用场景等说明：

本接口是在原万能转链接口generalconvert上做强化，基于会员运营ID（special_id，即sid）来跟单。可以实现不需要用户授权（静默授权）、也可以自定义新用户参数(eid)实现跟单。


【适合场景】

微信、微博、抖音、快手、QQ等私域需要静默授权的场景。


一、自定义跟单实现方式：

当您的APP/小程序等应用有新用户时，传给本接口external_id（简称eid），可以自定义30位以内的英文、数字跟单归因参数。新用户您可以通过查询您的联盟帐号会员ID来取得其SID。

本接口配合渠道信息查询接口publisherget：https://www.veapi.cn/apidoc/taobaolianmeng/116

详情请参考使用步骤说明。


本接口是基于会员运营SID来跟单，它基于联盟的营销商品库才能转链，但现在营销商品库和淘宝联盟商品库基本一致。因此影响不大。

可以使用商品详情接口（接口地址）返回值material_lib_type=1来判断是否为营销商品库的。

或在本接口添加detail=1参数时，也会返回该字段。


二、使用步骤：

（一）创建eid：

1、对于你的新用户，调用本接口，传入eid，如：

http://api.veapi.cn/tbk/trackconvert?vekey=xxx&para=￥thyrf8OJWhF￥&external_id=new20251114001&needpwd=1&external_type=1

2、用户领取口令或链接下单，此过程免去授权。

3、调用渠道信息查询接口publisherget（接口地址），注意该接口入参info_type=2且external_type必须和上面一致。如：

api.veapi.cn/tbk/publisherget?vekey=xxx&info_type=2&page_size=20&external_type=1

返回值示例：

4、获得special_id，如上图3274652232，即该新用户的sid（自购的情况下）

5、查询会员运营的订单接口（order_scene=3），获得订单SID，跟单成功。

【注意】只能自购，因为订单中返回的sid是下单者淘宝号的sid，而不是转链者的SID。



二、注意事项：

（1）接口生成的淘口令或链接，仅适合于用户自己购买。当分发给别人下单时，订单中返回的sid是别人下单的淘宝号对应的sid，而不是创建淘口令或链接的人。

（2）external_id是唯一的，一旦给予该用户并且用户复制口令或打开链接跳到手淘APP，则external_id在淘宝联盟中生成，则该external_id不可再用，否则跟单失败。

（3）当该用户使用过eid后，即可通过渠道信息查询接口获得其sid，第二次转链直接使用sid，不可再用eid。

（4）本接口仅支持商品ID转链跟单，不支持活动、店铺等参数转链。

（5）当您之前依赖渠道RID跟单，则可以暂时保留原方案，二者并且一段时间后再完全切换。

调用说明

本接口需要您在会员中心授权（如果多用户可传入sessionkey参数）

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/tbk/trackconvert 暂无

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
para String 是 ￥TA1WdUtzfbP￥ 各类产品类参数：如手淘分享的整段文案、或产品数字ID或字符串ID、或链接等十多种参数，参考指引说明，请urlencode编码后传参
pid String 否 mm_11_22_33 会员专属PID推广位。如在维易会员中心有设置PID可不传参，否则必须传参。获取路径：淘宝联盟后台—推广管理—会员运营管理，注意会员专属推广位只有20个名额，创建后再删除不可恢复，因此创建后不要再删除PID。
external_id String 否 member0001 自定义首次跟单参数（简称eid），它必须和special_id至少要提供一个。
special_id Number 否 688441233 会员运营ID（简称sid），您的老用户第二次以后转链下单，需要使用本参数跟单。当你传了本参数时，这样下单时才有透出会员运营ID。
external_type Number 否 1 淘宝客其他平台私域用户自定义标记：1-微信、2-微博、3-抖音、4-快手、5-QQ，0-其他。【注意】当您查询渠道信息时，也必须指定external_type同样的值才可以查到。
needpwd Number 否 1 可选值0或1，默认0，是否在返回值字段special_create_url下的免授权链接生成淘口令，默认不生成。
op_type Number 否 1或2 可选值1或2，默认1，指定为2时无法生成淘口令即needpwd=0：授权类型，选2时可用于更新外部用户标记，默认1：1-新绑，2-更新。
globaltpwd Number 否 1 可选值0或1，是否生成IOS和安卓通用的简易淘口令，但这里的淘口令不是免授权的口令
promotion_type Number 否 1 请按新字符串ID政策正确传参。可选值 1-自购省，2-推广赚（代理模式专属ID，代理模式是，非代理模式不用填写该字段）
detail Number 否 默认0 可选值1或2，推荐设置为1，当返回值中material_lib_type=1时表示营销商品库。表示需要更多产品信息的字段。获取到手价、促销信息、百亿补贴等更完整信息，相关字段含义参考商品详情；值1比2多了一个会员运营营销库商品字段（material_lib_type=1即为营销库产品）,如果不需要该字段则推荐detail为2。注意，返回值中如果含有final_promotion_target_type字段，则转链的链接将跳转到直播间。
required_link_type String 否 cps_short_tpwd,coupon_short_url 指定字段，一般仅双11等大促时使用。不入参默认返回全部字段【特殊说明的频道页链接除外】。为提升接口响应时效，建议入参必要返回字段，可选值有：coupon_long_url, cps_long_url, cps_short_tpwd, coupon_short_tpwd, cps_short_url, coupon_short_url, coupon_full_tpwd, cps_full_tpwd, share_unit_url, tao_brick_url。当通过para或item_dto入参获取品带红包时，本参数可以选择性入参超红链接相关字段（coupon_supered_long_url、coupon_supered_long_tpwd、coupon_supered_short_url、coupon_supered_short_tpwd、cps_supered_long_url、cps_supered_long_tpwd、cps_supered_short_url、cps_supered_short_tpwd）
lastpagefield String 否 coupon_long_url 用于生成免授权的链接和淘口令万能转链字段，默认是coupon_long_url，在“coupon_long_url,coupon_short_url,cps_long_url,cps_short_url,coupon_supered_long_url,coupon_supered_short_url,cps_supered_long_url,cps_supered_short_url”这几个中选一个。如果入参有required_link_type，则必须是required_link_type中的一个。
account_id String 否 联盟帐号ID 联盟帐号ID值，当一个维易号会员中心有2个以上联盟授权时，本参数指定要转链的联盟号，这时pid参数要和联盟号一致。请到会员中心授权页查看联盟号ID值
sessionkey String 否 7002455622... 淘客授权字串,本参数仅限多用户版，当您的接口卡是多用户版时，请提供本参数和对应联盟号的Pid参数

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/trackconvert?vekey=xxx&para=￥thyrf8OJWhF￥&special_id=tb20251115&needpwd=1 

【例子】生成指定eid值免授权链接
http://api.veapi.cn/tbk/trackconvert?vekey=xxx&para=￥thyrf8OJWhF￥&external_id=tb20251115&needpwd=1&external_type=1
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/tbk/trackconvert?vekey=xxx&para=￥thyrf8OJWhF￥&special_id=tb20251115&needpwd=1";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流，不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool，以hutool为例：

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/tbk/trackconvert?vekey=xxx&para=￥thyrf8OJWhF￥&special_id=tb20251115&needpwd=1";
        // JDK 8u111版本后，若目标页面为HTTPS协议，请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时，毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests，支持访问http,https网页：

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/tbk/trackconvert?vekey=xxx&para=￥thyrf8OJWhF￥&special_id=tb20251115&needpwd=1"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值（JSON）

参数名称 参数类型 示例值 描述
parse_type Number 1 转链类型（material_type）：1—单品 2—店铺 3—会场 4-承接开放 5-优惠券 6-直播间 7-淘积木页
result Number 1 是否有券：1该产品有优惠券，2该产品无券,0表示当前为非商品（比如店铺转链或会场转链）【说明】本字段值1或2决定了下面coupon_short_url或coupon_long_url二合一链接，还是cps_short_url 或 cps_long_url直跳详情页的链接，您要用哪一个链接跳转。
is_bybt Number 1 是否为百亿补贴：0不是，1是百亿补贴。【说明】该字段和result一样，本字段值0或1决定了下面coupon_short_url或coupon_long_url二合一链接，还是cps_short_url 或 cps_long_url直跳详情页的链接，您要用哪一个链接跳转。
special_create_url Obj [] 免授权链接和淘口令
 └─ url String https://mo.m.taobao.com/.... 免授权链接，可用它打开手淘跳转到lastpagefield入参指定的字段URL页面
 └─ short_tpwd String ￥D2lyfQvE1HD￥ 安卓适用的短口令
 └─ ios_long_tpwd String 68￥ MF278 D2lyfQvE1HD￥ https://m.tb.cn/h.StSGRY6 厨房水槽过滤网防堵水池杂物垃圾袋洗菜盆隔水水切袋网 100只装 IOS系统可用的长口令
 └─ global_short_tpwd String 0￥ CZ3457 D2lyfQvE1HD￥/ IOS和安卓通用的短口令
istaote Number 0 是否为淘特产品，0否，1是，用于判断你的APP等应用是要跳到手淘APP还是淘特APP
original_para_id String 56642522332 商品入参的原始商品ID
commission_rate String 6.00 佣金率
activity_id String 19d114f1a6464c98a30b01b3cb17dad6 优惠券ID
coupon_remain_count Number 99944 优惠券剩余数量
coupon_amount String 80.00 券面额
coupon_start_time String 2022-12-14 00:00:00 优惠券开始时间
coupon_end_time String 2022-12-20 23:59:59 优惠券结束时间
coupon_desc String 满129元减80元 优惠券信息，满XX元减XX元
coupon_type Number 0 0-店铺 1-单品，该字段不一定出现
coupon_short_tpwd String ￥p7lYdesjTCG￥ 商品、店铺或活动会场的二合一链接的短口令
coupon_short_url String https://s.click.taobao.com/DvHjOPu 二合一链接短链。【说明】coupon_开头是二合一页面链接，当商品没有优惠券时，跳到这个二合一页面会提示优惠券失效，影响用户体验，这时可以用 cps_short_url 或 cps_long_url 这两个链接。可用result=1或2来判断是否有券，进而决定用哪一个链接跳转
coupon_full_tpwd String 47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA 爆肚粉香辣花甲 二合一链接的长口令
coupon_long_url String https://uland.taobao.com/coupon/edetail?e=.. 二合一长链接。【说明】coupon_开头是二合一页面链接，当商品没有优惠券时，跳到这个二合一页面会提示优惠券失效，影响用户体验，这时可以用 cps_short_url 或 cps_long_url 这两个链接。可用result=1或2来判断是否有券，进而决定用哪一个链接跳转
cps_long_url String https://s.click.taobao.com/t?e=m2.. 商品、店铺或活动会场的CPS链接长链。这个是带有您推广信息的直接跳到商品详情页或店铺、会场等落地页的链接。当转链的是商品时，本链接会跳过优惠券领取的二合一页面直接进入商品页。
cps_short_tpwd String ￥zRmVdesjTCu￥ CPS链接的短口令
cps_short_url String https://s.click.taobao.com/CvHjOPu CPS链接短链。当转链的是商品时，本链接会跳过优惠券领取的二合一页面直接进入商品页。
cps_full_tpwd String 39￥ CZ3457 zRmVdesjTCu￥ https://m.tb.cn/h.UQ4cewa 粉条六袋装 CPS链接的长口令
coupon_channel_url String https://uland.taobao.com/coupon/edetail?e=Hc... 频道片二合一链接，必须在required_link_type字段入参才可出参 目前支持淘金币
coupon_channel_tpwd String 47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA 我的天呐麻酱爆肚粉香辣花甲 频道页二合一口令，必须在required_link_type字段入参才可出参 目前支持淘金币
cps_channel_url String https://s.click.taobao.com/t?e=m%3D... 频道页CPS链接，必须在required_link_type字段入参才可出参 目前支持淘金币
cps_channel_tpwd String 47￥ CZ3457 XODHdeIlU9B￥ https://m.tb.cn/h.UQ4ceEy olayks煮茶器喷淋式黑茶白茶 频道页CPS口令，必须在required_link_type字段入参才可出参 目前支持淘金币
coupon_supered_long_url String https://uland.taobao.com/coup... 超红二合一长链接，必须在required_link_type字段入参才可出参
coupon_supered_short_url String https://s.click.taobao.com/HvHjOPu 超红二合一短链接，必须在required_link_type字段入参才可出参
coupon_supered_long_tpwd String 47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA 我的天呐麻酱爆肚粉香辣花甲 超红二合一长口令，必须在required_link_type字段入参才可出参
coupon_supered_short_tpwd String ￥LOcqdeIlU9y￥ 超红二合一短口令，必须在required_link_type字段入参才可出参
cps_supered_long_url String https://s.click.taobao.com/t?e... 超红cps长链接，必须在required_link_type字段入参才可出参
cps_supered_short_url String https://s.click.taobao.com/HvHjOPu 超红cps短链接，必须在required_link_type字段入参才可出参
cps_supered_long_tpwd String 47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA 我的天呐麻酱爆肚粉香辣花甲 超红cps长口令，必须在required_link_type字段入参才可出参
cps_supered_short_tpwd String ￥LOcqdeIlU9y￥ 超红cps短口令，必须在required_link_type字段入参才可出参
tk_biz_type Number 2 1-联盟口令，2-主站口令。入参物料不为淘口令时，此字段返回null
item_id String y387e62Ozub0TvtA-dAeOMBinu0 商品ID
seller_id String 123456 卖家ID
global_tpwd Obj   简短的IOS和安卓通用的口令。当您双11等大促期间通过required_link_type传入coupon_supered_long_url等带“_supered_”品带红字段时，这里返回的淘口令也是品带红的。如果不传带“_supered_”品带红字段时，则这里返回的是普通的二合一淘口令或CPS淘口令。本字段仅当返回了cps_short_tpwd,coupon_short_tpwd等带淘口令的字段后，才会返回，因此如果需要此字段，在指定required_link_type时，请加上带“_tpwd”的字段
 └─ coupon_full_tpwd String 2￥ CZ3457 Y16vf3fDd27￥/ 跳到二合一的IOS和安卓通用的口令，受required_link_type影响，不一定会出现该字段，请做好判断
 └─ cps_full_tpwd String 7￥ CZ3457 tih1f3fC2nB￥/ 直接跳转详情页的IOS和安卓通用的口令，受required_link_type影响，不一定会出现该字段，请做好判断
page_id String 20150318020014311 会场ID
material_id String 688401422805 物料ID，需根据material_type判断物料类型，可能为商品ID、卖家ID、会场ID
isv_mktid String aisjd8-8asdbaiu 根据入参工具服务商账号信息生成的新商品ID
tpwd_origin_url String https://item.taobao.com/item.htm?ut_sk=1.Xhm.. 淘口令原始链接，入参物料不为淘口令时，此字段返回null
multiple_items_prices_count Number 2 多件价需拍件数
multiple_items_coupon_info_list Obj[]   多件价券信息
 └─ coupon_title String 商品券 优惠名称
 └─ coupon_desc String 满7999减1300 优惠券信息，满XX元减XX元，满x件减y元
 └─ coupoon_fee String 1300.00 优惠金额。单位元
 └─ coupon_start_time String 2022-12-14 00:00:00 优惠开始时间
 └─ coupon_end_time String 2022-12-15 00:00:00 优惠结束时间
 └─ activity_id String 19d114f1a6464c98a30b01b3cb17dad6 优惠ID
 └─ coupon_remain_count Number 99987 优惠剩余数量

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "免授权跟单万能解析转链成功", "parse_type": 1, "result": 2, "is_bybt": 0, "data": { "special_create_url": { "url": "https://mo.m.taobao.com/union/sidmark/record?externalType=1&s=9a9be4fa7ceca4c1d37a67dfdabe453f&opType=1&externalId=tbgjr20251115&appkey=25016850&targetUrl=https%3A%2F%2Fs.click.taobao.com%2FsP23Zfp&memberId=98723245", "short_tpwd": "￥DelyfQvEHHD￥", "ios_long_tpwd": "68￥ MF278 DelyfQvEHHD￥ https://m.tb.cn/h.StSGRY6 厨房水槽过滤网防堵水池杂物垃圾袋洗菜盆隔水水切袋网 100只装", "global_short_tpwd": "0￥ CZ3457 DelyfQvEHHD￥/" }, "input_item_id": "dkGeXjrTZtMdRwqhDVvset3-zwP87pfoXZdwVNofJo", "coupon_full_tpwd": "38￥ tG-#22>lD gWvRfQvEaPQ￥ https://m.tb.cn/h.StMYw7e 厨房水槽过滤网防堵水池杂物垃圾袋洗菜盆隔水水切袋网 100只装", "coupon_long_url": "https://uland.taobao.com/coupon/edetail?e=urLxlOHTpjhdoqAawkp85SAd78rJKA5EEHGbjhgs%2FwkXh%2Bc%2FyvXzgarv62pStmra0HPrsq9UYvESH0k8JGbTLGruZul07Jud0Q3UoftrTi6mgdu7NnFh%2BdpsAmOX0u61M7KjN4EIDPhOsGyT%2F3dcraDREMYzBlwEpR4itQNy4SdMGJQ2jBkJvEPj5pK1uudUdjig60zZ9p7I3HcMgtWQsOxGBGKVXAuGpapcS64kFXJLfgIwr76UAoi%2B3SeP7Ov0ltW6GxnVnIMFqPcie51JcyYI2DDgLmC8mhX6HzpVvI7LFl23ELNCiKJ7%2BkHL3AEW&traceId=2104d41917631936240504027e39c4&&union_lens=lensId:TAPI@1763193624@210474bb_13fd_19a86879646_3706@01", "coupon_short_tpwd": "￥gWvRfQvEaPQ￥", "coupon_short_url": "https://s.click.taobao.com/sP23Zfp", "cps_full_tpwd": "09￥ MF937 kJXEfQvwQSr￥ https://m.tb.cn/h.StMYGff 厨房水槽过滤网防堵水池杂物垃圾袋洗菜盆隔水水切袋网 100只装", "cps_long_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DX%2FSBupkiRV1w4vFB6t2Z2ueEDrYVVa64XoO8tOebS%2BdRAdhuF14FMbQMJonMwdABxq3IhSJN6GQNx086yGXKPo4Zysf8ZgaTadG7MoM0vuV794d%2BrfpI3DJ8dhCdsJRshXCEiyvUOUCBv1l5JlezioEte5UcyzGkjEyv65DnXeASWPjbnG%2Bw6jHcQJA%2FPO%2BywQjJEsdaVO6zPCROC%2FPzG1%2FWNast11U3eHswlo7aBcL7ypPz49QWxZMibMpkWOTS0ZQT5HHODMpkCWFS9VAMIdNl6%2BNlWG2qyBNmcjbUX%2BrGJe8N%2FwNpGw%3D%3D&union_lens=lensId:TAPI@1763193624@210474bb_13fd_19a86879646_3706@01", "cps_short_tpwd": "￥kJXEfQvwQSr￥", "cps_short_url": "https://s.click.taobao.com/JOv5ITp", "isv_mktid": "pR43XAsxtQARQaugqofptm-zwP87pfoXZdwVNofJo", "item_id": "WKeJGbrCot24QRO9zBUrWqiVUa-zwP87pfoXZdwVNofJo", "material_type": "1", "istaote": 0, "commission_rate": "1.80", "commission_type": "COMMON", "promotion_price": "201", "original_para_id": "dkGeXjrTZtMdRwqhDVvset3-zwP87pfoXZdwVNofJo" }, "request_id": "uLVIJV1" }

错误码

如果error不为0时，请点此查看错误码表格

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部