# Agent Miner Tools – Shopify Product Search

> Agent Miner Tools – Shopify Product Search is a paid API for AI agents from agent-api-production.tim1712.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Searches the Shopify global catalog for real, current product listings matching a structured query, returning normalized price, currency, seller, rating, product URL, and checkout URL in search-rank order.

## Facts

- Endpoint: POST https://agent-api-production.tim1712.workers.dev/v1/shopping/product-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-miner-tools-shopify-product-search-21f9e175
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ujTzbezUZmL5VWfIZZr-C

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-miner-tools-shopify-product-search-21f9e175 -d '<json body>'
```

Example prompt: Search Shopify for up to 5 listings of a '65W USB-C power bank 20000mAh airline safe', priced under €150, in the Netherlands (NL) in EUR — give me the product title, price, seller, rating, and checkout URL for each result.

## When to prefer this

Use this endpoint when the agent already has a specific, well-formed product query and needs real, current Shopify listings with structured pricing, seller, rating, and direct checkout URLs. Prefer this over generic web search when you need machine-readable normalized e-commerce data (priceMinor, variantId, checkoutUrl) in a specific country/currency. Do not use it for open-ended product discovery, intent interpretation, recommendations, or cart/checkout management — it is a structured catalog lookup, not a recommendation engine.

## Known failure modes

- Query string too long (>256 chars) — validation error
- Invalid country code (not 2 uppercase letters) — validation error
- Invalid currency code (not 3 uppercase letters) — validation error
- Limit out of range (not 1–10) — validation error
- No matching Shopify listings found — empty products array with possible warnings
- Shopify catalog temporarily unavailable — upstream error response
- maxPriceMinor too restrictive — empty products array returned
- Payment not completed (x402) — request blocked before reaching search logic

## How this service works

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.

## Output

A JSON object containing the original query, source ('shopify-global-catalog'), country, currency, a checkedAt timestamp, optional maxPriceMinor, optional warnings, and a ranked array of products. Each product includes productTitle, variantTitle, priceMinor, currency, productUrl, checkoutUrl, searchRank, productId, variantId, and a seller object (name, domain, url) plus a rating object (value, count).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 256,
   "minLength": 1
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Z]{2}$"
  },
  "currency": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "maxPriceMinor": {
   "type": "integer",
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "65W USB-C power bank 20000mAh airline safe",
  "source": "shopify-global-catalog",
  "country": "NL",
  "currency": "EUR",
  "products": [
   {
    "rating": {
     "count": 88,
     "value": 4.4
    },
    "seller": {
     "url": "https://poweredup.example",
     "name": "PoweredUp",
     "domain": "poweredup.example"
    },
    "currency": "EUR",
    "productId": "gid://shopify/Product/3333333333",
    "variantId": "gid://shopify/ProductVariant/4444444444",
    "priceMinor": 12999,
    "productUrl": "https://poweredup.example/products/pb-20000-65w",
    "searchRank": 0,
    "checkoutUrl": "https://poweredup.example/cart/4444444444:1",
    "productTitle": "20000mAh 65W USB-C Power Bank",
    "variantTitle": null
   }
  ],
  "warnings": [],
  "checkedAt": "2026-08-30T10:00:02.000Z",
  "maxPriceMinor": 15000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-miner-tools-shopify-product-search-21f9e175/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-api-production.tim1712.workers.dev](https://www.zero.xyz/host/agent-api-production.tim1712.workers.dev/llms.txt)