{"slug":"agent-api-testnet-tim1712-workers-dev-v1-shopping-budget-bas-83ccb6","title":"Use when an agent already knows several products/categories a buyer needs and wa","host":"agent-api-testnet.tim1712.workers.dev","method":"POST","resource":"https://agent-api-testnet.tim1712.workers.dev/v1/shopping/budget-basket","category":"commerce","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 inte","price_listed":0.03,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":4,"reported_payers_30d":1,"networks":["eip155:84532"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"budgetMinor":60000,"country":"NL","currency":"EUR","needs":[{"id":"microphone","maxPriceMinor":20000,"priority":10,"query":"wireless lavalier microphone for iPhone USB-C"},{"id":"power-bank","maxPriceMinor":15000,"priority":6,"query":"65W USB-C power bank 20000mAh airline safe"},{"id":"tripod","priority":4,"query":"compact travel tripod aluminium under 1.2kg"}]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"budgetMinor":{"minimum":0,"type":"integer"},"country":{"pattern":"^[A-Z]{2}$","type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"needs":{"items":{"additionalProperties":false,"properties":{"id":{"pattern":"^[A-Za-z0-9._-]{1,64}$","type":"string"},"maxPriceMinor":{"minimum":0,"type":"integer"},"priority":{"maximum":10,"minimum":1,"type":"integer"},"query":{"maxLength":256,"minLength":1,"type":"string"}},"required":["id","query"],"type":"object"},"type":"array"}},"required":["country","currency","budgetMinor","needs"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"budgetMinor":{"minimum":0,"type":"integer"},"budgetScope":{"const":"items_only","type":"string"},"checkedAt":{"type":"string"},"complete":{"type":"boolean"},"country":{"pattern":"^[A-Z]{2}$","type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"checkoutUrl":{"type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"needId":{"type":"string"},"priceMinor":{"minimum":0,"type":"integer"},"priority":{"maximum":10,"minimum":1,"type":"integer"},"productId":{"type":"string"},"productTitle":{"type":"string"},"productUrl":{"type":"string"},"query":{"type":"string"},"rating":{"anyOf":[{"additionalProperties":false,"properties":{"count":{"minimum":0,"type":"integer"},"value":{"type":"number"}},"required":["value","count"],"type":"object"},{"type":"null"}]},"searchRank":{"minimum":0,"type":"integer"},"seller":{"anyOf":[{"additionalProperties":false,"properties":{"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","domain","url"],"type":"object"},{"type":"null"}]},"variantId":{"type":"string"},"variantTitle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["needId","query","priority","productId","variantId","productTitle","variantTitle","priceMinor","currency","productUrl","checkoutUrl","seller","rating","searchRank"],"type":"object"},"type":"array"},"remainingMinor":{"minimum":0,"type":"integer"},"source":{"const":"shopify-global-catalog","type":"string"},"totalMinor":{"minimum":0,"type":"integer"},"unresolvedNeeds":{"items":{"additionalProperties":false,"properties":{"needId":{"type":"string"},"reason":{"enum":["no_matching_products","budget_exceeded"],"type":"string"}},"required":["needId","reason"],"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["source","country","currency","budgetMinor","totalMinor","remainingMinor","complete","items","unresolvedNeeds","budgetScope","warnings","checkedAt"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"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.","last_updated":"2026-08-30T13:19:18.639Z","schemes":["exact"]}