1688 Product keyword query - PandaPon OpenAPI

请求参数

Header 参数

access-key

string

必需

默认值:

58c0201dfdf148eca63cbf6bb5e7cf03

nonce-str

string

可选

默认值:

nonce-str

timestamp

string

必需

默认值:

1715669977082

user-id

string

必需

默认值:

2100007341207

signature

string

必需

默认值:

B7F83FE2ADC8D8F044F2E01F0FFE8C80

Body 参数application/json

keyword

string

关键词

必需

beginPage

integer

第几页

必需

pageSize

integer

分页大小

必需

country

string

目前固定传 en

必需

filter

string | null

可选

筛选参数，多个通过英文逗号分隔，枚举如下：shipInToday,ksCiphertext

sort

string | null

可选

排序参数，枚举：{"price":"asc"}

outMemberId

string | null

外部用户id

可选

priceStart

string | null

最小批发价

可选

priceEnd

string | null

最大批发价

可选

categoryId

string | null

类目id

可选

示例

{
  "keyword": "T恤",
  "beginPage": 1,
  "pageSize": 5,
  "country": "en"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v2/alibaba/product/keywords/query' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyword": "T恤",
    "beginPage":1,
    "pageSize":5,
    "country":"en"
}'

返回响应

🟢200成功

application/json

Body

requestId

string

请求ID

可选

code

integer

返回码

可选

developId

integer

开发者ID

可选

msg

string

返回码对应信息

可选

data

object (AlibabaBasePageVOAlibabaProductListInfoV2VO)

返回内容

可选

totalRecords

integer

总记录数

可选

totalPage

integer

总页数

可选

pageSize

integer

分页大小

可选

currentPage

integer

第几页

可选

data

array[object (AlibabaProductListInfoV2VO) {8}]

分页数据

可选

示例

{
  "requestId": "657eee317da94075bf4301116f7d61d9",
  "code": 200,
  "developId": "1110890638347337996",
  "msg": "成功",
  "data": {
    "totalRecords": 2000,
    "totalPage": 401,
    "pageSize": 5,
    "currentPage": 1,
    "data": [
      {
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01Gf8JoQ20i0lN5N8v2_!!2207943566882-0-cib.jpg",
        "subject": "国潮男装t恤230g重磅短袖男女纯棉体恤宽松圆领团服打底衫衣服潮",
        "subjectTrans": "T-shirt men's national tide 230g heavy cotton Xinjiang cotton tide brand printable logo loose ins solid color short sleeve wholesale",
        "offerMapId": "wmNAp5CyEQ2fatKAZGGMWQ",
        "isJxhy": true,
        "priceInfo": {
          "price": "16.00",
          "jxhyPrice": null,
          "pfJxhyPrice": null
        },
        "repurchaseRate": "5%",
        "monthSold": 97822
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01NuiX0a1vRSNaUu9Ma_!!2208347666169-0-cib.jpg",
        "subject": "CoolMax黑科技情侣版T恤重磅220g新疆精梳棉亲肤吸汗透气休闲上衣",
        "subjectTrans": "CoolMax Black Technology Couple Edition T-shirt Heavy 220g Xinjiang Combed Cotton Skin-absorbent Sweat Breathable Casual Jacket",
        "offerMapId": "E_J_AfRcHf9mI1I-Rsw3ow",
        "isJxhy": false,
        "priceInfo": {
          "price": "35.90",
          "jxhyPrice": null,
          "pfJxhyPrice": null
        },
        "repurchaseRate": "10%",
        "monthSold": 138
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01qac0bC1jWF7RZTScB_!!2217732114555-0-cib.jpg",
        "subject": "300g纯棉重磅短袖100％新疆棉男女同款T恤宽松圆领百搭简约打底衫",
        "subjectTrans": "300g Cotton Heavy Short Sleeve 100 Xinjiang Cotton Men's and Women's T-Shirt Loose Crewneck Joker Simple Base Shirt",
        "offerMapId": "ZLQKNeaqgTfEacvxc44Gsw",
        "isJxhy": true,
        "priceInfo": {
          "price": "21.80",
          "jxhyPrice": null,
          "pfJxhyPrice": null
        },
        "repurchaseRate": "10%",
        "monthSold": 4381
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01Iih3gd1edVEP7gO6s_!!2200734383894-0-cib.jpg",
        "subject": "BE泰合|2025夏季批发潮牌宽松大码索罗娜凉感面料纯色短袖T恤男",
        "subjectTrans": "BE Taihe | 2025 summer wholesale tide brand loose plus size Solona cool fabric solid color short sleeve T-shirt men",
        "offerMapId": "08638W304XanEjfO3MV8ng",
        "isJxhy": false,
        "priceInfo": {
          "price": "38.99",
          "jxhyPrice": null,
          "pfJxhyPrice": null
        },
        "repurchaseRate": "0%",
        "monthSold": 0
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01WVqCwa1UNnVZFKchB_!!2217977072506-0-cib.jpg",
        "subject": "重磅纯棉短袖t恤男夏季ins潮牌宽松百搭简约印花舒适休闲半袖体恤",
        "subjectTrans": "Heavy Cotton Short-sleeved T-shirt Men's Summer Instagram Popular Brand Loose All-match Simple Printed Comfortable Casual Half-sleeved T-shirt",
        "offerMapId": "maU0wK6tDMPreHU97ngM8w",
        "isJxhy": false,
        "priceInfo": {
          "price": "19.49",
          "jxhyPrice": null,
          "pfJxhyPrice": null
        },
        "repurchaseRate": "0%",
        "monthSold": 0
      }
    ]
  }
}