{"uid":"cap_yl_FiyJL68CR3PmD3ESvG","slug":"agent-miner-tools-budget-basket-multi-need-shopify-shopper-35606467","name":"Agent Miner Tools – Budget Basket (Multi-Need Shopify Shopper)","description":"Use when an agent already knows several products/categories a buyer needs and wants one real Shopify product for each need while staying within one overall item-price budget. Each need.query must already carry the important compatibility and preference details; this service does not reinterpret intent. Returns a cross-merchant basket plan with per-item checkout URLs. It is not a generic product search and does not create carts or checkouts.","url":"https://agent-api-production.tim1712.workers.dev/v1/shopping/budget-basket","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"needs":{"type":"array","items":{"type":"object","required":["id","query"],"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,64}$"},"query":{"type":"string","maxLength":256,"minLength":1},"priority":{"type":"integer","maximum":10,"minimum":1},"maxPriceMinor":{"type":"integer","minimum":0}},"additionalProperties":false}},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"budgetMinor":{"type":"integer","minimum":0}}},"responseSchema":{"type":"json","example":{"items":[{"query":"wireless lavalier microphone for iPhone USB-C","needId":"microphone","rating":{"count":214,"value":4.6},"seller":{"url":"https://example-merch.example","name":"Example Merch","domain":"example-merch.example"},"currency":"EUR","priority":10,"productId":"gid://shopify/Product/1111111111","variantId":"gid://shopify/ProductVariant/2222222222","priceMinor":17999,"productUrl":"https://example-merch.example/products/usb-c-wireless-lavalier","searchRank":0,"checkoutUrl":"https://example-merch.example/cart/2222222222:1","productTitle":"USB-C Wireless Lavalier Microphone","variantTitle":"Single mic + USB-C receiver"},{"query":"65W USB-C power bank 20000mAh airline safe","needId":"power-bank","rating":{"count":88,"value":4.4},"seller":{"url":"https://poweredup.example","name":"PoweredUp","domain":"poweredup.example"},"currency":"EUR","priority":6,"productId":"gid://shopify/Product/3333333333","variantId":"gid://shopify/ProductVariant/4444444444","priceMinor":13299,"productUrl":"https://poweredup.example/products/pb-20000-65w","searchRank":1,"checkoutUrl":"https://poweredup.example/cart/4444444444:1","productTitle":"20000mAh 65W USB-C Power Bank","variantTitle":null},{"query":"compact travel tripod aluminium under 1.2kg","needId":"tripod","rating":null,"seller":{"url":"https://tripodworld.example","name":"Tripod World","domain":"tripodworld.example"},"currency":"EUR","priority":4,"productId":"gid://shopify/Product/5555555555","variantId":"gid://shopify/ProductVariant/6666666666","priceMinor":9999,"productUrl":"https://tripodworld.example/products/alu-travel-tripod","searchRank":0,"checkoutUrl":"https://tripodworld.example/cart/6666666666:1","productTitle":"Aluminium Travel Tripod 1.1kg","variantTitle":"Black"}],"source":"shopify-global-catalog","country":"NL","complete":true,"currency":"EUR","warnings":["Shipping, taxes, duties and discounts are not included in the budget."],"checkedAt":"2026-08-30T10:00:02.000Z","totalMinor":41297,"budgetMinor":60000,"budgetScope":"items_only","remainingMinor":18703,"unresolvedNeeds":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oQSs8PE1UbTWQURjrwxch","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a list of product needs with pre-formed queries and an overall budget, finds one real Shopify product per need across multiple merchants and returns per-item checkout URLs.","exampleAgentPrompt":"I need to buy three things for a video-creator kit — a wireless lavalier mic compatible with USB-C iPhones, a 20000mAh 65W USB-C power bank that's airline-safe, and a compact aluminium travel tripod under 1.2 kg — and my total item budget is €150. Find me one real Shopify product for each and give me the checkout links, shopping in the Netherlands in EUR.","exampleUseCases":[{"title":"Video creator travel kit sourcing","prompt":"I'm kitting out a travel video setup and need three things: a wireless USB-C lavalier mic, a 20000mAh airline-safe 65W power bank, and an aluminium travel tripod under 1.2 kg. My total budget for all three items is €150. Find me one real product for each from Shopify stores, priority 10 for the mic, 6 for the power bank, 4 for the tripod, and give me checkout links — I'm in the Netherlands buying in EUR."},{"title":"Home office peripherals basket under budget","prompt":"I need to outfit a home office: a mechanical keyboard under €80, a 1080p webcam with autofocus, and an adjustable monitor arm for a 27-inch screen. Total item budget is €200. Source one Shopify product per item across any merchants, priority 8 for the webcam, 7 for the keyboard, 5 for the arm, and return checkout URLs. Shopping in Germany in EUR."},{"title":"Gift basket of hobby supplies for a cyclist","prompt":"I want to buy three gifts for a cyclist: a tubeless tyre repair kit, a cycling computer with GPS under €60, and a lightweight saddle bag. Keep the total item spend under €130. Find me one actual Shopify product for each with checkout links — I'm shopping in the UK, currency GBP, priority 9 for the GPS computer and 5 for the other two."}],"resultDescription":"A JSON object containing an array of matched items — one per need — each with the product title, variant title, price in minor currency units, product URL, direct single-item checkout URL, seller name and domain, search rank, optional rating (count and average), and the need ID it satisfies. The response also includes the total basket price in minor units, the currency, the country, a completeness flag indicating whether all needs were filled, the catalog source, a timestamp, and an array of warnings (e.g. shipping and taxes not included).","failureModes":["No matching Shopify product found for one or more needs — item omitted from results and complete flag set to false","Budget too tight to satisfy all needs at minimum prices — some items excluded","Malformed need query or missing required fields (id, query) — 400 validation error","budgetMinor or maxPriceMinor set to 0 — interpreted as no cap, may return unexpected results","Country or currency code not recognized — 400 or empty results","Rate limit or upstream Shopify catalog unavailability — 5xx error"],"whenToPreferThis":"Use this endpoint when an agent has already resolved buyer intent into concrete, specific product queries (one per need) and wants to find a real purchasable Shopify listing for each, respecting an overall item-price budget. Prefer it over a generic product search when you have multiple simultaneous needs with priorities and need per-item checkout URLs across multiple merchants in a single call. Do not use it for open-ended product discovery, cart creation, or checkout processing — it only returns links, not completed carts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:37:17.767Z","isFirstParty":false}