# TikTok shop API - Get TikTok shop product details(By ID)

## API Overview

- Product basic information (title/category/price)
- Main images
- Detailed description
- Shop information (Shop name, shop ID, etc.)
- Review information (rating star/review count)
- Item status
- Promotion information
- See More

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| site | string | Region name abbreviation, for example, Thailand is 'th'.<br/>Optional values: `id`, `vn`, `my`, `th`, `ph`, `sg`, `us`, `uk` | true |
| 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/tikshop/item_detail?apiToken=xxxxxx&site=my&item_id=3618139098465860000'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": 1729556436942358000,
    "product_url": "https://shop.tiktok.com/view/product/1729556436942358002",
    "title": "KEEPRO NEW Woven design PU leather PRO Series Badminton Racquet Bag",
    "category_name": "Sukan & Luar Rumah",
    "main_imgs": [
      "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/56564a1b8fce493688a256ca30011033~tplv-aphluv4xwc-resize-webp:800:800.webp?from=1826719393",
      "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/5b440d86494540908b723f0078eb9e33~tplv-aphluv4xwc-resize-webp:800:800.webp?from=1826719393",
      "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/ed13414473ce45218276f169e287d9e6~tplv-aphluv4xwc-resize-webp:800:800.webp?from=1826719393"
    ],
    "video_url": "",
    "desc_obj": [
      {
        "type": "text",
        "content": "100% ORIGINAL\n100% MONEY BACK GUARANTEE!\n\nKEEPRO PRO SERIES Badminton Racquet Bag OVERSIZED HIGH QUALITY KBC-23W \n "
      },
      {
        "type": "text",
        "content": "PU Material"
      },
      {
        "type": "text",
        "content": "Water Resistant"
      },
      {
        "type": "text",
        "content": "Thermal Lining"
      },
      {
        "type": "text",
        "content": "Inverted Zipper (KBC-23W )"
      },
      {
        "type": "text",
        "content": "OVERSIZE"
      },
      {
        "type": "text",
        "content": "SHOE COMPARTMENT"
      },
      {
        "type": "text",
        "content": "Accessories Organizer"
      },
      {
        "type": "text",
        "content": "Comfortable Shoulder Strap"
      },
      {
        "type": "text",
        "content": " "
      },
      {
        "type": "text",
        "content": "Measurement"
      },
      {
        "type": "text",
        "content": "Dimensions: L 74 x W 32 x H 31cm"
      },
      {
        "type": "text",
        "content": "Can fits 6-10 RACKETS shown in picture"
      }
    ],
    "currency": "MYR",
    "price_info": {
      "price": "154.90",
      "origin_price": "179.90"
    },
    "delivery_info": {
      "area_from": "local",
      "postage": "12.3",
      "is_free_shipping": false,
      "is_support_cod": false,
      "shipping_type": "standard",
      "delivery_min_days": 2,
      "delivery_max_days": 5
    },
    "shop_info": {
      "shop_id": "7494629757824764402",
      "seller_id": "7494629757824764402",
      "shop_name": "Sixteen Sports Cheras",
      "shop_location": "Malaysia",
      "shop_url": "aweme://ec/store?sellerId=7494629757824764402&url_maker=store_rpc&store_page_version=1",
      "shop_logo": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/7220334d431949e0972ce009d8d8d09b~tplv-aphluv4xwc-resize-png:300:300.png?from=2422056039",
      "shop_rate": {
        "score": "4.2",
        "response_rate": "89%",
        "delivery_rate": null
      },
      "is_recommend": true,
      "is_hide": false,
      "all_items_count": 361,
      "shop_sales_count": 54,
      "shop_comment_count": 20,
      "shop_status": 2
    },
    "comment_count": 0,
    "sales_count": 0,
    "sku_props": [
      {
        "pid": "6978684608401540870",
        "prop_name": "Specification",
        "values": [
          {
            "vid": "6932748025291032321",
            "name": "Default",
            "imageUrl": ""
          }
        ]
      }
    ],
    "skus": [
      {
        "skuid": "1729556436942423538",
        "props_ids": "6978684608401540870:6932748025291032321",
        "props_names": "Specification:Default",
        "sale_price": "154.9",
        "origin_price": "",
        "stock": 24,
        "limit_count": 20,
        "status": 1
      }
    ],
    "promotions": [
      {
        "title": null,
        "content": "Cashback 5%",
        "threshold": "Bagi pesanan melebihi RM34",
        "start_time": 1710864000,
        "end_time": 1711468800,
        "valid_time": "Sah dari 03/19/2024 - 03/26/2024",
        "promotion_id": "7348015962060228359",
        "type_id": "7348015962060228359"
      },
      {
        "title": null,
        "content": "Diskaun sebanyak RM25",
        "threshold": "Tiada perbelanjaan min.",
        "start_time": 0,
        "end_time": 0,
        "valid_time": "Sah 1 hari dari tarikh penebusan",
        "promotion_id": "7348747664453961479",
        "type_id": "7348747664453961479"
      },
      {
        "title": "Baucar penghantaran",
        "content": "Diskaun RM8 untuk penghantaran, Tiada perbelanjaan minimum",
        "threshold": "Tiada perbelanjaan minimum",
        "start_time": 0,
        "end_time": 0,
        "valid_time": "Sah 1 hari dari tarikh penebusan",
        "promotion_id": "7349013556043745031",
        "type_id": "7349013556043745031"
      },
      {
        "title": null,
        "content": "Diskaun sebanyak RM30",
        "threshold": "Bagi pesanan melebihi RM250",
        "start_time": 1711296000,
        "end_time": 1711382400,
        "valid_time": "Sah dari 03/24/2024 - 03/25/2024",
        "promotion_id": "7349036528955606791",
        "type_id": "7349036528955606791"
      }
    ],
    "buy_enable": true,
    "extra": "req:1;"
  }
}

```