Use when an agent already knows several products/categories a buyer needs and wa
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.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agent-api-production.tim1712.workers.dev/v1/shopping/budget-basket
| Category | Commerce and shopping |
|---|---|
| Provider host | agent-api-production.tim1712.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"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"
}
Promised output schema (from the provider)
{
"$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"
},