店铺搜索 - 中文版

请提交店铺的shop_id查询店铺内商品。请提交店铺的shop_id查询店铺内商品，shop_id可通过【商品详情搜索接口】获取

请求参数

Query 参数

appKey

string

必需

大吉平台appKey

appSecret

string

必需

秘钥，仅调试使用，正式用sign签名

sign

string

可选

sign签名，请求的参数字典排序+秘钥appSecret，调试时可忽略改字段

shop_id

string

淘宝商铺ID

必需

示例值:

57496020

sort

string

可选

搜索排序，默认综合排序，“PRICE_ASC” 价格从低到高，“PRICE_DESC” 价格从高到低，SALE_QTY_ASC 销量从低到高，SALE_QTY_DESC 销量从高到低

filters

string

可选

筛选项，例如：价格区间筛选，“min_price:2000” 表示最低价20元、“max_price:10000” 表示最高价100元，单位：分

示例值:

min_price:200,max_price:100000

page_no

number

页码

可选

示例值:

page_size

number

可选

页大小，默认10上限20

示例值:

language

string

可选

目前仅支持：en-英语，vi-越南语

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

消息

必需

data

object

搜索结果

必需

data

array [object {8}]

必需

pageNo

integer

页码

必需

pageSize

integer

页大小

必需

timestamp

integer

时间戳

必需

traceId

string

traceId

必需

示例

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "data": [
            {
                "itemId": 750175003567,
                "price": "2499.00",
                "shopName": "小米官方旗舰店",
                "multiLanguageInfo": {},
                "inventory": 200,
                "title": "【库存紧张 现货速发】Redmi K70红米手机小米手机官方旗舰店红米k70小米k70高通骁龙8Gen2澎湃OS",
                "mainImageUrl": "https://img.alicdn.com/imgextra/i3/1714128138/O1CN01oT2V8b29zG9eJbEqH-1714128138.jpg",
                "tags": []
            },
            {
                "itemId": 753504059452,
                "price": "2449.00",
                "shopName": "荣耀官方旗舰店",
                "multiLanguageInfo": {},
                "inventory": 200,
                "title": "【官网】HONOR/荣耀90 GT 5G智能直屏手机第二代骁龙8旗舰芯片官方旗舰店官网正品学生游戏电竞护眼",
                "mainImageUrl": "https://img.alicdn.com/imgextra/i4/1114511827/O1CN01FCQTHm1PMoa4g9A9I_!!0-item_pic.jpg",
                "tags": []
            }
        ],
        "pageNo": 1,
        "pageSize": 2
    },
    "timestamp": 1720778128153,
    "traceId": "890035e171f4"
}