# ForgeMesh ShopScout - Variant Offer Refresh & Price Ranking

> ForgeMesh ShopScout - Variant Offer Refresh & Price Ranking 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-11).

Refresh live offers for specified Shopify product variants and rank them by item price in a single currency

## Facts

- Endpoint: POST https://shopscout.forgemesh.io/v1/compare?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-shopscout-variant-offer-refresh-price-ranking-8b98aa9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aCoktV85BGEQJfVjDyRPW

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-variant-offer-refresh-price-ranking-8b98aa9e -d '<json body>'
```

Example prompt: Can you refresh the current offers for these Shopify variant IDs — gid://shopify/ProductVariant/12345 and gid://shopify/ProductVariant/67890 — and rank them cheapest to most expensive in USD for deliveries to the US?

## When to prefer this

Use this endpoint when you need a quick, ranked price snapshot across a known set of Shopify product variant IDs in a specific currency and country context. It is ideal for real-time cheapest-option lookups, price monitoring agents, or catalog audits where you already know the variant IDs. Do not use it when you need verified landed costs (including shipping and taxes), need to search for variants by keyword, or need basket/split-order optimization — sibling endpoints handle those scenarios.

## Known failure modes

- Invalid variant ID format (must match gid://shopify/ProductVariant/{digits}) returns a validation error
- Fewer than 2 or more than 10 variant IDs causes a schema rejection
- Unsupported or unrecognized country/currency codes may return no results or an error
- Variants with no active offers may return empty offer lists
- Network or upstream Shopify catalog availability issues may cause stale or missing data

## How this service works

Refresh specified variant offers and rank available offers by item price in one currency. Equivalence and landed totals are not verified.

## Output

A list of offers for the requested Shopify product variants, refreshed with current pricing data and ranked in ascending order by item price in the specified currency. Note: landed totals (e.g. shipping, taxes) and currency equivalence are not verified or included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "pattern": "^[A-Z]{2}$"
  },
  "currency": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "variant_ids": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^gid://shopify/ProductVariant/[0-9]+$",
    "maxLength": 200
   },
   "maxItems": 10,
   "minItems": 2,
   "uniqueItems": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-shopscout-variant-offer-refresh-price-ranking-8b98aa9e/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)