淘宝客高级API
淘宝客解析api(万能解析-新版-套餐版)
需要授权
459人使用

物料链接,可以为url或淘口令

接口地址: http://api.tbk.dingdanxia.com/tbk/general_parse 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

material_url

String

物料链接,可以为url或淘口令

relation_id

Number

渠道管理ID(如是主站选品推广场景,必须入参该字段,且bizSceneId字段需入参2-消费者比价场景,否则二次转链失败),获取地址:https://www.dingdanxia.com/article/237.html

pid

String

mm_

渠道专属pid

fields

String

有origin_pid使用场景需入参

返回参数说明

标记

类型

例子

说明

material_type

Number

1

1—商品 2—店铺 3—会场 4-承接开放 5-优惠券 6-直播间

tpwd_origin_url

String

入参口令/链接对应的原链接

material_id

String

物料ID,需根据material_type判断物料类型, 可能为商品ID、卖家ID、会场ID

tk_biz_type

Number

1-联盟口令,2-主站口令。入参物料不为淘口令时,此字段返回null

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "material_url_list": {
            "material_url_list": [
                {
                    "input_material_url": "https://e.tb.cn/h.TmgUCMLJsPJM0s3?tk=wIdUeVyjJli",
                    "link_info_dto": {
                        "material_id": "738367832434",
                        "material_type": 1,
                        "tpwd_origin_url": "https://item.taobao.com/item.htm?ut_sk=1.WhDtxTkPGC8DAEexCgEW121q_21380790_1737777190741.Copy.1&id=738367832434&sourceType=item&price=177.26-194.56&suid=71C22626-F140-46A3-A556-89858D7B9ED4&shareUniqueId=30289698889&un=22d485f57e8de53b6a11a1a3de17bebf&share_crt_v=1&un_site=0&spm=a2159r.13376460.0.0&wxsign=tbwRtXh-lWMyClwNvuyHGZEwNI-ucM0_Ve3dKS6diYVwZFqdb8SRk0j0srDhYg5tur4lVtnNcfzcp89KIUCBuiyawCruHSFI6KDp-RDkz2iGIBoMqebJ2flopgrYnuB_NhD&tbSocialPopKey=shareItem&sp_tk=d0lkVWVWeWpKbGk%3D&bxsign=tcd_d5TRJ-QpPUEk-YPvoZQYYM_CU4ZCLdja0KLmMkISZz3qUJB5Vnumg8EUYTCwtPOLJEw4WpphWOrMFjzOUXfVpOAV9beSNI3jmmv38RsqfE&bc_fl_src=share-694376183468-1-0"
                    }
                }
            ]
        }
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。