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.
17.46 credits/call
Pricing
17.46 credits/call
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
shopUrl | string | No | 1688 店铺主页 URL。请提供 shopUrl 或 memberId。 | — |
memberId | string | No | 卖家会员 ID。请提供 memberId 或 shopUrl。 | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.

