淘宝商品列表 - 西瓜猪开放平台

请求参数

Body 参数application/json

back

string

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

必需

cid

string

商品类目：

必需

0全部，1女装，2男装，3内衣，4美妆，5配饰，6鞋品，7箱包，8儿童，9母婴，10居家，11美食，12数码，13家电，14其他，15车品，16文体，17宠物（支持多类目筛选，如1,2获取类目为女装、男装的商品，逗号仅限英文逗号）

minId

string

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

必需

sort

string

排序

必需

0.综合（最新），1.券后价(低到高)，2.券后价（高到低），3.券面额（高到低），4.月销量（高到低），5.佣金比例（高到低），6.券面额（低到高），7.月销量（低到高），8.佣金比例（低到高），9.全天销量（高到低），10全天销量（低到高），11.近2小时销量（高到低），12.近2小时销量（低到高），13.优惠券领取量（高到低）

sign

string

签名

必需

timeStamp

integer

秒级时间戳

必需

示例

{
  "back": "string",
  "cid": "string",
  "deviceType": "string",
  "deviceValue": "string",
  "minId": "string",
  "sign": "string",
  "sort": "string",
  "timeStamp": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/tb/itemlist' \
--header 'Content-Type: application/json' \
--data-raw '{
  "back": "string",
  "cid": "string",
  "deviceType": "string",
  "deviceValue": "string",
  "minId": "string",
  "sign": "string",
  "sort": "string",
  "timeStamp": 0
}'

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

data

object

字段意思参考淘宝搜索接口

必需

min_id

string

必需

goodsList

array [object {18}]

必需

message

string

必需

示例

{
  "cache": false,
  "code": 0,
  "data": {
    "min_id": "50022266",
    "goodsList": [
      {
        "itemid": "jWWJWGoh0tJZvQn8jmIBdbiGUe-3qWJxPGu036mkdV0HR",
        "itemtitle": "吃欢天面丫面红烧牛肉面70g*24袋方便面火锅面泡面干吃面速食整箱",
        "itemdesc": "【拍10件仅需10元，到手10袋！】红烧牛肉面、香辣牛肉面、香菇炖鸡面，多种口味可选！精选上等小麦~面身Q滑，入口爽滑，劲道十足！色泽诱人，飘香四溢，回味无穷，赶走饥饿！",
        "itemprice": "300.00",
        "itemsale": "92",
        "itempic": "https://img.alicdn.com/imgextra/i1/2278533591/O1CN01JwLwnK1cOjIwrZcs9_!!2278533591.png",
        "itemendprice": "10.00",
        "shoptype": "B",
        "couponmoney": "290",
        "couponstarttime": "2025-02-24",
        "couponendtime": "2025-02-27",
        "searchSource": "taobao",
        "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/tmicon.png",
        "shopName": "吃欢天食品旗舰店",
        "discount": "0.30",
        "fanli": "1.00",
        "tkrates": "10.00",
        "imgs": null
      },
      {
        "itemid": "oK72Z5zOtrtKewVjwX9hDw9CqUN-W76V5vxSQz9WVDZMiz",
        "itemtitle": "【新年年货礼盒】东阿阿胶糕固元膏500g正品官方旗舰长辈送礼TS",
        "itemdesc": "山东手工补品女性固元膏滋补铁盒装,甄选原料，独立包装,传承工艺古法熬制送礼，自用都有面",
        "itemprice": "239.90",
        "itemsale": "0",
        "itempic": "https://img.alicdn.com/i2/2218869774833/O1CN01pBPztU1lZZDBPtzC9_!!2218869774833.jpg",
        "itemendprice": "29.90",
        "shoptype": "B",
        "couponmoney": "210",
        "couponstarttime": "2025-02-24",
        "couponendtime": "2025-03-31",
        "searchSource": "taobao",
        "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/tmicon.png",
        "shopName": "享心燕旗舰店",
        "discount": "1.20",
        "fanli": "11.36",
        "tkrates": "38.00",
        "imgs": null
      }
    ]
  },
  "message": "操作成功"
}