# 1688 API - Get 1688 product details(By ID)

## API Overview

- Get 1688 product details by product ID
- Includes title, images, shop, SKU, price, inventory and other information
- Support multilingual output

## API URL

`GET https://api.tmapi.io/1688/item_detail`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| item_id | integer | Product ID | true |
| scene | string | Optional values: `drop_shipping` | false |
| optimize_title | boolean | Filter out non-core words from the title. This is more friendly to the translator. Only Chinese titles are supported for optimization.<br/>Default value: false | false |
| language | string | Optional values: `en`, `zh`, `ru`, `th`, `pt`, `es`, `tr`, `vi`, `ja`, `ko`<br/>Default value: zh | 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_detail?apiToken=xxxxxx&item_id=652702302959&language=zh'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": 859086919394,
    "product_url": "https://detail.1688.com/offer/859086919394.html",
    "title": "跨境速卖通女式长款睡衣家居服豹纹款开衫法式浴袍长袖秋冬睡袍",
    "category_id": 1037924,
    "root_category_id": 312,
    "currency": "CNY",
    "offer_unit": "件",
    "product_props": [
      {
        "产品类别": "睡衣"
      },
      {
        "面料名称": "网纱"
      },
      {
        "款式": "开衫"
      },
      {
        "主面料成分": "聚酯纤维（涤纶）"
      },
      {
        "厚薄": "中等"
      },
      {
        "面料厚薄（克重）": "适中(141-160克/平米)"
      },
      {
        "领型": "V字领"
      },
      {
        "袖长": "九分袖"
      },
      {
        "功能": "休闲,透气,情趣,居家,舒适"
      },
      {
        "上市时间": "2024年冬季"
      },
      {
        "适合季节": "夏季,冬季,春季,秋季,四季通用"
      },
      {
        "适用人群类别": "青年女性"
      },
      {
        "适用场景": "户外,居家"
      },
      {
        "颜色": "黄色豹纹,白色豹纹,肤色豹纹"
      },
      {
        "尺码": "S,M,L"
      },
      {
        "品牌": "其他"
      },
      {
        "产地": "灌云"
      },
      {
        "货号": "Y5106"
      },
      {
        "是否跨境出口专供货源": "是"
      },
      {
        "主面料成分含量": "30%（含）-50%（不含）"
      },
      {
        "风格": "欧美风"
      }
    ],
    "main_imgs": [
      "https://cbu01.alicdn.com/img/ibank/O1CN01gEiAAA1tfzhab0NhS_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01zbvscc1tfzgUMxRU9_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01U64N8h1tfzgajTOqp_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01OWDvGr1tfzgZTutIr_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01pc1OQP1tfzgaYrxTZ_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01zTDmhr1tfzgairTNV_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01sYHVBG1tfzgatNoUe_!!2214636595930-0-cib.jpg",
      "https://cbu01.alicdn.com/img/ibank/O1CN01RA4Ktf1tfzgcrZotc_!!2214636595930-0-cib.jpg"
    ],
    "video_url": "https://cloud.video.taobao.com/play/u/2214636595930/p/2/e/6/t/1/506402967489.mp4",
    "detail_url": "https://itemcdn.tmall.com/1688offer/icoss598189538ad1d6828b1d4e2a8",
    "sale_count": "175",
    "sale_info": {
      "sale_quantity_90days": 175
    },
    "price_info": {
      "price": "25.90",
      "price_min": "25.90",
      "price_max": "29.89",
      "origin_price_min": null,
      "origin_price_max": null,
      "discount_price": ""
    },
    "tiered_price_info": {
      "begin_num": 1,
      "prices": [
        {
          "beginAmount": "1",
          "price": "29.89"
        },
        {
          "beginAmount": "100",
          "price": "27.60"
        },
        {
          "beginAmount": "300",
          "price": "25.90"
        }
      ]
    },
    "mixed_batch": {
      "mix_amount": 10000,
      "mix_begin": 0,
      "mix_num": 1000,
      "shop_mix_num": 2147483647
    },
    "shop_info": {
      "shop_name": "灌云县伊山镇春霞服装厂",
      "shop_url": "https://winport.m.1688.com/page/index.html?memberId=b2b-22146365959302bc20",
      "seller_login_id": "灌云县伊山镇春霞服装厂",
      "seller_user_id": "2214636595930",
      "seller_member_id": "b2b-22146365959302bc20"
    },
    "delivery_info": {
      "location": "江苏省连云港市",
      "location_code": "34323526",
      "delivery_fee": 4,
      "unit_weight": 0,
      "template_id": "16519567"
    },
    "service_tags": [
      "7天无理由退货",
      "晚发必赔"
    ],
    "sku_price_scale": "25.90-29.89",
    "sku_price_scale_original": "null",
    "sku_price_range": {
      "begin_num": 1,
      "stock": 44732,
      "sku_param": [
        {
          "beginAmount": "1",
          "price": "29.89"
        },
        {
          "beginAmount": "100",
          "price": "27.60"
        },
        {
          "beginAmount": "300",
          "price": "25.90"
        }
      ],
      "mix_param": {
        "mixNum": 1000,
        "mixAmount": 10000,
        "shopMixNum": 2147483647,
        "mixBegin": 0,
        "supportMix": true
      }
    },
    "sku_props": [
      {
        "pid": "0",
        "prop_name": "颜色",
        "values": [
          {
            "vid": "0",
            "name": "黄色豹纹",
            "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01RA4Ktf1tfzgcrZotc_!!2214636595930-0-cib.jpg"
          },
          {
            "vid": "1",
            "name": "白色豹纹",
            "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01zTDmhr1tfzgairTNV_!!2214636595930-0-cib.jpg"
          },
          {
            "vid": "2",
            "name": "肤色豹纹",
            "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01sYHVBG1tfzgatNoUe_!!2214636595930-0-cib.jpg"
          }
        ]
      },
      {
        "pid": "1",
        "prop_name": "尺码",
        "values": [
          {
            "vid": "0",
            "name": "S",
            "imageUrl": ""
          },
          {
            "vid": "1",
            "name": "M",
            "imageUrl": ""
          },
          {
            "vid": "2",
            "name": "L",
            "imageUrl": ""
          }
        ]
      }
    ],
    "skus": [
      {
        "skuid": "5674557541674",
        "specid": "6f5320c016c03d575ad1034b79869a28",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4975,
        "props_ids": "0:1;1:2",
        "props_names": "颜色:白色豹纹;尺码:L",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541667",
        "specid": "bdcae134f48c5b5edfdffb3e79612418",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4996,
        "props_ids": "0:2;1:0",
        "props_names": "颜色:肤色豹纹;尺码:S",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541669",
        "specid": "c36b443e8f1551db7843a489cc62ca1f",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4966,
        "props_ids": "0:0;1:0",
        "props_names": "颜色:黄色豹纹;尺码:S",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541671",
        "specid": "67fabdabdec80a01cb571951061d314f",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4991,
        "props_ids": "0:1;1:1",
        "props_names": "颜色:白色豹纹;尺码:M",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541675",
        "specid": "2e4af15b48d5e0426c9fb9b30311e944",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4872,
        "props_ids": "0:0;1:2",
        "props_names": "颜色:黄色豹纹;尺码:L",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541672",
        "specid": "19e11750558f8465d67e7da1fbda7afe",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4948,
        "props_ids": "0:0;1:1",
        "props_names": "颜色:黄色豹纹;尺码:M",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541668",
        "specid": "ddc44276e54d3bce6c16f7e9dd785b38",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4997,
        "props_ids": "0:1;1:0",
        "props_names": "颜色:白色豹纹;尺码:S",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541673",
        "specid": "592510a700d02b945eb5f96e6b3e55fd",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4992,
        "props_ids": "0:2;1:2",
        "props_names": "颜色:肤色豹纹;尺码:L",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      },
      {
        "skuid": "5674557541670",
        "specid": "96c1c66eeb4dcead3fc716bfabb1d236",
        "sale_price": "29.89",
        "origin_price": null,
        "stock": 4995,
        "props_ids": "0:2;1:1",
        "props_names": "颜色:肤色豹纹;尺码:M",
        "sale_count": 0,
        "package_info": {
          "weight": 0.12,
          "length": 0,
          "width": 0,
          "height": 0,
          "volume": 0
        }
      }
    ],
    "is_sold_out": false,
    "stock": 44732,
    "promotions": []
  }
}

```