1688 List Shop Products By URL
Browse a 1688 shop's product catalog by providing its homepage URL (shopUrl). You can choose a page (page, starting at 1; default 1) and requested page size (pageSize; default 20); the actual number returned may differ. Sorting options are default, sales-based, price ascending or descending, and time ascending or descending, using default, sales, price_up, price_down, time_up, and time_down respectively. Optionally filter by category ID with cat; catType accepts "0" or "1", but their specific mode meanings are not documented. The response contains the query result in data, along with code, message, and recordTime. Individual product fields and pagination metadata are not specified, so available details depend on the returned data.
Pricing
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cat | string | No | 可选的分类 ID 筛选条件。 | — |
page | integer | No | 页码,从1开始。 | 1 |
sort | enum (default | sales | price_up | price_down | time_up | time_down) | No | 1688 ShopSort 请求值 | default |
catType | enum (0 | 1) | No | 1688 CategoryType 请求值 | — |
shopUrl | string | Yes | 1688 店铺主页 URL。 | — |
pageSize | integer | No | 每页请求的商品数量。返回数量可能有所不同。 | 20 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"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"
}
}
}This example shows part of the response. Copied content is valid JSON.

