1688 List Shop Products

17.46积分/次
ae_ali1688_list_shop_products

根据卖家会员 ID(memberId,必填)浏览批发平台店铺的商品目录。可指定页码(从 1 开始,默认 1)和每页请求数量(默认 20),按默认顺序、销量、价格或时间排序,并可按店铺分类 ID、人民币最低价和最高价筛选;价格筛选值以字符串传入。返回本次店铺商品查询的数据,以及结果码 code、说明 message 和 recordTime。实际返回商品数量可能与请求数量不同;响应结构未约定具体商品字段或商品总数,需结合结果码和说明判断查询结果。

效率工具
17.46积分/次

价格说明

17.46积分/次
条件费用
每次调用17.46积分/次

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
pageinteger否页码,从1开始。1
sortenum (default | sales | price_up | price_down | time_up | time_down)否1688 ShopSort 请求值default
memberIdstring是卖家会员 ID。—
pageSizeinteger否每页请求的商品数量。返回数量可能有所不同。20
priceEndstring否最高价格筛选条件(人民币)。—
shopCatIdstring否店铺分类 ID。—
priceStartstring否最低价格筛选条件(人民币)。—

调用示例

复制请求代码,查看对应的返回示例。

POST/agent-api/v1/tool/executeX-Api-Key
请求代码request.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_ali1688_list_shop_products' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "memberId": "b2b-2208063292744eb0a6",
    "page": 3,
    "sort": "sales"
  }
}'
返回示例response.json
JSON部分内容
{
  "code": 0,
  "data": {
    "has_next_page": true,
    "items": [
      {
        "category_name": "手链",
        "created_time": "2022-06-16T17:13:00+0800",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01KC0e3P1W8nedBFuPh_!!2208063292744-0-cib.310x310.jpg",
        "item_id": 677409259555,
        "price": "38.0",
        "title": "天然珍珠手链高级感巴洛克间隔小金珠手串简约优雅饰品批发"
      }
    ],
    "max_count": 3000,
    "page": 3,
    "page_size": 20,
    "price_end": null
  },
  "message": null,
  "recordTime": "2026-11-09T23:24:59.46918349",
  "requestParams": {
    "body": null,
    "query": {
      "memberId": "b2b-2208063292744eb0a6",
      "page": "3",
      "pageSize": "20",
      "sort": "sales"
    }
  }
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。