拼多多搜索 - 西瓜猪开放平台

此接口用户必修备案才可以使用

请求参数

Body 参数application/json

keyword

string

要搜索的内容

必需

listId

string

翻页时建议填写前页返回的list_id值，首次不传

必需

page

integer

默认值1，商品分页数

必需

pageSize

integer

默认每页商品数量100，每页商品数量

必需

sid

string

用户sid,用户的标识

必需

必须备案才能搜索,传入备案标识

sign

string

接口签名

必需

sortType

integer

排序方式

必需

排序方式:0-综合排序;;2-按佣金比例降序;3-按价格升序;4-按价格降序;5-按销量升序;6-按销量降序;

timeStamp

integer

秒级时间戳

必需

useCustomized

boolean

是否使用个性化推荐，true表示使用，false表示不使用，默认true。

必需

withCoupon

boolean

是否只返回优惠券的商品，false返回所有商品，true只返回有优惠券的商品

必需

示例

{
  "keyword": "耳机",
  "page": 1,
  "pageSize": 10,
  "sid": "173777487897937",
  "sign": "c53c2b3941332844173d3f3670297f16",
  "timeStamp": 1740017995
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

data

object

必需

listId

string

翻页时建议填写前页返回的list_id值

必需

searchId

string

翻页时建议填写前页返回的list_id值

必需

totalNum

string

总数量

必需

goodsList

array [object {18}]

必需

message

string

必需

示例

{
    "cache": false,
    "code": 0,
    "data": {
        "listId": "f88d31d2-f683-4b9e-bc6b-45e620d811cf",
        "searchId": "f88d31d2-f683-4b9e-bc6b-45e620d811cf",
        "totalNum": "24",
        "goodsList": [
            {
                "itemid": "E9r2r3cN0uNmDzvRwfDcsAndzSsfMLAeTg_JZQbwWpga",
                "itemtitle": "暖宝宝贴防冻保暖足贴脚底自发热可行走暖脚贴足热贴大号手脚冰凉",
                "itemdesc": "暖宝宝贴防冻保暖足贴脚底自发热可行走暖脚贴足热贴大号手脚冰凉",
                "itemprice": "11.9",
                "itemsale": "3.5万",
                "itempic": "https://img.pddpic.com/gaudit-image/2023-11-18/95d43f4b2c572cdda61d24ecc19918e0.jpeg",
                "itemendprice": "11.9",
                "shoptype": null,
                "couponmoney": "0",
                "videoid": null,
                "couponstarttime": "1970-01-01",
                "couponendtime": "1970-01-01",
                "searchSource": "pdd",
                "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/pddicon.png",
                "shopName": "乐客生活馆",
                "discount": null,
                "fanli": "0.79",
                "tkrates": "6.7",
                "imgs": null
            },
            {
                "itemid": "E9j23TNotlxmDzvRwfDcsL1dvZsl9SW7gQ_JQQThFuyx4",
                "itemtitle": "老北京暖贴宝宝贴自发热冬季宫暖宫贴驱寒防寒学生加热女",
                "itemdesc": "老北京暖贴宝宝贴自发热冬季宫暖宫贴驱寒防寒学生加热女",
                "itemprice": "2.86",
                "itemsale": "2418",
                "itempic": "https://img.pddpic.com/gaudit-image/2023-11-02/b3dbc16e634f6df946f00f912529fa84.jpeg",
                "itemendprice": "2.86",
                "shoptype": null,
                "couponmoney": "0",
                "videoid": null,
                "couponstarttime": "1970-01-01",
                "couponendtime": "1970-01-01",
                "searchSource": "pdd",
                "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/pddicon.png",
                "shopName": "大杨生活馆",
                "discount": null,
                "fanli": "0.28",
                "tkrates": "10.1",
                "imgs": null
            },
            {
                "itemid": "E9322PObv2RmDzvRwfDcsOmfeMeGpl0JUw_JQz6DbiHdu",
                "itemtitle": "暖宝宝暖贴自发热批发冬季保暖贴全身老寒腿驱寒佩暖宝宝贴加强版",
                "itemdesc": "暖宝宝暖贴自发热批发冬季保暖贴全身老寒腿驱寒佩暖宝宝贴加强版",
                "itemprice": "9.92",
                "itemsale": "6348",
                "itempic": "https://img.pddpic.com/gaudit-image/2023-09-16/fd0acf7612bc1b9e743cdf9dfe66e6e7.jpeg",
                "itemendprice": "8.92",
                "shoptype": null,
                "couponmoney": "1",
                "videoid": null,
                "couponstarttime": "2023-12-16",
                "couponendtime": "2024-01-14",
                "searchSource": "pdd",
                "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/pddicon.png",
                "shopName": "晴雨美妆百货",
                "discount": null,
                "fanli": "2.10",
                "tkrates": "23.6",
                "imgs": null
            },
            {
                "itemid": "E932Ji3Ch8pmDzvRwfDcsF4oDcvYQbtxiQ_J5FC9pCQb",
                "itemtitle": "暖宝宝暖身贴自发热贴暖宫驱寒学生中老年暖腰护膝腿大号防寒保暖",
                "itemdesc": "暖宝宝暖身贴自发热贴暖宫驱寒学生中老年暖腰护膝腿大号防寒保暖",
                "itemprice": "19.33",
                "itemsale": "100万+",
                "itempic": "https://img.pddpic.com/gaudit-image/2023-12-13/f4af78d7fb81f80a3bcb076d0f748763.jpeg",
                "itemendprice": "18.33",
                "shoptype": null,
                "couponmoney": "1",
                "videoid": null,
                "couponstarttime": "2023-12-14",
                "couponendtime": "2024-03-12",
                "searchSource": "pdd",
                "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/pddicon.png",
                "shopName": "聚尚品生活馆",
                "discount": null,
                "fanli": "2.47",
                "tkrates": "13.5",
                "imgs": null
            }
        ]
    },
    "message": "操作成功"
}