1688 Get Shop Category

17.46 credits/call
ae_ali1688_get_shop_category

Retrieve all categories for a 1688 shop to browse its directory during product sourcing. Provide at least one of shopUrl (the shop homepage URL) or memberId (the seller member ID), as a string. The response includes category data in data, a result code in code, a nullable message, and recordTime metadata. The category data structure is not specified; this operation retrieves categories rather than product listings or product details.

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
shopUrlstringNo1688 店铺主页 URL。请提供 shopUrl 或 memberId。—
memberIdstringNo卖家会员 ID。请提供 memberId 或 shopUrl。—

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_get_shop_category' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "shopUrl": "https://shop9516620082g68.1688.com/"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 0,
  "data": {
    "is_custom": false,
    "list": [
      {
        "children": [],
        "count": 16,
        "full_name": "耳环",
        "id": 122700006,
        "name": "耳环"
      }
    ],
    "member_id": "b2b-2218547296452f47ac"
  },
  "message": null,
  "recordTime": "2026-11-08T15:40:05.935869042",
  "requestParams": {
    "body": null,
    "query": {
      "shopUrl": "https://shop9516620082g68.1688.com/"
    }
  }
}

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