# Price comparison API - Get the historical price trend of a product(By ID)

## API Overview

- Price trend and promotions of the product within a specified period
- Support for Major Chinese e-commerce platforms such as Taobao, Tmall, JD, VIP.COM, Pinduoduo, and more
- See More

## API URL

`GET https://api.tmapi.io/price_comparison/v2/historical_price/cn`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| item_id | integer | Product ID | true |
| plat | string | Platform name<br/>Optional values: `taobao`, `pdd`, `jd`, `vip`, `dangdang`, `kaola`, `xmyp`<br/>Default value: taobao | false |
| period | string | Period<br/>Optional values: `30`, `60`, `360`<br/>Default value: 360 | 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/price_comparison/v2/historical_price/cn?apiToken=xxxxxx&item_id=&plat=taobao&period=360'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "price_detail": {
      "price_max": 129000,
      "price_max_timestamp": 1635609600,
      "price_min": 107000,
      "price_min_timestamp": 1633276800,
      "price_current": 128500,
      "trend": "up",
      "trend_detail": [
        {
          "x": 1615651200,
          "y": 129000
        },
        {
          "x": 1617465600,
          "y": 129000
        },
        {
          "x": 1617552000,
          "y": 119000
        },
        {
          "x": 1617638400,
          "y": 129000
        },
        {
          "x": 1617811200,
          "y": 129000
        },
        {
          "x": 1617897600,
          "y": 107000
        },
        {
          "x": 1617984000,
          "y": 129000
        },
        {
          "x": 1621180800,
          "y": 129000
        },
        {
          "x": 1621267200,
          "y": 119000
        },
        {
          "x": 1621353600,
          "y": 129000
        },
        {
          "x": 1621440000,
          "y": 129000
        },
        {
          "x": 1621526400,
          "y": 119000
        },
        {
          "x": 1621612800,
          "y": 129000
        },
        {
          "x": 1621958400,
          "y": 129000
        },
        {
          "x": 1622044800,
          "y": 119000
        },
        {
          "x": 1622131200,
          "y": 129000
        },
        {
          "x": 1624550400,
          "y": 129000
        },
        {
          "x": 1624636800,
          "y": 119000
        },
        {
          "x": 1624723200,
          "y": 129000
        },
        {
          "x": 1629820800,
          "y": 129000
        },
        {
          "x": 1629907200,
          "y": 109000
        },
        {
          "x": 1629993600,
          "y": 129000
        },
        {
          "x": 1631980800,
          "y": 129000
        },
        {
          "x": 1632067200,
          "y": 119000
        },
        {
          "x": 1632153600,
          "y": 129000
        },
        {
          "x": 1633190400,
          "y": 129000
        },
        {
          "x": 1633276800,
          "y": 107000
        },
        {
          "x": 1633363200,
          "y": 129000
        },
        {
          "x": 1635609600,
          "y": 129000
        },
        {
          "x": 1635696000,
          "y": 115600
        },
        {
          "x": 1636560000,
          "y": 115600
        },
        {
          "x": 1636646400,
          "y": 128500
        },
        {
          "x": 1636905600,
          "y": 128500
        }
      ],
      "period": 360
    },
    "promote_detail": [
      {
        "price": 107000,
        "price_origin": 129000,
        "timestamp": 1633276800,
        "promote_detail": [
          {
            "tag": "券",
            "text": "220元券"
          }
        ]
      },
      {
        "price": 107000,
        "price_origin": 129000,
        "timestamp": 1633276800,
        "promote_detail": [
          {
            "tag": "券",
            "text": "220元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1632067200,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1632067200,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 109000,
        "price_origin": 129000,
        "timestamp": 1629907200,
        "promote_detail": [
          {
            "tag": "券",
            "text": "200元券"
          }
        ]
      },
      {
        "price": 109000,
        "price_origin": 129000,
        "timestamp": 1629907200,
        "promote_detail": [
          {
            "tag": "券",
            "text": "200元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1624636800,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1624636800,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1622044800,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1622044800,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1621526400,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1621526400,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1621267200,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1621267200,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 107000,
        "price_origin": 129000,
        "timestamp": 1617897600,
        "promote_detail": [
          {
            "tag": "券",
            "text": "220元券"
          }
        ]
      },
      {
        "price": 107000,
        "price_origin": 129000,
        "timestamp": 1617897600,
        "promote_detail": [
          {
            "tag": "券",
            "text": "220元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1617552000,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      },
      {
        "price": 119000,
        "price_origin": 129000,
        "timestamp": 1617552000,
        "promote_detail": [
          {
            "tag": "券",
            "text": "100元券"
          }
        ]
      }
    ],
    "item_id": 636832416616
  }
}

```