Skip to main content
GET
Get price history for a product over time

Query Parameters

q
string
required

Search query (product name, keyword, or category term)

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

Available options:
amazon,
walmart,
costco,
homedepot,
nordstrom,
ikea
from
string<date>

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

to
string<date>

End date (ISO 8601, defaults to now)

Body

application/json

Query parameters as JSON (alternative to URL query string for agents that prefer body-based invocation).

q
string
required

Search query (product name, keyword, or category term)

Minimum string length: 1
Example:

"airpods"

country
enum<string>
default:us

Country (us or ca)

Available options:
us,
ca
Example:

"us"

retailer
enum<string>

Filter to a specific retailer

Available options:
amazon,
walmart,
costco,
homedepot,
nordstrom,
ikea
Example:

"amazon"

from
string<date>

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

Example:

"2026-04-01"

to
string<date>

End date (ISO 8601, defaults to now)

Example:

"2026-05-01"

Response

Price history

query
string
history
object[]