curl-bash

curl + bash examples

Every documented endpoint in shell. Requires curl + jq.

chmod +x lookup.sh
RETAILERAPI_KEY=rk_live_… ./lookup.sh 19667262713

One-liners:

# Product
curl -H "Authorization: Bearer $RETAILERAPI_KEY" \
  "https://api.retailerapi.com/v1/products/19667262713" | jq

# Cross-retailer
curl -H "Authorization: Bearer $RETAILERAPI_KEY" \
  "https://api.retailerapi.com/v1/products/19667262713?include_cross_retailer=true" | jq '.cross_retailer'

# Price history
curl -H "Authorization: Bearer $RETAILERAPI_KEY" \
  "https://api.retailerapi.com/v1/products/19667262713/history?timeframe=90d" | jq

# Reviews
curl -H "Authorization: Bearer $RETAILERAPI_KEY" \
  "https://api.retailerapi.com/v1/products/19667262713/reviews" | jq

# Seller profile
curl -H "Authorization: Bearer $RETAILERAPI_KEY" \
  "https://api.retailerapi.com/v1/sellers/F55CDC31AB754BB68FE0B39041159D63" | jq

# Force refresh (POST)
curl -X POST -H "Authorization: Bearer $RETAILERAPI_KEY" \
  "https://api.retailerapi.com/v1/products/19667262713/refresh" | jq

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

Rate-limit headers

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

Full reference: docs.retailerapi.com.