{"uid":"cap_kBmm1wGNd7CuJ-YGSDLdZ","slug":"forgemesh-shopscout-product-search-5de9e900","name":"ForgeMesh ShopScout – Product Search","description":"Search Shopify catalog products by query, destination and currency. Requires an enabled catalog connector.","url":"https://shopscout.forgemesh.io/v1/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"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_TOvmpep3YdeSzewmkajHO","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":"Search Shopify catalog products by keyword query with optional country, currency, and price range filters, returning paginated results.","exampleAgentPrompt":"Search the ShopScout catalog for 'running shoes' available in the US, priced between $50 and $200, show me up to 15 results in USD.","exampleUseCases":[{"title":"Gift finder with budget filter","prompt":"Search the ShopScout catalog for 'wireless headphones' available in Canada, priced under $150 CAD, and show me the top 10 results."},{"title":"International product availability check","prompt":"Can you search ShopScout for 'yoga mat' in the UK catalog and show me up to 20 results priced in GBP?"},{"title":"Niche product discovery for reseller","prompt":"Search ShopScout for 'handmade ceramic mug' with a minimum price of $20 and maximum of $80 in USD for the US market, give me up to 10 results."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:30:34.443Z","isFirstParty":false,"canonicalSlug":"forgemesh-shopscout-product-search-5de9e900"}