拼多多商品详情查询接口(多多客商品专用,不可根据个人等级显示佣金比例,非全网)
15555人使用

本接口用于查询某个商品的详情信息:
商品标题、商品描述、商品分类/标签、最小拼团价、最小单买价、商品历史累计售卖件数(模糊值,string类型,非数值)、优惠券金额、优惠券数量、优惠券剩余数量、优惠券门槛、优惠券有效期、商品评价分、商品评价数量、佣金比例、商品轮播图

特别注意!特别注意!特别注意!

目前接口里面是按照100%佣金来显示,需要自己计算根据自己的比例!

佣金政策调整:V0等级渠道分成佣金为基础佣金的70%,V1等级渠道分成佣金为基础佣金的85%。账号所处等级及对应的佣金政策可在多多进宝网站(https://jinbao.pinduoduo.com/level-right)查看



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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

goods_sign

STRING

c9n2ugZxdDpP2PPhwfDY-mmFDlA7_JKwNYDrDm

商品goodsSign,支持通过goodsSign查询商品。goodsSign是加密后的goodsId, goodsId已下线,请使用goodsSign来替代

custom_parameters

STRING

自定义参数

pid

STRING

推广位id

search_id

STRING

搜索id

zs_duo_id

LONG

招商多多客ID

返回参数说明

标记

类型

例子

说明

category_id

LONG

商品类目ID

category_name

STRING

商品类目名

cat_id

LONG

商品类目ID

cat_ids

INTEGER[]

商品一~四级类目ID列表

clt_cpn_batch_sn

STRING

店铺收藏券id

clt_cpn_discount

LONG

店铺收藏券面额,单位为分

clt_cpn_end_time

LONG

店铺收藏券截止时间

clt_cpn_min_amt

LONG

店铺收藏券使用门槛价格,单位为分

clt_cpn_quantity

LONG

店铺收藏券总量

clt_cpn_remain_quantity

LONG

店铺收藏券剩余量

clt_cpn_start_time

LONG

店铺收藏券起始时间

coupon_discount

LONG

优惠券面额,单位为分

coupon_end_time

LONG

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

coupon_min_order_amount

LONG

优惠券门槛金额,单位为分

coupon_remain_quantity

LONG

优惠券剩余数量

coupon_start_time

LONG

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

coupon_total_quantity

LONG

优惠券总数量

create_at

LONG

创建时间(unix时间戳)

desc_txt

STRING

描述分

goods_desc

STRING

参与多多进宝的商品描述

goods_gallery_urls

STRING[]

商品轮播图

goods_id

LONG

参与多多进宝的商品ID

goods_image_url

STRING

多多进宝商品主图

goods_name

STRING

参与多多进宝的商品标题

goods_thumbnail_url

STRING

商品缩略图

has_coupon

BOOLEAN

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

has_mall_coupon

BOOLEAN

是否有店铺券

lgst_txt

STRING

物流分

mall_coupon_discount_pct

INTEGER

店铺折扣

mall_coupon_end_time

LONG

店铺券使用结束时间

mall_coupon_max_discount_amount

INTEGER

最大使用金额

mall_coupon_min_order_amount

INTEGER

最小使用金额

mall_coupon_remain_quantity

LONG

店铺券余量

mall_coupon_start_time

LONG

店铺券使用开始时间

mall_coupon_total_quantity

LONG

店铺券总量

mall_cps

INTEGER

该商品所在店铺是否参与全店推广,0:否,1:是

mall_id

LONG

商家id

mall_name

STRING

店铺名称

merchant_type

INTEGER

店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)

min_group_price

LONG

最低价sku的拼团价,单位为分

min_normal_price

LONG

最低价sku的单买价,单位为分

only_scene_auth

BOOLEAN

快手专享

opt_id

LONG

商品标签ID

opt_ids

STRING

商品标签名称

plan_type

INTEGER

推广计划类型

