Skip to main content
GET
Track a brand's pricing and presence over time

Query Parameters

brand
string
required

Brand name (e.g., Sony, Samsung, Nike)

Minimum string length: 1
country
enum<string>
default:us

Country (us or ca)

Available options:
us,
ca
retailer
enum<string>

Filter to a specific retailer platform (long-tail specialty stores are also present; any platform key is accepted)

Available options:
amazon,
walmart,
target,
bestbuy,
homedepot,
costco,
ikea,
samsclub,
cvs,
dillards
time_window
enum<string>

Historical window preset. Explicit from/to takes precedence and is reported as custom; time_window=custom requires both from and to. Date-only ranges use UTC calendar boundaries with inclusive from and exclusive to.

Available options:
last_30_days,
last_60_days,
last_90_days,
month_to_date,
previous_month,
month_over_month,
quarter_to_date,
custom
from
string<date>

Start date (ISO 8601, defaults to 30 days ago)

to
string<date>

End date (ISO 8601, defaults to now)

Response

Brand tracking data

brand
string
country
string
currency
string
retailer
string | null
window
object
sample_threshold
integer
insufficient_sample_points
integer
insufficient_sample
boolean

True when any series point has a basket below sample_threshold.

stable_basket_size
integer | null

Products priced in every period of the series (the basis of stable_avg_price). Null for single-point series.

time_series
object[]
meta
object