{"uid":"cap_ujTzbezUZmL5VWfIZZr-C","slug":"agent-miner-tools-shopify-product-search-21f9e175","name":"Agent Miner Tools – Shopify Product Search","description":"Use when an agent already knows the product it wants and needs real current Shopify listings for a structured query. Returns normalized product/variant price, currency, seller, rating, product URL and checkout URL in upstream search-rank order, with an optional maximum item price. The query must already carry the compatibility and preference details. Not a recommendation engine, intent interpretation, web search, or cart/checkout.","url":"https://agent-api-production.tim1712.workers.dev/v1/shopping/product-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":10,"minimum":1},"query":{"type":"string","maxLength":256,"minLength":1},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"maxPriceMinor":{"type":"integer","minimum":0}}},"responseSchema":{"type":"json","example":{"query":"65W USB-C power bank 20000mAh airline safe","source":"shopify-global-catalog","country":"NL","currency":"EUR","products":[{"rating":{"count":88,"value":4.4},"seller":{"url":"https://poweredup.example","name":"PoweredUp","domain":"poweredup.example"},"currency":"EUR","productId":"gid://shopify/Product/3333333333","variantId":"gid://shopify/ProductVariant/4444444444","priceMinor":12999,"productUrl":"https://poweredup.example/products/pb-20000-65w","searchRank":0,"checkoutUrl":"https://poweredup.example/cart/4444444444:1","productTitle":"20000mAh 65W USB-C Power Bank","variantTitle":null}],"warnings":[],"checkedAt":"2026-08-30T10:00:02.000Z","maxPriceMinor":15000}},"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_rFFq161YIeAxWjCvsFzRV","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":"Searches the Shopify global catalog for real, current product listings matching a structured query, returning normalized price, currency, seller, rating, product URL, and checkout URL in search-rank order.","exampleAgentPrompt":"Search Shopify for up to 5 listings of a '65W USB-C power bank 20000mAh airline safe', priced under €150, in the Netherlands (NL) in EUR — give me the product title, price, seller, rating, and checkout URL for each result.","exampleUseCases":[{"title":"Budget electronics shopping in Europe","prompt":"Find me up to 5 Shopify listings for a '65W USB-C power bank 20000mAh airline safe' in the Netherlands, priced under €130, and show me the seller, rating, price in EUR, and the checkout URL for each one."},{"title":"Gift purchase with price cap","prompt":"I want to buy a LEGO Technic Bugatti Chiron set as a gift — search Shopify for up to 3 listings in the US in USD, keep it under $400, and give me the product URL, checkout URL, seller name, and current price for each result."},{"title":"Procurement agent sourcing office supplies","prompt":"Search Shopify for 'ergonomic wireless keyboard mechanical switches' in Germany (DE) with prices in EUR, limit to 10 results and filter out anything over €100 — I need the product title, seller domain, rating, and direct checkout link for each."}],"resultDescription":"A JSON object containing the original query, source ('shopify-global-catalog'), country, currency, a checkedAt timestamp, optional maxPriceMinor, optional warnings, and a ranked array of products. Each product includes productTitle, variantTitle, priceMinor, currency, productUrl, checkoutUrl, searchRank, productId, variantId, and a seller object (name, domain, url) plus a rating object (value, count).","failureModes":["Query string too long (>256 chars) — validation error","Invalid country code (not 2 uppercase letters) — validation error","Invalid currency code (not 3 uppercase letters) — validation error","Limit out of range (not 1–10) — validation error","No matching Shopify listings found — empty products array with possible warnings","Shopify catalog temporarily unavailable — upstream error response","maxPriceMinor too restrictive — empty products array returned","Payment not completed (x402) — request blocked before reaching search logic"],"whenToPreferThis":"Use this endpoint when the agent already has a specific, well-formed product query and needs real, current Shopify listings with structured pricing, seller, rating, and direct checkout URLs. Prefer this over generic web search when you need machine-readable normalized e-commerce data (priceMinor, variantId, checkoutUrl) in a specific country/currency. Do not use it for open-ended product discovery, intent interpretation, recommendations, or cart/checkout management — it is a structured catalog lookup, not a recommendation engine.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:25.786Z","isFirstParty":false}