{"uid":"cap_PMK1SeaQp3RgbTmmpN9Wd","slug":"agentshare-product-search-api-dc751bf4","name":"AgentShare Product Search API","description":"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.","url":"https://agentshare.dev/api/v1/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}]}}}}},"responseSchema":{"type":"json","example":{"status":"ok","products":[{"name":"example","price":10,"currency":"USD"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5FuZf3tBldD3sQAS9hZ9L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for products by keyword and retrieve matching product names and prices in a specified currency","exampleAgentPrompt":"Can you search AgentShare for 'Raspberry Pi' and show me up to 10 matching products with their prices in USD?","exampleUseCases":[{"title":"Consumer electronics price lookup","prompt":"Search for 'MacBook Air' and return up to 20 results with prices in USD so I can compare what's available."},{"title":"Brand product discovery","prompt":"Find all products matching 'Sony' on AgentShare, give me the top 50 results with prices shown in VND."},{"title":"Category browsing for shopping","prompt":"Look up 'mechanical keyboard' products for me — I want to see up to 30 results with prices in USD."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:30:29.599Z","isFirstParty":false,"canonicalSlug":"agentshare-product-search-api-dc751bf4"}