{"uid":"cap_aCoktV85BGEQJfVjDyRPW","slug":"forgemesh-shopscout-variant-offer-refresh-price-ranking-8b98aa9e","name":"ForgeMesh ShopScout - Variant Offer Refresh & Price Ranking","description":"Refresh specified variant offers and rank available offers by item price in one currency. Equivalence and landed totals are not verified.","url":"https://shopscout.forgemesh.io/v1/compare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z3n4d377FedQa2F-ttiKd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Refresh live offers for specified Shopify product variants and rank them by item price in a single currency","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Cheapest variant finder for shoppers","prompt":"I have these three Shopify variant IDs for the same sneaker in different colors — gid://shopify/ProductVariant/111, gid://shopify/ProductVariant/222, and gid://shopify/ProductVariant/333 — can you refresh their prices and tell me which is cheapest right now in GBP for the UK?"},{"title":"Price monitoring agent for resellers","prompt":"Refresh the live offer prices for these five Shopify variants and rank them by item price in EUR for Germany: gid://shopify/ProductVariant/401, /402, /403, /404, /405 — I want to know which is the best deal at this moment."},{"title":"Catalog price audit for merchants","prompt":"Pull fresh offer data for these two product variants — gid://shopify/ProductVariant/9001 and gid://shopify/ProductVariant/9002 — and rank them by price in CAD for Canada so I can see which listing is currently lower."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:38:04.662Z","isFirstParty":false,"canonicalSlug":"forgemesh-shopscout-variant-offer-refresh-price-ranking-8b98aa9e"}