PandaPon OpenAPI
Product documentsAPI Reference
English
  • 中文简体
  • ภาษาไทย
Product documentsAPI Reference
English
  • 中文简体
  • ภาษาไทย
Back to PandaPon Website
  1. goods
  • Taobao
    • goods
      • Taobao product search
        GET
      • Query products in bulk based on Taobao product IDs
        POST
      • Taobao commodity search interface
        POST
      • Taobao image search interface
        POST
    • order form
      • Taobao Order Creation
      • Taobao order paging query
      • Cancel Order
      • Modify the pre warehouse information of an order
      • Payment Order
      • Get IM Link
      • Get order details according to order ID
      • Get logistics details
    • shopping cart
      • Generate Order Preview
      • Create Order
      • Shopping Cart List
      • Delete Cart Item
      • Add Cart Item
      • Edit item quantity
    • After sales
      • Get the reverse order list interface
      • Reverse order rendering interface
      • Return logistics rendering
      • Return logistics submission
      • Reverse Order Cancellation
      • Submit reverse message
      • Reverse order submission
      • Query of message list
      • Reverse order modification
      • Detailed interface of reverse order
    • Message callback
      • Order price modification callback
      • Order status modification callback
      • Order after-sales refund
  • 1688
    • Goods
      • 1688 commodity details inquiry
      • 1688 Product keyword query
      • 1688 Product image search
      • 1688 multilingual store search
      • Query multilingual categories according to category ID
      • Product recommendation
      • Related product recommendation
      • Global strictly selected keyword query
      • 1688 Strictly select keyword query
      • Hot list query
    • shopping cart
      • Shopping Cart List
      • Add Shopping Cart Item
      • Delete Cart Item
      • Edit item quantity
      • Preview data interface before creating an order
      • Create Order
    • order form
      • Developers submit 1688 orders for payment in batch
      • Preview data interface before order creation (different merchants)
      • Create order interface in batch (different merchants)
      • Obtain logistics tracking information
      • Order List
      • Preview data interface before creating an order
      • Create Order Interface
      • Cancel order interface before payment
      • Order payment
      • Buyer confirms receipt
      • 1688 conversion and decryption to Wangwang nickname interface
    • After sales
      • 1688 Query the details of the refund form
      • 1688 Query refund return reason (used to create refund return)
      • 1688 Upload refund return voucher
      • 1688 Create refund return application
      • 1688 Buyer submits refund information
      • List of logistics companies - all logistics companies
    • Message callback
      • Order price modification callback
      • Order status modification interface
      • 1688 order after-sales refund
  • basis
    • Get user address information
      POST
    • Address addition and update
      POST
  • Warehouse logistics
    • Consult overseas freight estimate
      POST
    • Order overseas freight preview
      POST
    • Update domestic logistics information
      POST
    • Create international logistics order
      POST
  1. goods

Taobao commodity search interface

POST
/v2/taobao/product/item/search
/v2/taobao/product/item/search

请求参数

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  | null 
搜索关键词
必需
pageSize
integer  | null 
可选
页大小，默认20，1~40
>= 1<= 40
pageNo
integer  | null 
页码
可选
sort
string  | null 
可选
field}_des（降序），{field}_asc（升序），field案例：销量（total_sales），淘客佣金比率（tk_rate）， 累计推广量（tk_total_sales），总支出佣金（tk_total_commi），价格（price），匹配分（match）
示例
{
  "keyword": "电动车",
  "pageSize": 5,
  "pageNo": 1,
  "sort": "tk_rate_desc"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/taobao/product/item/search' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "keyword": "电动车",
  "pageSize": 5,
  "pageNo": 1,
  "sort": "tk_rate_desc"
}'

返回响应

