1688 List Shop Products By URL

17.46 credits/call
ae_ali1688_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.

Productivity
17.46 credits/call

Pricing

17.46 credits/call
ConditionCharge
Each call17.46 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
catstringNo可选的分类 ID 筛选条件。—
pageintegerNo页码,从1开始。1
sortenum (default | sales | price_up | price_down | time_up | time_down)No1688 ShopSort 请求值default
catTypeenum (0 | 1)No1688 CategoryType 请求值—
shopUrlstringYes1688 店铺主页 URL。—
pageSizeintegerNo每页请求的商品数量。返回数量可能有所不同。20

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.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 exampleresponse.json
JSONPartial content
{
  "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.