Documentation

get_shop_products

Query verified products and catalog summaries for selected tracked shops.

Use get_shop_products after the user has selected one or more tracked shops and wants products, pricing, stock or catalog comparisons.

Inputs

FieldTypeRequiredNotes
storeIdsstring[]YesOne to five tracked shops
limitnumberYes1–20 products per shop
stockenumYesall, in_stock, out_of_stock
sortenumYesnewest, bestseller, price_low, price_high
minPricenumberNoNon-negative
maxPricenumberNoNon-negative
productTypestringNoProduct-category filter, up to 100 characters

Example call

{
  "storeIds": ["store_one"],
  "limit": 10,
  "stock": "in_stock",
  "sort": "newest",
  "minPrice": 20,
  "maxPrice": 100,
  "productType": "supplements"
}

Good prompt

Show the 10 newest in-stock supplements from this tracked shop,
priced between $20 and $100.

Use discover_products instead when the user wants to search across the global indexed catalog rather than selected tracked shops.

Credits

The maximum reservation is limit × number of shops. The final charge reflects products actually returned.