# 1688 API - Get 1688 product shipping fee

## API Overview

- Get shipping template based on province
- Get total shipping cost based on total quantity and weight

## API URL

`GET https://api.tmapi.io/1688/item/shipping`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| item_id | int | Product ID | true |
| province | str | Chinese province name, e.g., "广东","广东省","gd","Guangdong" | true |
| total_quantity | int | Total quantity of the product to be shipped<br/>Default value: 1 | false |
| total_weight | float | Total weight of the product to be shipped (in kg). You can calculate it by the weight information in the product detail API, If there is no weight information, just ignore this parameter. | false |

## Security Auth

> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.

> Add your apiToken to the request parameters. Please refer to the examples below.

## Request Example

```bash

curl --request GET 'https://api.tmapi.io/1688/item/shipping?apiToken=xxxxxx&item_id=652702302959&province=&total_quantity=1'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "shipping_to": "内蒙古",
    "unit": "kg",
    "first_unit": 1,
    "first_unit_fee": 9,
    "next_unit": 1,
    "next_unit_fee": 7,
    "total_quantity": 1,
    "total_weight": 2,
    "total_fee": 16
  }
}

```