cURL examples

Single product lookup

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

Product lookup with cross-retailer cells

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

Reseller full view (cross-retailer + seller context)

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

Live offers + reviews

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

Force a fresh scrape of a specific retailer

force_refresh is only valid with ?retailer=<slug> — the base call has no force_refresh option. To refresh data, specify which retailer. The identifier must be a UPC/EAN/ISBN/GTIN/ASIN — Walmart item_ids cannot be paired with ?retailer= for a non-Walmart slug.

curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/194629116676?retailer=amazon&force_refresh=true"

Submit a retailer URL instead of an identifier

The path accepts any retailer PDP URL (URL-encoded). Works on the 7 vetted retailers (Amazon, Walmart, Target, Home Depot, Lowe's, Best Buy, eBay), every Shopify store via the public /products/<handle>.json endpoint, and any other storefront with Product JSON-LD or OpenGraph product tags in its initial HTML. Cost is 1 token regardless.

# Amazon ASIN URL
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/$(printf %s 'https://www.amazon.com/dp/B09TG79MYT' | jq -sRr @uri)"

# Walmart item URL (any of /ip/, /p/, /grocery/ip/)
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/$(printf %s 'https://www.walmart.com/ip/19667262713' | jq -sRr @uri)"

# Any Shopify store — try the .json shortcut via URL submission
curl -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/$(printf %s 'https://www.allbirds.com/products/trino-cozy-crew-heathered-onyx' | jq -sRr @uri)"

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

Read computed marketplace fees

curl -s -H "Authorization: Bearer rk_live_..." \
  "https://api.retailerapi.com/v1/products/19667262713" \
  | jq '.cross_retailer.walmart.seller_context | {referral_fee_usd, wfs_fee_usd}'

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)"