promotion_rate

LONG

佣金比例,千分比

sales_tip

STRING

已售卖件数

service_tags

INTEGER[]

服务标签: 4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,1可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装

serv_txt

STRING

服务分

zs_duo_id

LONG

招商团长id

video_urls

STRING[]

商品视频url

predict_promotion_rate

LONG

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

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":[
        {
            "mall_coupon_remain_quantity":0,
            "plan_type":4,
            "category_name":"男装",
            "coupon_remain_quantity":1000,
            "promotion_rate":200,
            "cat_ids":[
                239,
                7295,
                7307
            ],
            "coupon_min_order_amount":3000,
            "category_id":11841,
            "service_tags":[
                13
            ],
            "mall_coupon_discount_pct":0,
            "mall_id":803396073,
            "mall_name":"富贵鸟双鱼传奇专卖店",
            "coupon_total_quantity":3000,
            "mall_coupon_end_time":0,
            "mall_coupon_min_order_amount":0,
            "merchant_type":4,
            "lgst_txt":"高",
            "goods_name":"富贵鸟夏季休闲裤男超薄透气韩版潮流束脚裤男士宽松大码运动裤男",
            "sales_tip":"4.6万",
            "only_scene_auth":false,
            "goods_gallery_urls":[
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/ed60e890-725c-4530-95b1-a4e47b64786b.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-05-18/ef8c41bb-5f90-46cd-a7d7-cea400846301.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/ddf05024-aae5-46c7-a171-8429c6aafdf3.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/f3909b60-8e9a-4587-acd1-82bc60ca90dc.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-05-10/1cfead76-d2c8-4d00-a863-cf4ad6676e64.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-05-10/7246d79d-fc5b-4ace-bec3-6ff2f77146f8.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/4c348ac7-69fc-421e-af98-071e414f11c3.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/8dc265ac-81ac-4766-9155-61b6bf3cf731.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/fee6dd87-65d4-4e09-9fa3-2c83bfdb3c01.jpg",
                "https://t00img.yangkeduo.com/goods/images/2020-03-17/b42726c6-f931-4675-b11d-eaa1349c9a6d.jpg"
            ],
            "goods_id":94696453795,
            "desc_txt":"高",
            "goods_desc":"富贵鸟专柜正品  弹力蚂蚁皱面料 不起球不褪色 支持7天无理由退换货",
            "opt_name":"男装",
            "goods_thumbnail_url":"https://t00img.yangkeduo.com/goods/images/2020-03-18/9ace6dfb27cfa7ca627318e7343cd757.jpeg",
            "opt_ids":[
                11841,
                11012,
                8581,
                4869,
                8582,
                20550,
                8583,
                3399,
                10696,
                3401,
                3403,
                10763,
                12,
                20492,
                9805,
                3405,
                3406,
                10703,
                9807,
                2575,
                10902,
                9816,
                9818,
                2587,
                347,
                23963,
                9820,
                349,
                1309,
                8799,
                225,
                2211,
                2212,
                1829,
                743,
                12200,
                20524,
                10733,
                4855,
                11896,
                1272,
                8569,
                8570,
                11898,
                8571,
                1277
            ],
            "opt_id":11841,
            "goods_image_url":"https://t00img.yangkeduo.com/goods/images/2020-03-17/ed60e890-725c-4530-95b1-a4e47b64786b.jpg",
            "has_mall_coupon":false,
            "has_coupon":true,
            "min_normal_price":5900,
            "mall_coupon_start_time":0,
            "serv_txt":"高",
            "video_urls":[
            ],
            "mall_coupon_total_quantity":0,
            "mall_coupon_max_discount_amount":0,
            "coupon_start_time":1591632000,
            "min_group_price":4900,
            "mall_cps":1,
            "coupon_discount":3000,
            "coupon_end_time":1591804799,
            "zs_duo_id":8771079
        }
    ]
}
			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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