拼多多商品转链api接口(商品goods_sign版)【升级版】
需要授权
4284人使用

根据拼多多商品ID生成多种推广链接,唤起微信推广链接、唤起拼多多客户端推广链接、唤起微博客户端推广链接、小程序推广链接。

参数itemInfo=true 可返回商品基本信息,包含标题、ID、价格、佣金、优惠券等信息

注意:p_id与custom_paramters参数组合只能绑定一个用户,一个用户可以绑定多个p_id与custom_paramters参数组合。(为了避免重复绑定,建议p_id与custom_paramters参数组合唯一映射)

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

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

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

p_id

String

8735184_70977074

推广位ID

goods_sign

String

c972ugZxdDpP2PPhwfDYjg1hCxiR_JKwNYDrDm

商品goodsSign,推荐使用,可走最优计划

cash_gift_id

LONG

多多礼金ID

cash_gift_name

STRING

自定义礼金标题,用于向用户展示渠道专属福利,不超过12个字

custom_parameters

String

test

自定义参数,为链接打上自定义标签。自定义参数最长限制64个字节。

itemInfo

Boolean

true

是否返回商品信息 包含商品标题、ID、价格、佣金、优惠券信息

generate_authority_url

String

是否生成带授权的单品链接。如果未授权,则会走授权流程,true =》生成

generate_short_url

Boolean

true

是否生成短链接

multi_group

Boolean

true

true--生成多人团推广链接 false--生成单人团推广链接(默认false)1、单人团推广链接:用户访问单人团推广链接,可直接购买商品无需拼团。2、多人团推广链接:用户访问双人团推广链接开团,若用户分享给他人参团,则开团者和参团者的佣金均结算给推手

generate_weapp_webview

Boolean

false

是否生成唤起微信客户端链接,true-是,false-否,默认false

zs_duo_id

String

招商多多客ID

generate_we_app

Boolean

true

是否生成小程序推广

generate_weiboapp_webview

Boolean

false

是否生成微博推广

generate_mall_collect_coupon

Boolean

true

是否生成店铺收藏券推广链接

generate_qq_app

Boolean

true

是否生成qq小程序

generate_schema_url

Boolean

true

是否返回 schema URL

search_id

STRING

搜索id,建议填写,提高收益,通过搜索接口获取

force_duo_id

BOOLEAN

是否使用多多客专属推广计划

pdd_auth_id

String

多授权,切换授权参数

goods_id_list

String

商品ID,不建议使用,请优先使用goods_sign

返回参数说明

标记

类型

例子

说明

we_app_web_view_short_url

String

唤起微信app推广短链接

we_app_web_view_url

String

唤起微信app推广链接

mobile_short_url

String

唤醒拼多多app的推广短链接

mobile_url

String

唤醒拼多多app的推广长链接

short_url

String

推广短链接

url

String

推广长链接

we_app_info

String[]

小程序信息

we_app_icon_url

String

小程序图片

banner_url

String

Banner图

desc

String

描述

source_display_name

String

来源名

page_path

String

小程序path值

user_name

String

用户名

title

String

小程序标题

app_id

String

拼多多小程序id

weibo_app_web_view_short_url

String

唤起微博app推广短链接

weibo_app_web_view_url

String

唤起微博app推广链接

schema_url

String

schema的链接

we_app_info

OBJECT

小程序信息

L app_id

String

拼多多小程序id

L banner_url

String

Banner图

L desc

String

描述

L page_path

String

小程序path值

L source_display_name

String

来源名

L title

String

小程序标题

L user_name

String

用户名

L we_app_icon_url

String

小程序图片

itemInfo

OBJECT

商品基本信息 itemInfo=true 才会出

L goods_name

String

商品名称

L goods_id

LONG

商品ID

L min_normal_price

LONG

最小单买价格(单位为分)

L min_group_price

LONG

最小拼团价(单位为分)

L promotion_rate

LONG

佣金比例,千分比

L predict_promotion_rate

LONG

比价行为预判定佣金,需要用户备案

L has_coupon

BOOLEAN

商品是否有优惠券 true-有,false-没有

L coupon_min_order_amount

LONG

优惠券门槛价格,单位为分

L coupon_discount

LONG

优惠券面额,单位为分

L coupon_total_quantity

LONG

优惠券总数量

L coupon_remain_quantity

LONG

优惠券剩余数量

L coupon_start_time

LONG

优惠券生效时间,UNIX时间戳

L coupon_end_time

LONG

优惠券失效时间,UNIX时间戳

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"weibo_app_web_view_short_url": "https://p.pinduoduo.com/I1UvpsnJ",
		"mobile_url": "https://mobile.yangkeduo.com/app.html?use_reload=1&launch_url=duo_coupon_landing.html%3Fgoods_id%3D104895318702%26pid%3D8735184_70977074%26authDuoId%3D8516041%26cpsSign%3DCC_200902_8735184_70977074_d45708cbbe264058105c78b012e54e0f%26duoduo_type%3D2&campaign=ddjb&cid=launch_dl_force_",
		"we_app_info": {
			"we_app_icon_url": "http://xcxcdn.yangkeduo.com/pdd_logo.png",
			"user_name": "gh_0e7477744313@app",
			"page_path": "package_a/welfare_coupon/welfare_coupon?goods_id=104895318702&pid=8735184_70977074&authDuoId=8516041&cpsSign=CC_200902_8735184_70977074_d45708cbbe264058105c78b012e54e0f&duoduo_type=2",
			"source_display_name": "拼多多",
			"title": "100%纯棉镂空短袖t恤女V领上衣2020新款韩版大码绣花百搭修身",
			"app_id": "wx32540bd863b27570",
			"desc": "拼多多,多实惠,多乐趣。"
		},
		"weibo_app_web_view_url": "https://mobile.yangkeduo.com/duo_coupon_landing.html?goods_id=104895318702&pid=8735184_70977074&authDuoId=8516041&cpsSign=CC_200902_8735184_70977074_d45708cbbe264058105c78b012e54e0f&duoduo_type=2&launch_weibo=1",
		"mobile_short_url": "https://p.pinduoduo.com/TaXvt4CK",
		"we_app_web_view_url": "https://mobile.yangkeduo.com/duo_coupon_landing.html?goods_id=104895318702&pid=8735184_70977074&authDuoId=8516041&cpsSign=CC_200902_8735184_70977074_d45708cbbe264058105c78b012e54e0f&duoduo_type=2",
		"url": "https://mobile.yangkeduo.com/duo_coupon_landing.html?goods_id=104895318702&pid=8735184_70977074&authDuoId=8516041&cpsSign=CC_200902_8735184_70977074_d45708cbbe264058105c78b012e54e0f&duoduo_type=2",
		"short_url": "https://p.pinduoduo.com/0qrvGdOS",
		"we_app_web_view_short_url": "https://p.pinduoduo.com/0qrvGdOS",
		"itemInfo": {
			"goods_name": "100%纯棉镂空短袖t恤女V领上衣2020新款韩版大码绣花百搭修身",
			"goods_id": 104895318702,
			"min_normal_price": 2790,
			"min_group_price": 2590,
			"promotion_rate": 200,
			"predict_promotion_rate": 200,
			"has_coupon": true,
			"coupon_min_order_amount": 1400,
			"coupon_discount": 1400,
			"coupon_total_quantity": 50000,
			"coupon_remain_quantity": 46000,
			"coupon_start_time": 1598716800,
			"coupon_end_time": 1599148799
		}
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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