# ForgeMesh ShopScout – Product & Variant Lookup

> ForgeMesh ShopScout – Product & Variant Lookup 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).

Retrieve current catalog details and variant options for a Shopify product or product variant by its Shopify GID, including pricing in a specified currency and country context.

## Facts

- Endpoint: POST https://shopscout.forgemesh.io/v1/products/get?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-product-variant-lookup-a08e6a79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c2qc7BEuI3A6xFzkrhYIx

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-variant-lookup-a08e6a79 -d '<json body>'
```

Example prompt: Pull the full catalog details and available variant options for Shopify product gid://shopify/p/8834521776320, priced in USD for a US customer — I want to see all the size and color options available.

## When to prefer this

Use this endpoint when you need to look up current catalog details, pricing, and variant options for a known Shopify product or variant by its GID. Prefer this over the search endpoint when you already have the Shopify identifier. Note that this endpoint does not verify checkout availability or delivery options — use sibling endpoints for basket comparison or offer ranking.

## Known failure modes

- Invalid or malformed Shopify GID returns a validation error
- Unsupported country code or currency code returns a parameter error
- Product or variant not found returns a not-found error
- Catalog connector not enabled or not authorized returns an access error
- Network or upstream Shopify API timeout returns a service error

## How this service works

Retrieve current catalog details and variant options by Shopify identifier. Does not verify checkout or delivery.

## Output

Returns current catalog details for the requested Shopify product or variant, including available variant options (e.g. size, color), current pricing in the requested currency and country context, and product metadata. Does not include checkout availability or delivery estimates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string",
   "pattern": "^gid://shopify/(p|ProductVariant)/[a-zA-Z0-9_-]+$",
   "maxLength": 200
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Z]{2}$"
  },
  "currency": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "selected": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "label"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
     },
     "label": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-shopscout-product-variant-lookup-a08e6a79/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)