Price Tracking

Get the price and stock of active listings matching name or keywords.

GET

https://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, HKD Defaults to USD.	USD

Example Request

JavaScript

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

curl -X GET https://api.cardtradehk.com/price-track?query=2022-23%20Panini%20Revolution%20Soccer

Try it now

Click to send a sample request

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