Skip to main content
GET
/
v1
/
shopper
/
best-price
Find the best price for a product across retailers
curl --request GET \
  --url https://api.crushrewards.dev/v1/shopper/best-price
{
  "query": "<string>",
  "country": "<string>",
  "currency": "<string>",
  "best_price": {
    "product_name": "<string>",
    "retailer": "<string>",
    "price": 123,
    "list_price": 123,
    "savings_pct": 123,
    "in_stock": true,
    "scraped_at": "2023-11-07T05:31:56Z"
  },
  "other_prices": [
    {
      "retailer": "<string>",
      "price": 123,
      "in_stock": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://crushrewards.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

Response

Best price result

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