agentutility(7)$ man product-search
/product-search
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
retailCATEGORY
uncategorized
STATUS
● live
NAME
product-search — searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer do…
SYNOPSIS
POST https://x402.agentutility.ai/product-search
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer domain, snippet, and any detected price. Backed by Decodo Google search scoped to buy intent. For general web search use search/web-search. Use it as a product search or shopping search API to find products and buy links for agents.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| query | string | Product to find, e.g. 'noise cancelling headphones under 200'. Max 300 chars. | required |
| num_results | number | Results to return, 1-20. Default 10. | optional |
| retailer | string | Optional retailer/domain to scope to, e.g. 'amazon.com'. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| query | string | — |
| results | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/product-search \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the product-search tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- retailproductsearchproduct-search
- methods
- POST
- cluster
- retail
- price
- $0.02 USDC per call
ADJACENT — other endpoints in retail
| endpoint | description | price |
|---|---|---|
| find-products | Find products API (alias of product-search). | $0.02 |
| shop-search | Shopping search API (alias of product-search). | $0.02 |
| product-describe | Writes conversion-focused product descriptions and listing copy from a product name and optional category, audience, and attributes. | $0.01 |
| product-description | Product description API (alias of product-describe). | $0.01 |
SEE ALSO