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积分/次 |
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
cat | string | 否 | 可选的分类 ID 筛选条件。 | — |
page | integer | 否 | 页码,从1开始。 | 1 |
sort | enum (default | sales | price_up | price_down | time_up | time_down) | 否 | 1688 ShopSort 请求值 | default |
catType | enum (0 | 1) | 否 | 1688 CategoryType 请求值 | — |
shopUrl | string | 是 | 1688 店铺主页 URL。 | — |
pageSize | integer | 否 | 每页请求的商品数量。返回数量可能有所不同。 | 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
{
"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。

