Skip to main content
GET
/
public
/
pricehistory
Get price history for a product
curl --request GET \
  --url https://api.joylink.io/public/pricehistory \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "asin": "<string>",
  "skip": 123
}'
[
  {
    "asin": "<string>",
    "merchant_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "retail_price": 123,
    "discounted_price": 123,
    "pessimistic_discounted_price": 123,
    "pessimistic_discounts": [
      "<string>"
    ],
    "encrypted_promo": "<string>",
    "promo_code": "<string>",
    "page_promo": "<string>",
    "is_lightning": true,
    "lightning_discount_percentage": 123,
    "promo_expiry_date": 123,
    "promo_discount_percentage": 123,
    "coupon_id": "<string>",
    "coupon_value": "<string>",
    "extra_discount_amount": "<string>"
  }
]

Authorizations

X-API-Key
string
header
required

Body

application/json
asin
string
required

Amazon Standard Identification Number

skip
integer

Number of records to skip (pagination offset)

Response

Successfully retrieved price history

asin
string

Amazon Standard Identification Number

merchant_id
string

Merchant identifier

timestamp
string<date-time>

Time when the price was recorded

retail_price
number

Original retail price

discounted_price
number

Price after applying discounts

pessimistic_discounted_price
number

Conservative estimate of discounted price

pessimistic_discounts
string[]

Conservative discount types

encrypted_promo
string

Encrypted promotion data

promo_code
string

Promotional code

page_promo
string

Page promotion details

is_lightning
boolean

Whether item is a lightning deal

lightning_discount_percentage
number

Lightning deal discount percentage

promo_expiry_date
integer

Promotion expiration timestamp

promo_discount_percentage
number

Promotion discount percentage

coupon_id
string

Coupon identifier

coupon_value
string

Value of the coupon ($x or x%)

extra_discount_amount
string

Additional discount amount ($x or x%)