# WebLens Places Search API

> WebLens Places Search API is a paid API for AI agents from api.weblens.dev, paid per call via x402, $0.045/call, status unknown (last checked 2026-10-02, last successful call 2026-08-31).

Search for local places and businesses by query and location, returning enriched results including ratings, reviews, phone, address, website, and coordinates

## Facts

- Endpoint: POST https://api.weblens.dev/search/places?utm_source=zero.xyz
- Price: $0.045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Last successful call: 2026-08-31
- Success rate: 100% of calls made through Zero
- Rating: 4.0 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/weblens-places-search-api-36d8e768
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g3Kqp6zfWPnllOY-BGQaV

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-places-search-api-36d8e768 -d '<json body>'
```

Example prompt: Find me the top-rated coffee shops in Austin, Texas — I need their names, phone numbers, addresses, ratings, and websites.

## When to prefer this

Choose this endpoint when you need structured local business data including contact info, ratings, and coordinates for a specific query and city or region. It is ideal for local search, lead generation, competitor mapping, travel planning, or any use case requiring enriched place data beyond what a general web search provides. The x402 micropayment model makes it cost-effective at $0.045 per call, with a 70% discount on cached results for repeated queries.

## Known failure modes

- Invalid or ambiguous location string returns empty results or a location resolution error
- Query too vague returns low-relevance or zero results
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Malformed request body returns 400 validation error
- Temporarily unavailable search data source returns 503 or cached fallback
- Very niche or rare business types in small cities may return sparse results

## 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 object containing the original query, location, a request ID, timestamp, and an array of place results. Each result includes the business name, phone number, star rating, street address, review count, website URL, search result position, and latitude/longitude coordinates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "maximum": 20,
   "description": "Max results (default 10, max 20)"
  },
  "query": {
   "type": "string",
   "description": "What to search for"
  },
  "location": {
   "type": "string",
   "description": "Free-text location bias, e.g. \"Austin, Texas\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "coffee shops",
  "results": [
   {
    "name": "Example Coffee",
    "phone": "(512) 555-0100",
    "rating": 4.7,
    "address": "123 Main St, Austin, TX",
    "reviews": 812,
    "website": "https://examplecoffee.com",
    "position": 1,
    "coordinates": {
     "latitude": 30.26,
     "longitude": -97.74
    }
   }
  ],
  "location": "Austin, Texas",
  "requestId": "req_places123",
  "searchedAt": "2026-07-25T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/weblens-places-search-api-36d8e768/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)