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

## 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

`POST https://api.tmapi.io/price_comparison/v2/historical_price_by_url/cn`

## Request Parameters

### Body

> Content-Type: application/json

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| period |  | Period<br/>Default value: 360 | false |
| url | string | Product URL | 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 POST 'https://api.tmapi.io/price_comparison/v2/historical_price_by_url/cn?apiToken=xxxxxx' \
+  --header 'Content-Type: application/json' \
+  --data-raw '{
  "period": "360",
  "url": "https://detail.tmall.com/item.htm?id=688361462703"
}'

```

## 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
  }
}

```