Guide

Use Products watch routes

Search products, inspect offers and price history, then register a bootstrap watch with a stable SmartAPIs.net request contract.

1. Search reviewed products

curl

curl \
  -H "X-API-Key: $SMARTAPIS_API_KEY" \
  "https://smartapis.net/v1/products/search?region_id=new-york-city&q=coffee&brand=Blue%20Bottle&limit=5"

2. Inspect offers and price history

curl

curl \
  -H "X-API-Key: $SMARTAPIS_API_KEY" \
  https://smartapis.net/v1/products/product_nyc_001/offers

curl \
  -H "X-API-Key: $SMARTAPIS_API_KEY" \
  https://smartapis.net/v1/products/product_nyc_001/price-history

Product identity fields are source-grounded. Offer and price-history results are SmartAPIs snapshot outputs built from legally reviewed source feeds.

3. Register a bootstrap product watch

curl

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $SMARTAPIS_API_KEY" \
  -d '{
    "region_id": "new-york-city",
    "query": "coffee",
    "brand": "Blue Bottle",
    "trigger": "daily_price_snapshot_change",
    "delivery_channel": "email_confirmation_only",
    "cadence_hours": 24
  }' \
  https://smartapis.net/v1/products/watch

The watch route is an honest bootstrap intake surface. It is suitable for stable app and agent workflows now, even though durable deliveries are still a later expansion.