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积分/次 |
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
page | integer | 否 | 页码,从1开始。 | 1 |
sort | enum (default | sales | price_up | price_down | time_up | time_down) | 否 | 1688 ShopSort 请求值 | default |
memberId | string | 是 | 卖家会员 ID。 | — |
pageSize | integer | 否 | 每页请求的商品数量。返回数量可能有所不同。 | 20 |
priceEnd | string | 否 | 最高价格筛选条件(人民币)。 | — |
shopCatId | string | 否 | 店铺分类 ID。 | — |
priceStart | string | 否 | 最低价格筛选条件(人民币)。 | — |
调用示例
复制请求代码,查看对应的返回示例。
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
{
"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。

