淘宝搜索 - 西瓜猪开放平台

请求参数

Body 参数application/json

back

integer

每页返回条数（请在1,2,10,20,50,100中选择一个数值返回）

必需

isCoupon

integer

是否只取有券商品：0否；1是，默认是0

可选

isTmall

integer

是否只取天猫商品：0否；1是，默认是0

可选

keyword

string

关键词

必需

同时也支持宝贝ID搜索即keyword=itemid（由于存在特殊符号搜索的关键词必须进行两次urlencode编码）

minId

integer

分页，用于实现类似分页抓取效果，来源于上次获取后的数据的min_id值，默认开始请求值为1（该方案比单纯123分页的优势在于：数据更新的情况下保证不会重复也无需关注和计算页数）

必需

searchType

integer

搜索来源（1.综合（爆品商品库+联盟）；2.爆品商品库；3.联盟商品）

可选

sign

string

掐表签名

必需

sonCategory

string

淘宝子类目筛选（多个请用“,”分隔，最多支持10个）

可选

sort

integer

可选

0.综合，1.最新，2.销量（高到低），3.销量（低到高），4.价格(低到高)，5.价格（高到低），6.佣金比例（高到低）

tbP

integer

必需

淘宝分页，用于实现类似分页抓取效果，来源于上次获取后的数据的tb_p值，默认开始请求值为1（该方案比单纯123分页的优势在于：数据更新的情况下保证不会重复也无需关注和计算页数）

timeStamp

integer

时间戳，秒级

必需

示例

{
  "back": 10,
  "isCoupon": 0,
  "isTmall": 0,
  "keyword": "耳机",
  "minId": 1,
  "searchType": 1,
  "sign": "c53c2b3941332844173d3f3670297f16",
  "sort": 0,
  "tbP": 1,
  "timeStamp": 1740017995
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/tb/search' \
--header 'Content-Type: application/json' \
--data-raw '{
  "back": 10,
  "isCoupon": 0,
  "isTmall": 0,
  "keyword": "耳机",
  "minId": 1,
  "searchType": 1,
  "sign": "c53c2b3941332844173d3f3670297f16",
  "sort": 0,
  "tbP": 1,
  "timeStamp": 1740017995
}'

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

code等于0代表成功

data

object

必需

min_id

string

必需

作为请求地址中获取下一页的参数值

goodsList

array [object {18}]

商品集合

必需

tb_p

string

必需

作为请求地址中获取下一页联盟超级搜数据的参数值

message

string

必需

示例

{
  "cache": false,
  "code": 0,
  "data": {
    "min_id": "2",
    "goodsList": [
      {
        "itemid": "968goknsBtOjbAbBRgC2q2c0U6-8B7prJNt0MbkAnpDSqd",
        "itemtitle": "【自营】Sony/索尼 WH-1000XM5 旗舰头戴式无线蓝牙主动降噪耳机",
        "itemdesc": "可用签到【88vip预计到手价2076.5元，可凑单跨店满减，用消费券再打92折，再用签到到手更低，买即赠耳机支架】专注聆听音乐，自动滤入环境声，安全可靠，可定制多达20种环境声级别，为您带来轻松高效的降噪体验。",
        "itemprice": "2186.0",
        "itemsale": "47",
        "itempic": "https://gw.alicdn.com/bao/uploaded/i3/2549841410/O1CN01PYhlzy1MHpD6qNtoV_!!2549841410.jpg",
        "itemendprice": "2186.0",
        "shoptype": "B",
        "couponmoney": "0",
        "videoid": "0",
        "couponstarttime": "2025-02-10",
        "couponendtime": "2025-02-20",
        "searchSource": "taobao",
        "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/tmicon.png",
        "shopName": "天猫国际自营全球超级店",
        "discount": null,
        "fanli": "32.79",
        "tkrates": "1.5",
        "imgs": null
      }
    ],
    "tb_p": "1"
  },
  "message": "操作成功"
}