List Product Snapshots

curl -X GET "https://api.rxradar.xyz/v1/products/29/snapshots?days=30" \
  -H "Authorization: Bearer rx_YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.rxradar.xyz/v1/products/29/snapshots",
    headers={"Authorization": "Bearer rx_YOUR_API_KEY"},
    params={"days": 30, "per_page": 10}
)

data = response.json()

{
  "product_id": 29,
  "days": 30,
  "data": [
    {
      "id": 5638,
      "collected_at": "2026-04-29T17:34:54",
      "price": {
        "current": 12.95,
        "original": 14.50,
        "valid_until": "2026-05-15",
        "range": null,
        "has_promo": true,
        "currency": "USD"
      },
      "per_unit": {
        "price": 10.36,
        "unit": "100 ml"
      },
      "stock": {
        "available": true,
        "label": "In stock"
      },
      "rating": {
        "value": 4.6,
        "count": 28
      },
      "positions": [
        { "category": "Facial Cleansers", "rank": 12, "page": 1, "page_size": 30 },
        { "category": "Skincare", "rank": 40, "page": 2, "page_size": 30 }
      ],
      "promotions": [
        {
          "type": "bogo",
          "source_type": "BuyOneGetOne50",
          "title": "Spring Sale",
          "text": "Buy 1, Get 1 50% off",
          "terms": "Add two items to cart. While supplies last.",
          "code": null,
          "external_id": "promo-4827",
          "url": "https://store-a.com/promo/4827",
          "value": 50,
          "value_type": "percent",
          "min_quantity": 2,
          "min_amount": null,
          "scope": "online_only",
          "valid_from": "2026-04-25",
          "valid_until": "2026-05-15",
          "requires_loyalty": false
        }
      ],
      "badges": ["new"],
      "favorites_count": 342,
      "network": "cvs",
      "store": "cvs.com"
    }
  ],
  "total": 4,
  "page": 1,
  "per_page": 50,
  "pages": 1
}

GET

products

{product_id}

snapshots

curl -X GET "https://api.rxradar.xyz/v1/products/29/snapshots?days=30" \
  -H "Authorization: Bearer rx_YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.rxradar.xyz/v1/products/29/snapshots",
    headers={"Authorization": "Bearer rx_YOUR_API_KEY"},
    params={"days": 30, "per_page": 10}
)

data = response.json()

{
  "product_id": 29,
  "days": 30,
  "data": [
    {
      "id": 5638,
      "collected_at": "2026-04-29T17:34:54",
      "price": {
        "current": 12.95,
        "original": 14.50,
        "valid_until": "2026-05-15",
        "range": null,
        "has_promo": true,
        "currency": "USD"
      },
      "per_unit": {
        "price": 10.36,
        "unit": "100 ml"
      },
      "stock": {
        "available": true,
        "label": "In stock"
      },
      "rating": {
        "value": 4.6,
        "count": 28
      },
      "positions": [
        { "category": "Facial Cleansers", "rank": 12, "page": 1, "page_size": 30 },
        { "category": "Skincare", "rank": 40, "page": 2, "page_size": 30 }
      ],
      "promotions": [
        {
          "type": "bogo",
          "source_type": "BuyOneGetOne50",
          "title": "Spring Sale",
          "text": "Buy 1, Get 1 50% off",
          "terms": "Add two items to cart. While supplies last.",
          "code": null,
          "external_id": "promo-4827",
          "url": "https://store-a.com/promo/4827",
          "value": 50,
          "value_type": "percent",
          "min_quantity": 2,
          "min_amount": null,
          "scope": "online_only",
          "valid_from": "2026-04-25",
          "valid_until": "2026-05-15",
          "requires_loyalty": false
        }
      ],
      "badges": ["new"],
      "favorites_count": 342,
      "network": "cvs",
      "store": "cvs.com"
    }
  ],
  "total": 4,
  "page": 1,
  "per_page": 50,
  "pages": 1
}

integer

required

Product ID

integer

default:"30"

Number of days of history (max: 90)

integer

default:"1"

Page number

integer

default:"50"

Results per page (max: 100)

Description

Returns the full snapshot history for a product. Each snapshot contains the structured data collected: price, stock, rating, per-category positions and promotions.

