{"uid":"cap_c2qc7BEuI3A6xFzkrhYIx","slug":"forgemesh-shopscout-product-variant-lookup-a08e6a79","name":"ForgeMesh ShopScout – Product & Variant Lookup","description":"Retrieve current catalog details and variant options by Shopify identifier. Does not verify checkout or delivery.","url":"https://shopscout.forgemesh.io/v1/products/get?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"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_soYeDA0FpGja1KbsnMJBt","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":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Variant options before purchase","prompt":"Can you fetch the details for Shopify product gid://shopify/ProductVariant/44291830808704 and show me all available size and color options with current USD pricing for a US shopper?"},{"title":"Multi-currency product pricing","prompt":"I need to show a customer in Germany the current price and variant options for Shopify product gid://shopify/p/7723891234560 — get me the details priced in EUR for country code DE."},{"title":"Agent cart pre-fill check","prompt":"Before adding it to the cart, look up gid://shopify/p/9012345678901 on ShopScout and tell me what variants exist — I want the one in size Large and color Navy, priced in GBP for GB."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:30:48.973Z","isFirstParty":false,"canonicalSlug":"forgemesh-shopscout-product-variant-lookup-a08e6a79"}