1688 List Shop Products

17.46 credits/call
ae_ali1688_list_shop_products

Browse a wholesale marketplace shop's products using its seller member ID (memberId, required). You can choose a page (starting at 1; default 1) and requested page size (default 20), sort by the default order, sales, price, or time, and optionally filter by shop category ID and minimum or maximum RMB prices. Price filters are supplied as strings. The response provides the requested shop-product data together with a result code, message, and recordTime. The actual number of returned products may differ from the requested page size, and the response schema does not guarantee specific product fields or a total count.

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
pageintegerNo页码,从1开始。1
sortenum (default | sales | price_up | price_down | time_up | time_down)No1688 ShopSort 请求值default
memberIdstringYes卖家会员 ID。—
pageSizeintegerNo每页请求的商品数量。返回数量可能有所不同。20
priceEndstringNo最高价格筛选条件(人民币)。—
shopCatIdstringNo店铺分类 ID。—
priceStartstringNo最低价格筛选条件(人民币)。—

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' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "memberId": "b2b-2208063292744eb0a6",
    "page": 3,
    "sort": "sales"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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"
    }
  }
}

This example shows part of the response. Copied content is valid JSON.