1688 List Shop Products By URL

17.46积分/次
ae_ali1688_list_shop_products_by_url

提供 1688 店铺主页 URL(shopUrl),查询该店铺的商品目录,适合浏览和调研店铺商品。可指定页码 page(从 1 开始,默认 1)和每页请求数量 pageSize(默认 20,实际返回数量可能不同)。sort 支持默认排序 default、销量排序 sales、价格升序 price_up、价格降序 price_down、时间升序 time_up 和时间降序 time_down。可用 cat 按分类 ID 筛选;catType 可选字符串 "0" 或 "1",两种分类模式的具体含义未明确。返回包含查询结果 data、状态码 code、消息 message 和记录时间 recordTime;商品字段及分页元数据的具体结构未明确,以实际返回为准,并结合 code 和 message 判断查询状态。

效率工具
17.46积分/次

价格说明

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

工具参数

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

参数类型必填说明默认值
catstring否可选的分类 ID 筛选条件。—
pageinteger否页码,从1开始。1
sortenum (default | sales | price_up | price_down | time_up | time_down)否1688 ShopSort 请求值default
catTypeenum (0 | 1)否1688 CategoryType 请求值—
shopUrlstring是1688 店铺主页 URL。—
pageSizeinteger否每页请求的商品数量。返回数量可能有所不同。20

调用示例

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

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_by_url' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "page": 3,
    "pageSize": 20,
    "shopUrl": "https://shop91712b40x3477.1688.com"
  }
}'
返回示例response.json
JSON部分内容
{
  "code": 0,
  "data": {
    "has_next_page": true,
    "items": [
      {
        "category_name": "男式休闲马甲",
        "created_time": "2026-01-22T15:33:00+0800",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01m3K2Gq1JbZnfYeZwl_!!2215954061047-0-cib.310x310.jpg",
        "item_id": 1014922314528,
        "price": "43.0",
        "title": "2024夏季户外摄影网眼马甲男薄款多口袋外套男大码宽松马夹"
      }
    ],
    "max_count": 3000,
    "page": 3,
    "page_size": 20,
    "price_end": null
  },
  "message": null,
  "recordTime": "2026-11-11T19:36:26.800999251",
  "requestParams": {
    "body": null,
    "query": {
      "page": "3",
      "pageSize": "20",
      "shopUrl": "https://shop91712b40x3477.1688.com",
      "sort": "default"
    }
  }
}

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