Skip to main content
GET
Find the best price for a product across retailers

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
limit
integer
default:10

Max results to return (default 10, max 50)

Required range: x <= 50

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"

limit
integer
default:10

Max results to return (default 10, max 50)

Required range: x <= 50
Example:

10

Response

Best price result

query
string
country
string
currency
string
best_price
object
other_prices
object[]