# AgentShare Product Search API

> AgentShare Product Search API is a paid API for AI agents from agentshare.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Search for products by keyword and retrieve matching product names and prices in a specified currency

## Facts

- Endpoint: GET https://agentshare.dev/api/v1/search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshare-product-search-api-dc751bf4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PMK1SeaQp3RgbTmmpN9Wd

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 agentshare-product-search-api-dc751bf4
```

Example prompt: Can you search AgentShare for 'Raspberry Pi' and show me up to 10 matching products with their prices in USD?

## When to prefer this

Choose this endpoint when you need a quick, low-cost ($0.001 USDC) keyword-based product search that returns names and prices. It supports both VND and USD currency output, making it suitable for Vietnamese market pricing or USD comparisons. Prefer this when you need structured product data without complex filtering requirements.

## Known failure modes

- Missing required 'q' parameter returns a 400 error
- Query too short (minLength 1 not met) returns validation error
- Requested limit exceeds 100 returns validation error
- Payment not provided or insufficient balance returns 402 Payment Required
- Unknown currency code may fall back to default (VND) or return an error
- Service unavailable returns 5xx error

## How this service works

AgentShare — agent-paid API access for autonomous agents. Dual-auth (API key or x402 USDC), machine-readable discovery, MCP. Commerce and Solana/Meteora DeFi tools are secondary modules.

## Output

Returns a JSON object with a status field ('ok') and a products array, where each product contains a name, numeric price, and currency string. The list is limited to the requested number of results (default 20, max 100).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "examples": [
        "raspberry pi"
       ],
       "minLength": 1,
       "description": "Search keyword (product name, brand, category)."
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 100,
       "minimum": 1,
       "description": "Max results to return."
      },
      "query": {
       "type": "string",
       "minLength": 1,
       "description": "Alias for q (agent clients)."
      },
      "currency": {
       "type": "string",
       "default": "VND",
       "description": "Output currency (VND, USD)."
      }
     },
     "additionalProperties": true
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "status": "ok",
     "products": [
      {
       "name": "example",
       "price": 10,
       "currency": "USD"
      }
     ]
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ok",
  "products": [
   {
    "name": "example",
    "price": 10,
    "currency": "USD"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshare-product-search-api-dc751bf4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshare.dev](https://www.zero.xyz/host/agentshare.dev/llms.txt)