🟢200成功
application/json
Body
requestId
string 
请求ID
可选
code
integer 
返回码
可选
developId
integer 
开发者ID
可选
msg
string 
返回码对应信息
可选
data
object (TaobaoProductDistributionSearchV2VO) 
返回内容
可选
totalResults
integer 
可选
搜索到符合条件的结果总数
resultList
array[object (ItemDTO) {7}] 
搜索结果
可选
示例
{
  "requestId": "699c0d11b4c2489a90556439b38939db",
  "code": 200,
  "developId": "1110890638347337996",
  "msg": "成功",
  "data": {
    "totalResults": 20,
    "resultList": [
      {
        "itemMapId": "V8RF50ypYclN0bwoQnZSWg",
        "shopName": "迅龙酷车",
        "price": "1682.00",
        "promotionPrice": "1682.00",
        "title": "新款小龟王电动车60V成人踏板电瓶车48V双人电动摩托车高速长跑王",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2209302752144/O1CN01S6UNFJ1Ri07TYMJPV_!!2209302752144.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2209302752144/O1CN01S6UNFJ1Ri07TYMJPV_!!2209302752144.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "e5tFAueYlcwgU3AX5fkHxw",
        "shopName": "锡山区电动酷车直销店",
        "price": "1809.00",
        "promotionPrice": "1809.00",
        "title": "新款电动摩托车72V长跑王双人电动车60V电瓶车大功率高速电摩外卖",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i2/2742513306/O1CN01qBUgbA1aICLTxPxLD_!!2742513306.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i2/2742513306/O1CN01qBUgbA1aICLTxPxLD_!!2742513306.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "XKOVY3uU6kS9H7M7YjmQ9Q",
        "shopName": "宝岛电动车行",
        "price": "2199.00",
        "promotionPrice": "2199.00",
        "title": "宝岛新国标电动车自行车电瓶车可上牌超长续航助力学生成人代步车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2214962446991/O1CN01SbdEPr21VvrJ7oANm_!!2214962446991.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2214962446991/O1CN01SbdEPr21VvrJ7oANm_!!2214962446991.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "ervM0Kq_J6S1WciXRyE7qA",
        "shopName": "高端电动车源头厂家直销",
        "price": "1880.00",
        "promotionPrice": "1880.00",
        "title": "2025新款小龟王电动车48V60V成人家用女士小型可上牌小绵羊电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2217250655177/O1CN01Ze9Hd91o77P8xTVPP_!!2217250655177.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2217250655177/O1CN01Ze9Hd91o77P8xTVPP_!!2217250655177.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "gXQ8aA8bTa-J5rMVQudJZA",
        "shopName": "飞鸽运动户外旗舰店",
        "price": "2699.00",
        "promotionPrice": "2699.00",
        "title": "【顺丰包邮】飞鸽苍穹2025款电动摩托车成人长续航电动车高速电摩",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i4/2218382275138/O1CN01GsBPaj1npG1YIa0zT_!!4611686018427384386-0-item_pic.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i4/2218382275138/O1CN01GsBPaj1npG1YIa0zT_!!4611686018427384386-0-item_pic.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "MERZ2toP1JTHFSgMu-ZM4A",
        "shopName": "天顺高端电动车",
        "price": "1799.00",
        "promotionPrice": "1799.00",
        "title": "黑骑士高速电动车新国标电瓶车72V外卖专用长跑王换电爬坡锂电",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i2/273159966/O1CN01e2yF2r2NUUB8ihsd9_!!273159966.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i2/273159966/O1CN01e2yF2r2NUUB8ihsd9_!!273159966.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "u0F6WM1gRwY5oIThBFyVVg",
        "shopName": "棋舟电动车",
        "price": "956.00",
        "promotionPrice": "956.00",
        "title": "新国标电动车电瓶车自行车助力女式小型高续航电车女生成人新款士",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i4/2217580326945/O1CN01aYFJhG21AriAWWFpS_!!2217580326945.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i4/2217580326945/O1CN01aYFJhG21AriAWWFpS_!!2217580326945.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "4jWftGDEJdVUje7dYoELVQ",
        "shopName": "酷车电摩1号俱乐部",
        "price": "1858.00",
        "promotionPrice": "1858.00",
        "title": "新款电动车72V电瓶车成人高速电动摩托车跑外卖专用长跑王长续航",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/1688248363/O1CN01C7OtOG2BeJ8asAvks_!!1688248363.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/1688248363/O1CN01C7OtOG2BeJ8asAvks_!!1688248363.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "SCXZ91GjuaAv2SkjGviKtw",
        "shopName": "云霄车业",
        "price": "1008.00",
        "promotionPrice": "1008.00",
        "title": "新国标电动自行车2025时尚新款男女成人小型电动车两轮代步电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i3/2219456465879/O1CN01Bq9sGD1tIdVmFnhBy_!!2219456465879.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i3/2219456465879/O1CN01Bq9sGD1tIdVmFnhBy_!!2219456465879.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "RfMwLPOEJ683B9XubKhWrQ",
        "shopName": "罗马假日咪果车品",
        "price": "3180.00",
        "promotionPrice": "3180.00",
        "title": "新款罗马假日电动车vespa网红电瓶车复古大龟王摩托车72V高速电摩",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i2/2200651374586/O1CN01REFs9w1jkR6tueU3o_!!2200651374586.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i2/2200651374586/O1CN01REFs9w1jkR6tueU3o_!!2200651374586.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "v8oyfsTstHo4QkJ_iq1QjQ",
        "shopName": "赛尔新能源",
        "price": "899.00",
        "promotionPrice": "899.00",
        "title": "2025新款新国标元宇宙pro电动车女生小型成人电动自行车电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2216523327288/O1CN012c9aed23hxZfR18Sg_!!2216523327288.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2216523327288/O1CN012c9aed23hxZfR18Sg_!!2216523327288.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "G-Ujh7Ovk9ufb3up0FhBsQ",
        "shopName": "纳盛车业",
        "price": "949.00",
        "promotionPrice": "949.00",
        "title": "电动车电瓶车自行车助力电车女式小型高续航新国标成人女生新款单",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2207470422729/O1CN01mxjL2b1W1vuDErh6T_!!2207470422729.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2207470422729/O1CN01mxjL2b1W1vuDErh6T_!!2207470422729.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "9cNjCmir90xAj3JLsKGopg",
        "shopName": "无锡萧何电车厂家",
        "price": "1999.00",
        "promotionPrice": "1999.00",
        "title": "新款成人电动车72v60v超长续航外卖电摩长跑王送外卖专用电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i4/1888325860/O1CN01Z47QbT1t9vzUFA6We_!!1888325860.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i4/1888325860/O1CN01Z47QbT1t9vzUFA6We_!!1888325860.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "I3HyH6aip5rpUYsSPf2HWQ",
        "shopName": "广东四季星车业工厂店",
        "price": "2999.00",
        "promotionPrice": "2999.00",
        "title": "小牛U2同款四季星新国标智能锂电高速长续航电动车男女上班代步车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/541147332/O1CN01Tmq2AL2426yvTFU6q_!!541147332.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/541147332/O1CN01Tmq2AL2426yvTFU6q_!!541147332.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "RA_oDiCIqvXbLkOm61dNXw",
        "shopName": "瀚扬电动车",
        "price": "1008.00",
        "promotionPrice": "1008.00",
        "title": "新国标电动车电瓶车自行车助力女式小型高续航电车女生成人新款士",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i3/2217546011546/O1CN01fJLMV81NI7HyqKw9Q_!!2217546011546.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i3/2217546011546/O1CN01fJLMV81NI7HyqKw9Q_!!2217546011546.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "Hg05adKu7tYSsAXmOY25XA",
        "shopName": "上海凤凰电动自行车直销店",
        "price": "650.00",
        "promotionPrice": "650.00",
        "title": "凤凰电动车2025新款小型成人电动自行车新国标代步迷你助力电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2218976525319/O1CN011BNrOx1pA9iPbVKXS_!!2218976525319.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2218976525319/O1CN011BNrOx1pA9iPbVKXS_!!2218976525319.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "lEzqBiEwGEBlf1ppEGrXiA",
        "shopName": "无锡野鹤电车厂家",
        "price": "1808.00",
        "promotionPrice": "1808.00",
        "title": "新款高速电动摩托车成人60V72v电动车长跑王超长续航跑外卖电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i3/3959277365/O1CN018Az53L24HE2fAfyCb_!!3959277365.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i3/3959277365/O1CN018Az53L24HE2fAfyCb_!!3959277365.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "Brn8MSTn4-FQjQmNdZATfA",
        "shopName": "永久电动车天骥店",
        "price": "1399.00",
        "promotionPrice": "1399.00",
        "title": "永久新国标电动自行车男女士电动车成人代步车小型长续航电瓶车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/1973384698/O1CN01VIM4AF1kZjjXTAaS8_!!1973384698.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/1973384698/O1CN01VIM4AF1kZjjXTAaS8_!!1973384698.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "rm_Rkl6G4M8YyliCuTcagw",
        "shopName": "凤凰 品牌直销店",
        "price": "1290.00",
        "promotionPrice": "1290.00",
        "title": "凤凰 越野变速雪地新国标super男女宽胎助力73摩托电瓶电动自行车",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/2200627827061/O1CN01L97GI4221zYl1UfLD_!!2200627827061.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/2200627827061/O1CN01L97GI4221zYl1UfLD_!!2200627827061.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      },
      {
        "itemMapId": "uEo6wkju3A1FJ1F_9qneIA",
        "shopName": "电动自行车厂直销店",
        "price": "1299.00",
        "promotionPrice": "1299.00",
        "title": "爱玛露娜电动车同款爱玛爱朵2024新款电瓶车小龟王电动车家用成人",
        "itemDescription": "",
        "picUrl": "https://img.alicdn.com/imgextra/i1/1580578974/O1CN01jO1ijw2GA9FxChPP7_!!1580578974.jpg",
        "picUrls": [
          "https://img.alicdn.com/imgextra/i1/1580578974/O1CN01jO1ijw2GA9FxChPP7_!!1580578974.jpg"
        ],
        "sourceFrom": 0,
        "salesVolume": "0"
      }
    ]
  }
}
修改于 2025-04-25 03:51:57
上一页
Query products in bulk based on Taobao product IDs
下一页
Taobao image search interface
Built with