# ForgeMesh ShopScout – Product Search

> ForgeMesh ShopScout – Product Search is a paid API for AI agents from shopscout.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Search Shopify catalog products by keyword query with optional country, currency, and price range filters, returning paginated results.

## Facts

- Endpoint: POST https://shopscout.forgemesh.io/v1/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-shopscout-product-search-5de9e900
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kBmm1wGNd7CuJ-YGSDLdZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-shopscout-product-search-5de9e900 -d '<json body>'
```

Example prompt: Search the ShopScout catalog for 'running shoes' available in the US, priced between $50 and $200, show me up to 15 results in USD.

## When to prefer this

Choose this endpoint when you need to search a Shopify-powered store's product catalog by keyword with optional geo-pricing localization and price range filtering. It is the right first step in a shopping workflow — use it before fetching product details, refreshing offers, or comparing baskets. Prefer it when you need paginated browsing of catalog results rather than direct lookup by a known product identifier.

## Known failure modes

- No catalog connector enabled — returns an error requiring connector setup before search is available
- Query too long or empty — rejected by pattern/length validation
- Invalid country or currency code — rejected if not matching 2-letter ISO country or 3-letter ISO currency patterns
- Price range conflict — min_price_minor greater than max_price_minor may return empty results or error
- Limit out of range — values below 1 or above 20 are rejected
- No matching results — returns empty result set if no products match the query and filters
- Pagination cursor invalid or expired — returns error when cursor is malformed or stale

## How this service works

Search Shopify catalog products by query, destination and currency. Requires an enabled catalog connector.

## Output

Returns a paginated list of Shopify catalog products matching the query, including product names, variant details, and localized pricing in the requested currency and country. A pagination cursor is included to fetch subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "pattern": "\\S",
   "maxLength": 500,
   "minLength": 1
  },
  "cursor": {
   "type": "string",
   "maxLength": 4096,
   "minLength": 1
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Z]{2}$"
  },
  "currency": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "max_price_minor": {
   "type": "integer",
   "maximum": 1000000000,
   "minimum": 0
  },
  "min_price_minor": {
   "type": "integer",
   "maximum": 1000000000,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-shopscout-product-search-5de9e900/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from shopscout.forgemesh.io](https://www.zero.xyz/host/shopscout.forgemesh.io/llms.txt)