Search by purchase intent

buy-link-search is an exact-name route for agents that need a product URL. It uses the same bounded shopping search as product-search and returns the title, retailer, buy link, snippet, and any detected price for each result.

Send a product query and an optional retailer filter: 

{
  "query": "USB-C travel charger",
  "num_results": 10,
  "retailer": "example.com"
}

The call costs $0.02 USDC through x402 exact payment on Base. num_results accepts 1 through 20. The query is limited to 300 characters, and the route performs read-only shopping search.

Use the returned buy_url as a candidate link. The listing may change after the search, so check the retailer's current price and availability before a purchase flow asks for approval.