Price Tracking
Get the price and stock of active listings matching name or keywords.
GEThttps://api.cardtradehk.com/price-track
Request Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| query | String | Required | Product name / Keywords. Resulted listings title must contain words inside query.Case and word order insensitive | 2022-23 Panini Revolution Soccer |
| currency | String | Optional | Currency the resulted prices are in, rounded up to 2 decimal places. Available values: USD, HKDDefaults to USD. | USD |
Example Request
- JavaScript
- CURL
fetch(
'https://api.cardtradehk.com/price-track?query=2022-23%20Panini%20Revolution%20Soccer'
)
.then((response) => response.json())
.then((result) => console.log(result))
.catch((error) => console.log('error', error));
curl -X GET https://api.cardtradehk.com/price-track?query=2022-23%20Panini%20Revolution%20Soccer
Try it now
Response
| Status Code | Description |
|---|---|
| 200 | Successful Request |
| 400 | Invalid Parameters |
| 429 | Rate Limited: 1000 requests / 15 mins |
| 500 | Server Error |
Response Types
| Key | Type | Description |
|---|---|---|
| prices | Prices / Null | The prices of the resulted listings, null if no listing are found |
| stock | Number | Sum of stock from all resulted listings |
| url | String | URL to matched listings on CardTradeHK |
| listings | Listing[] | Array of the resulted listings |
Prices
| Key | Type | Description |
|---|---|---|
| average | Number | Average unit price of the resulted listing |
| highest | Number | Highest unit price of the resulted listing |
| lowest | Number | Lowest unit price of the resulted listing |
Listing
| Key | Type | Description |
|---|---|---|
| itemNumber | String | Item number on CardTradeHK unique to each listing |
| sellername | String | Username of seller on CardTradeHK |
| category | String | Listing category |
| title | String | Listing title |
| currency | String | Listing unit price currency |
| unitPrice | String | Listing unit price |
| unitPriceInHkd | String | Listing unit price in Hong Kong Dollars |
| stock | Number | Listing stock |
Example Response
{
"prices": {
"average": 100.0,
"highest": 100.0,
"lowest": 100.0
},
"stock": 5,
"url": "https://www.cardtradehk.com/en/products?query=2022-23%20Panini%20Revolution%20Soccer&order=LOWEST_PRICE",
"listings": [
{
"itemNumber": "854310742960",
"sellername": "sellername",
"category": "SOCCER",
"title": "2022-23 Panini Revolution Soccer Hobby box",
"currency": "HKD",
"unitPrice": 780,
"unitPriceInHkd": 780,
"stock": 5
}
]
}