cURL examples

Copy-paste working examples for every endpoint.

Single product lookup

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713"

Product lookup with cross-retailer

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713?include_cross_retailer=true"

Price history (90 days, Walmart)

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713/history?timeframe=90d"

Price history (all retailers, 1 year)

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713/history?timeframe=1y&retailer=all"

Reviews summary

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713/reviews"

Seller profile

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/sellers/F55CDC31AB754BB68FE0B39041159D63"

Force a fresh fetch

curl -X POST -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713/refresh"

Bulk lookup (loop)

for upc in 19667262713 194629116676 728028502244; do
  curl -s -H "Authorization: Bearer rk_live_..." \
    "https://api.retailerapi.com/v1/products/$upc" | jq '.title, .current_price'
done

Save token-remaining state

curl -i -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713" 2>&1 \
  | grep -E "(X-RateLimit|HTTP)"