# WebLens Shopping Search API

> WebLens Shopping Search API is a paid API for AI agents from api.weblens.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-01).

Searches across online shopping sources and returns ranked product listings with prices, ratings, and review counts for a given query

## Facts

- Endpoint: POST https://api.weblens.dev/search/shopping?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/weblens-shopping-search-api-e37efe64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z9HptbRss_wv1ppjdezCr

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 weblens-shopping-search-api-e37efe64 -d '<json body>'
```

Example prompt: Search for 'mechanical keyboard RGB' across shopping sites and give me the top results with prices, ratings, and where to buy them.

## When to prefer this

Use this endpoint when you need structured, ranked product listings with prices and ratings from across multiple shopping sources in a single call. It is ideal over raw web scraping when you want clean, normalized product data (price as both string and number, rating, review count) without parsing HTML. Prefer this over general web search endpoints when the user's intent is specifically to compare or find products to purchase.

## Known failure modes

- Query string missing or empty — returns 400 error
- Upstream shopping site unavailable — may return partial or stale results
- No products found for obscure query — returns empty results array
- Payment not authorized via x402 — returns 402 Payment Required
- Rate limit exceeded — returns 429 Too Many Requests

## How this service works

# WebLens - Web Intelligence API, pay per call

Scrape, crawl, map and extract the web. No account, no API key, no monthly
minimum — you pay for the calls you make and nothing else.

## Pricing
Page fetching starts at **$0.002**, whole-site crawling at
**$0.0015/page**, and sitemap discovery at **$0.004**.
Comparable services bill $0.007-0.008 per request, or reach a lower per-page
rate only on a $99/month commitment. WebLens has no commitment to reach.

## Payment Protocol
All paid endpoints use the [x402 protocol](https://x402.org) for HTTP-native
micropayments (USDC on Base).

## Cache Discount
Cached responses are **70% cheaper** than fresh fetches.

## Output

Returns a JSON array of ranked product results, each including the product title, URL, display price string, extracted numeric price, seller/source name, rating score, review count, and result position, along with a request ID and timestamp for the search.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "maximum": 20,
   "description": "Max results (default 10, max 20)"
  },
  "query": {
   "type": "string",
   "description": "Search query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "mechanical keyboard",
  "results": [
   {
    "url": "https://shop.example.com/kb",
    "price": "$89.99",
    "title": "Mechanical Keyboard RGB",
    "rating": 4.5,
    "source": "Example Store",
    "reviews": 1200,
    "position": 1,
    "extractedPrice": 89.99
   }
  ],
  "requestId": "req_shop123",
  "searchedAt": "2026-07-25T12:00:00.000Z"
 }
}
```

## More

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