1688 Get Product Shipping
17.46 credits/call
ae_ali1688_get_product_shipping
Estimate the cost of shipping a 1688 product to a province in China. Provide the product ID and destination province name or abbreviation (for example, 广东 or gd). You may also provide the shipment quantity (default: 1) and total weight in kilograms. The response contains estimate data and status information; the detailed data fields and currency are not specified in the response schema. Use the result as a cost estimate, not a confirmed final shipping charge.
17.46 credits/call
Pricing
17.46 credits/call
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
A fixed charge of 17.46 credits applies per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
itemId | string | Yes | 1688商品ID。 | — |
province | string | Yes | 中国省份名称或简称,例如广东或 gd。 | — |
totalWeight | number | No | 总发货重量(千克)。 | — |
totalQuantity | integer | No | 要发货的商品总数。 | 1 |
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_product_shipping' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"itemId": "676748936717",
"province": "广东",
"totalQuantity": 1,
"totalWeight": 0.15
}
}'Response exampleresponse.json
{
"code": 0,
"data": {
"first_unit": 30.0,
"first_unit_fee": 31.0,
"next_unit": 1.0,
"next_unit_fee": 0.66,
"shipping_to": "广东",
"total_fee": 31.0
},
"message": null,
"recordTime": "2026-11-11T17:22:52.985030176",
"requestParams": {
"body": null,
"query": {
"itemId": "676748936717",
"province": "广东",
"totalQuantity": "1",
"totalWeight": "0.15"
}
}
}This example shows part of the response. Copied content is valid JSON.