curl -X GET "https://api.rxradar.xyz/v1/products/29/snapshots?days=30" \
  -H "Authorization: Bearer rx_YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.rxradar.xyz/v1/products/29/snapshots",
    headers={"Authorization": "Bearer rx_YOUR_API_KEY"},
    params={"days": 30, "per_page": 10}
)

data = response.json()

{
  "product_id": 29,
  "days": 30,
  "data": [
    {
      "id": 5638,
      "collected_at": "2026-04-29T17:34:54",
      "price": {
        "current": 12.95,
        "original": 14.50,
        "valid_until": "2026-05-15",
        "range": null,
        "has_promo": true,
        "currency": "USD"
      },
      "per_unit": {
        "price": 10.36,
        "unit": "100 ml"
      },
      "stock": {
        "available": true,
        "label": "In stock"
      },
      "rating": {
        "value": 4.6,
        "count": 28
      },
      "positions": [
        { "category": "Facial Cleansers", "rank": 12, "page": 1, "page_size": 30 },
        { "category": "Skincare", "rank": 40, "page": 2, "page_size": 30 }
      ],
      "promotions": [
        {
          "type": "bogo",
          "source_type": "BuyOneGetOne50",
          "title": "Spring Sale",
          "text": "Buy 1, Get 1 50% off",
          "terms": "Add two items to cart. While supplies last.",
          "code": null,
          "external_id": "promo-4827",
          "url": "https://store-a.com/promo/4827",
          "value": 50,
          "value_type": "percent",
          "min_quantity": 2,
          "min_amount": null,
          "scope": "online_only",
          "valid_from": "2026-04-25",
          "valid_until": "2026-05-15",
          "requires_loyalty": false
        }
      ],
      "badges": ["new"],
      "favorites_count": 342,
      "network": "cvs",
      "store": "cvs.com"
    }
  ],
  "total": 4,
  "page": 1,
  "per_page": 50,
  "pages": 1
}

Object structure

price

Field	Type	Description
`current`	float	Current shelf price
`original`	float	Strikethrough price (before discount), if any
`valid_until`	date	Date the current price is guaranteed until
`range`	string	Price range (when the product has variants)
`has_promo`	boolean	Whether at least one promotion is active
`currency`	string	ISO currency code (USD, ILS, …)

per_unit

Field	Type	Description
`price`	float	Comparable unit price (e.g. price per 100 ml)
`unit`	string	Reference quantity the unit price is based on (e.g. `100 ml`)

stock

Field	Type	Description
`available`	boolean	In stock
`label`	string	Availability label

rating

Field	Type	Description
`value`	float	Average rating
`count`	integer	Review count

positions

Array of the product’s position within each category it appears in for the period (empty if none). One object per category:

Field	Type	Description
`category`	string	Category name
`rank`	integer	Position within the category listing
`page`	integer	Page number
`page_size`	integer	Products per page

promotions

A list — a product can carry several promotions at once. Each item:

Field	Type	Description
`type`	string	Normalized kind: `bogo`, `coupon`, `bundle`, `loyalty`, `percent_off`, `amount_off`, `gift`, `free_delivery`, `other`
`source_type`	string	Raw promotion type as published by the store
`title`	string	Promotion title
`text`	string	Human-readable offer text (“Buy 1, Get 1 50% off”)
`terms`	string	Conditions / fine print
`code`	string	Coupon code, if any
`external_id`	string	Store-side promotion identifier
`url`	string	Link to the promotion page, if any
`value`	float	Discount magnitude (e.g. `50`)
`value_type`	string	Unit of `value`: `percent`, `amount`, `price` (resulting member price), `points` (loyalty points) or `quantity` (units offered free on a buy-N-get-M deal, with `min_quantity` = N)
`min_quantity`	integer	Minimum quantity to qualify
`min_amount`	float	Minimum spend to qualify
`scope`	string	Where the offer applies: `online_only`, `in_store` or `all`
`valid_from`	date	Start date
`valid_until`	date	End date
`requires_loyalty`	boolean	Whether a loyalty membership is required

badges

List of normalized flags on the product (e.g. new, exclusive, otc, marketplace).

favorites_count

Integer — how many shoppers have added the product to their wishlist (when the store exposes it).

List Product Variants List Snapshots

​Description

​Object structure

​price

​per_unit

​stock

​rating

​positions

​promotions

​badges

​favorites_count

Description

Object structure

price

per_unit

stock

rating

positions

promotions

badges

favorites_count