Use when an agent already knows the product it wants and needs real current Shop
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.
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/product-search
| Category | Commerce and shopping |
|---|---|
| Provider host | agent-api-production.tim1712.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 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": {
"country": "NL",
"currency": "EUR",
"limit": 5,
"maxPriceMinor": 15000,
"query": "65W USB-C power bank 20000mAh airline safe"
},
"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": {
"country": {
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"currency": {
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"limit": {
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"maxPriceMinor": {
"minimum": 0,
"type": "integer"
},
"query": {
"maxLength": 256,
"minLength": 1,
"type": "string"
}
},
"required": [
"country",
"currency",
"query"
],
"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": {
"checkedAt": {
"type": "string"
},
"country": {
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"currency": {
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"maxPriceMinor": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"products": {
"items": {
"additionalProperties": false,
"properties": {
"checkoutUrl": {
"type": "string"
},
"currency": {
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"priceMinor": {
"minimum": 0,
"type": "integer"
},
"productId": {
"type": "string"
},
"productTitle": {
"type": "string"
},
"productUrl": {
"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": [
"productId",
"variantId",
"productTit