拼多多API使用须知

多多进宝设置

蚂蚁星球推出开放API的目的在于，让具有开发能力的个人京东客，开发团队以及软件开发商更便捷的采集蚂蚁星球商品库的数据，实现优质好单的资源共享。使用蚂蚁星球开放API需要先申请apikey，您可以在本页面上方点击申请按钮或直接进入个人中心开放API页面申请，单个蚂蚁星球账号只能申请一个apikey。蚂蚁星球开放API是免费使用的，但蚂蚁星球保留对各接口进行调整的权利，我们会在调整时及时给予通知，也请您持续关注我们的公告。

联系技术支持：712218340 点击链接加入群聊【官方API交流群】(验证语：蚂蚁星球开放平台)

  • 商品列表
  • 商品详情
  • 分类列表
  • 标签列表
  • 转链API(支持备案)
  • 绑定备案查询
  • 订单查询
  • 多多进宝主题列表
  • 多多进宝主题商品
  • 运营频道商品
  • 主站频道推广接口
  • 营销工具推广(支持备案)
    • 详情
    • 错误参照代码

    • 接口地址： http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist

      支持格式： json

      请求方式： get/post

      请求示例： http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist?apikey=您的apikey&page=1&page_size=20

      请求参数说明：

      名称 类型 必填 说明
      apikey String 是 蚂蚁星球apikey，请将示例中的key替换成您的key
      page int 否 第几页（默认第1页）
      page_size int 否 1-100 默认20
      cat_id string 否 商品类目ID
      opt_id string 否 商品标签类目ID
      block_cats string 否 自定义屏蔽一级/二级/三级类目ID：多个用英文逗号分隔屏 自定义数量不超过20个;使用pdd.goods.cats.get接口获取cat_id
      block_cat_packages string 否 蔽商品类目包：多个用英文逗号分隔屏 1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药
      keyword string 否 关键字，支持goods_id、拼多多长链、进宝长链搜索
      goods_sign string 否 商品goodsSign，支持通过goods_sign查询商品
      sort_type string 否 排序方式:0-综合排序;1-按佣金比率升序;2-按佣金比例降序;3-按价格升序;4-按价格降序;5-按销量升序;6-按销量降序; 7-优惠券金额排序升序;8-优惠券金额排序降序;9-券后价升序排序;10-券后价降序排序;11-按照加入多多进宝时间升序; 12-按照加入多多进宝时间降序;13-按佣金金额升序排序;14-按佣金金额降序排序;15-店铺描述评分升序;16-店铺描述评分降序; 17-店铺物流评分升序;18-店铺物流评分降序;19-店铺服务评分升序;20-店铺服务评分降序;27-描述评分击败同类店铺百分比升序， 28-描述评分击败同类店铺百分比降序，29-物流评分击败同类店铺百分比升序，30-物流评分击败同类店铺百分比降序， 31-服务评分击败同类店铺百分比升序，32-服务评分击败同类店铺百分比降序
      with_coupon string 否 是否只返回优惠券的商品，0返回所有商品，1只返回有优惠券的商品
      minpgpirce string 否 最小拼购金额
      maxpgpirce string 否 最大拼购金额
      minprice string 否 最小金额
      maxprice string 否 最大金额
      mincommission string 否 最小佣金比例
      maxcommission string 否 最大佣金比例
      mindiscount string 否 最小优惠券金额
      maxdiscount string 否 最大优惠券金额
      mincommissionshare string 否 最小佣金比例
      maxcommissionshare string 否 最大佣金比例
      minsale string 否 最小销量
      maxsale string 否 最大销量
      ispg string 否 是否拼购 1拼购
      merchant_type int 否 调用拼多多超级搜索（isunion=1）才有效 店铺类型，1-个人，2-企业，3-旗舰店，4-专卖店，5-专营店，6-普通店（未传为全部）
      isunion string 否 isunion=1 表示返回拼多多原接口数据不做处理 返回值参考 官方文档
      pid string 否 拼多多官方推广位，不传使用开发者中心多多进宝设置的默认pid
      custom_parameters string 否 自定义参数，为链接打上自定义标签；自定义参数最长限制64个字节；格式为： {"uid":"11111","sid":"22222"} ，其中 uid 用户唯一标识，可自行加密后传入，每个用户仅且对应一个标识，必填； sid 上下文信息标识 ，例如sessionId等，非必填。该json字符串中也可以加入其他自定义的key
      predict_promotion string 否 predict_promotion=1 表示返回比价参数predict_promotion_rate

      JSON返回示例： 

      {
    "data": {
        "goods_list": [
            {
        "goods_id": 8344870257,商品id 
        "goods_name": "12卷40卷48卷卫生纸批发家用卷纸巾竹浆厕纸妇婴纸手纸无芯卷筒",商品名称 
        "goods_short_name": "12卷40卷48卷卫生纸批发家用卷纸巾竹浆厕纸妇婴纸手纸无芯卷筒",短标题 
        "materiaurl": "http://mobile.yangkeduo.com/goods2.html?goods_id=8344870257",商品原链接 
        "goods_desc": "【您使用的纸巾够安全么?】我们生活,离不开空气和水源,在生活用品中,纸的使用也是占了生活的大部分。【买纸您是看手感?还是看掉不掉渣?还是看遇水易烂?】我们购买卫生纸,全家适用,尤其是家里有孩子和老人,更是要好好选择。【原谅当然是重中之重】纸巾很难在手感上面辨别纸巾是否安全和卫生。【恒曼品牌,达亿旗下电商新商标,与达意百慧是共同成长的品牌,多年的老品牌,线下千万顾客认证的纸品牌】采用进口原生竹浆,签署厂前供货合同,货源稳定可靠,品质保证。【喷浆精制,不爱掉渣,不添加任何荧光剂等有害物质】您买的放心,用的安心。是达亿纸业有限公司一直以来的追求和努力。【同等价格比品质,比质量,比价格,恒曼性价比高】",导购信息 
        "price": 11.9,原价 
        "price_pg": 9.9,拼购价(拼购商品才有) 
        "price_after": 6.9,券后价
        "discount": 3,券金额 
        "quota": 3,满多少可用券 
        "picurl": "https://t00img.yangkeduo.com/goods/images/2019-06-10/193fccbb500cd2b81eb2ee5c2af8305d.jpeg",图片地址
        "picurls": [
            "https://t00img.yangkeduo.com/goods/images/2019-06-05/3a4cc069-ac35-495d-a4ff-c449a7e661d6.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-18/6a886c8c-d453-4463-b848-7b59857a36a6.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-10/ae7ec705-9c05-481a-95df-37d8b6b72ecc.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-10/315dd56c-a67b-4d5f-99ec-8a5219cf2df5.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-06/8419936a-3f34-4e0d-985b-623cc4f6f87a.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-10/6dbc6e47-1ee2-4e6c-b408-1084004a4adc.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-10/04286c4a-5c34-49dc-beaf-993a1c1a7924.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-06-06/1e31ac1e-7570-4e28-be9a-8dae69dbeed3.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-07-07/9e7801f0-ac1e-4aa8-a4d0-4fb6d721a4c0.jpg",
            "https://t00img.yangkeduo.com/goods/images/2019-07-07/fd1fd75f-ae05-4977-a67f-d565bf0d5308.jpg"
        ],多图
        "sales": "8.9万",销量
        "start_time": 1562428800,推广开始时间
        "end_time": 1562601599,推广结束时间
        "pf_cid": 8590,分类id
        "pf_cname": "百货",分类名称
        "pdd_c_info": "a:3:{i:0;i:17285;i:1;i:17297;i:2;i:17402;}",
        "ispg": 1,是否拼购 0否1是
        "opt_id": 8590,标签ID
        "opt_name": "百货",标签名称
        "comments": 20899,	评论数量
        "goodcommentsshare": 4.71,	商品评价分
        "commission": 1.449,	预估佣金
        "commissionshare": 21,	佣金比例
        "shopid": 226035612,	店铺ID
        "shopname": "恒曼居家日用官方旗舰店",	店铺名称
        "has_mall_coupon": 0,,是否有店铺券 0否1是
        "mall_coupon_discount_pct": 0,	店铺折扣
        "mall_coupon_min_order_amount": 0,	最小使用金额
        "mall_coupon_max_discount_amount": 0,	最大使用金额
        "mall_coupon_total_quantity": 0,	店铺券总量
        "mall_coupon_remain_quantity": 0,	店铺券余量
        "mall_coupon_start_time": 0,	店铺券使用开始时间
        "mall_coupon_end_time": 0,	店铺券使用结束时间
        "avg_desc": 479,	描述评分
        "avg_lgst": 479,	物流评分
        "avg_serv": 479,	服务评分
        "desc_pct": 0.8267,	描述分击败同类店铺百分比
        "lgst_pct": 0.8398,	物流分击败同类店铺百分比
        "serv_pct": 0.849,	服务分击败同类店铺百分比
        "predict_promotion_rate": 200,	比价行为预判定佣金，需要用户备案
            }
        ],
        "totalCount": 50总数 
    },
    "message": "success",提示信息 
    "status_code": 200状态码 200表示请求成功 
}

}
    • status_code=200 成功，其他失败，具体信息见message返回值