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

## API Overview

- Product basic information (title/category)
- Product properties
- Product images/video
- Shop information (Shop name/ID/Url/ratings/type of shop, etc.)
- Logistics information (delivery from/postage)
- SKU attributes (name/thumbnail)
- SKU price and stock

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| item_id | integer | Product ID | true |

## 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/taobao/item_detail?apiToken=xxxxxx&item_id=649752139926'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": 682042505030,
    "product_url": "https://item.taobao.com/item.htm?id=682042505030",
    "title": "法国MKins女包520情人节七夕母亲节圣诞节送老婆女友闺蜜生日礼物",
    "main_imgs": [
      "https://gd2.alicdn.com/imgextra/i3/2910384334/O1CN01aHvZlZ1ht1LI1Oevd_!!2910384334.jpg",
      "https://gd1.alicdn.com/imgextra/i1/2910384334/O1CN01I579zj1ht1KJ3Zoy8_!!2910384334.jpg",
      "https://gd3.alicdn.com/imgextra/i3/2910384334/O1CN019xMeA41ht1K8IlxZ3_!!2910384334.jpg",
      "https://gd2.alicdn.com/imgextra/i2/2910384334/O1CN01XM5Hd51ht1KBMuyJ8_!!2910384334.jpg",
      "https://gd1.alicdn.com/imgextra/i1/2910384334/O1CN01qILIMG1ht1KCtinL8_!!2910384334.jpg"
    ],
    "video_url": "http://cloud.video.taobao.com/play/u/p/1/e/6/t/1/374223637617.mp4",
    "currency": "CNY",
    "price_info": {
      "price": "311.0",
      "origin_price": "311.0"
    },
    "comment_count": null,
    "category_id": 121434005,
    "root_category_id": null,
    "product_props": [
      {
        "品牌": "CaringKleing"
      },
      {
        "质地": "牛皮"
      },
      {
        "皮质特征": "牛皮"
      },
      {
        "闭合方式": "搭扣"
      },
      {
        "图案": "纯色"
      },
      {
        "风格": "欧美"
      },
      {
        "形状": "横款"
      },
      {
        "成色": "全新"
      },
      {
        "性别": "女"
      },
      {
        "流行元素": "撞色"
      },
      {
        "颜色分类": "蓝配白 绿配白 白配黑 纯米白 黑配白 白配绿"
      },
      {
        "内部结构": "其他 大钞夹 零钱位 存折位 卡位 多隔层"
      },
      {
        "货号": "02504"
      },
      {
        "里料材质": "真皮"
      },
      {
        "适用对象": "青年"
      },
      {
        "折数": "3折"
      },
      {
        "款式": "其他"
      }
    ],
    "delivery_info": {
      "area_from": [
        "福建省",
        "泉州市"
      ],
      "area_id": "",
      "postage": "0"
    },
    "shop_info": {
      "shop_id": "163216017",
      "seller_id": 2910384334,
      "shop_name": "CaringKleing轻奢代购",
      "shop_url": "https://shop163216017.taobao.com",
      "shop_logo": "",
      "shop_rate": [
        {
          "title": "宝贝描述",
          "type": "desc",
          "score": 4.9512
        },
        {
          "title": "卖家服务",
          "type": "serv",
          "score": 4.96186
        },
        {
          "title": "物流服务",
          "type": "post",
          "score": 4.96426
        }
      ],
      "shop_start_time": "6年老店",
      "good_rate_percentage": null,
      "followers": null,
      "is_tmall": false,
      "wangwang": "https://amos.alicdn.com/getcid.aw?groupid=0&s=1&wJBSzD&charset=utf-8&uid=%E4%B9%90%E6%89%A3%E6%B7%98%E6%B8%85%E4%BB%93&site=cntaobao&B0qZNv"
    },
    "sku_props": [
      {
        "pid": "1627207",
        "prop_name": "颜色分类",
        "values": [
          {
            "vid": "19761432",
            "name": "蓝配白",
            "imageUrl": "https://gd3.alicdn.com/imgextra/i4/2910384334/O1CN014S8oYf1ht1KBMsDVh_!!2910384334.jpg"
          },
          {
            "vid": "19758489",
            "name": "绿配白",
            "imageUrl": "https://gd3.alicdn.com/imgextra/i4/2910384334/O1CN01sqapxf1ht1K64dxNc_!!2910384334.jpg"
          },
          {
            "vid": "11125089",
            "name": "白配黑",
            "imageUrl": "https://gd3.alicdn.com/imgextra/i3/2910384334/O1CN017Vogbd1ht1K64dLwS_!!2910384334.jpg"
          },
          {
            "vid": "9324927",
            "name": "纯米白",
            "imageUrl": "https://gd4.alicdn.com/imgextra/i4/2910384334/O1CN01czviru1ht1KAaThvH_!!2910384334.jpg"
          },
          {
            "vid": "12038984",
            "name": "黑配白",
            "imageUrl": "https://gd4.alicdn.com/imgextra/i1/2910384334/O1CN01Fy1UtL1ht1KBMrgLt_!!2910384334.jpg"
          },
          {
            "vid": "67054689",
            "name": "白配绿",
            "imageUrl": "https://gd1.alicdn.com/imgextra/i4/2910384334/O1CN01SsSddP1ht1K8IhfHm_!!2910384334.jpg"
          }
        ]
      }
    ],
    "skus": [
      {
        "skuid": "5058128667550",
        "sale_price": "311.0",
        "origin_price": "999.0",
        "stock": 200,
        "props_ids": "1627207:19761432",
        "props_names": "颜色分类:蓝配白",
        "sub_price": null,
        "sub_price_type": ""
      },
      {
        "skuid": "5058128667551",
        "sale_price": "311.0",
        "origin_price": "999.0",
        "stock": 200,
        "props_ids": "1627207:19758489",
        "props_names": "颜色分类:绿配白",
        "sub_price": null,
        "sub_price_type": ""
      },
      {
        "skuid": "5058128667552",
        "sale_price": "311.0",
        "origin_price": "999.0",
        "stock": 200,
        "props_ids": "1627207:11125089",
        "props_names": "颜色分类:白配黑",
        "sub_price": null,
        "sub_price_type": ""
      },
      {
        "skuid": "5058128667553",
        "sale_price": "311.0",
        "origin_price": "999.0",
        "stock": 200,
        "props_ids": "1627207:9324927",
        "props_names": "颜色分类:纯米白",
        "sub_price": null,
        "sub_price_type": ""
      },
      {
        "skuid": "5058128667554",
        "sale_price": "311.0",
        "origin_price": "999.0",
        "stock": 200,
        "props_ids": "1627207:12038984",
        "props_names": "颜色分类:黑配白",
        "sub_price": null,
        "sub_price_type": ""
      },
      {
        "skuid": "5058128667555",
        "sale_price": "311.0",
        "origin_price": "999.0",
        "stock": 200,
        "props_ids": "1627207:67054689",
        "props_names": "颜色分类:白配绿",
        "sub_price": null,
        "sub_price_type": ""
      }
    ],
    "extra": "False"
  }
}

```