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.

Productivity
17.46 credits/call

Pricing

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

A fixed charge of 17.46 credits applies per call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
itemIdstringYes1688商品ID。—
provincestringYes中国省份名称或简称,例如广东或 gd。—
totalWeightnumberNo总发货重量(千克)。—
totalQuantityintegerNo要发货的商品总数。1

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_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
JSONPartial content
{
  "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.