Use when an agent already knows the product it wants and needs real current Shopify listin
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.
10000 (raw units)
price
1
calls / 30d
1
unique payers
2026-08-30
updated
Provider
agent-api-testnet.tim1712.workers.dev · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:84532",
"payTo": "0x5229384BD502D85aa7EcA0A31B515E5E48d3910F",
"asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
"amount": "10000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"country": "NL",
"currency": "EUR",
"limit": 5,
"maxPriceMinor": 15000,
"query": "65W USB-C power bank 20000mAh airline safe"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"checkedAt": "2026-08-30T10:00:02.000Z",
"country": "NL",
"currency": "EUR",
"maxPriceMinor": 15000,
"products": [
{
"checkoutUrl": "https://poweredup.example/cart/4444444444:1",
"currency": "EUR",
"priceMinor": 12999,
"productId": "gid://shopify/Product/3333333333",
"productTitle": "20000mAh 65W USB-C Power Bank",
"productUrl": "https://poweredup.example/products/pb-20000-65w",
"rating": {
"count": 88,
"value": 4.4
},
"searchRank": 0,
"seller": {
"domain": "poweredup.example",
"name": "PoweredUp",
"url": "https://poweredup.example"
},
"variantId": "gid://shopify/ProductVariant/4444444444",
"variantTitle": null
}
],
"query": "65W USB-C power bank 20000mAh airline safe",
"source": "shopify-global-catalog",
"warnings": []
},
"type": "json"
}
},
"schema": {
"$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",
"productTitle",
"variantTitle",
"priceMinor",
"currency",
"productUrl",
"checkoutUrl",
"seller",
"rating",
"searchRank"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"source": {
"const": "shopify-global-catalog",
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"source",
"country",
"currency",
"query",
"maxPriceMinor",
"products",
"warnings",
"checkedAt"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://agent-api-testnet.tim1712.workers.dev/v1/shopping/product-search" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://agent-api-testnet.tim1712.workers.dev/v1/shopping/product-search");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://agent-api-testnet.tim1712.workers.dev/v1/shopping/product-search")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/8363.json, and this resource appears in /discovery/resources and /discovery/search.