# meld402 Local Places Search

> meld402 Local Places Search is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-14).

Search for nearby places (restaurants, cafes, businesses) by query and location, returning aggregated results with ratings, addresses, and reviews via SerpApi

## Facts

- Endpoint: POST https://meld402.vercel.app/api/web/local
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-local-places-search-a9f97b08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QB5CB1AgJMRYV3A31uegb

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 meld402-local-places-search-a9f97b08 -d '<json body>'
```

Example prompt: Find coffee shops within 2 kilometers of 37.7749,-122.4194 in San Francisco — I want to see ratings and addresses for the top results.

## When to prefer this

Choose this endpoint when you need structured local business search results with ratings and reviews aggregated from Google Maps via a single paid API call with a stable schema. Prefer it over direct Google Maps or Places APIs when you want a normalized, agent-friendly response with built-in USDC micropayment via x402 on Base, avoiding API key management. Ideal for agents that need to discover local POIs programmatically with location bias and type filtering.

## Known failure modes

- Missing or invalid query parameter returns validation error
- Coordinates outside supported geographic regions may return empty results
- Radius outside 100–50000 meter bounds returns validation error
- SerpApi backend unavailability causes degraded or empty response
- Query too vague or too long (over 500 chars) may return irrelevant results
- No places matching the query/radius combination returns empty places array

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

Returns a JSON object containing a list of matching places, each with name, type, address, latitude, longitude, rating, review count, place ID, position ranking, and the source engine used. Also includes metadata with timestamp, data sources (SerpApi), and attribution information, plus total result count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ll": {
   "type": "string",
   "description": "Latitude,longitude for location bias (e.g., '37.7749,-122.4194')"
  },
  "type": {
   "type": "string",
   "description": "Place type filter (e.g., 'restaurant', 'cafe', 'gas_station')"
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Local search query (e.g., 'coffee shops near me')"
  },
  "radius": {
   "type": "integer",
   "default": 50000,
   "maximum": 50000,
   "minimum": 100,
   "description": "Search radius in meters"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": "coffee shops near San Francisco",
   "places": [
    {
     "name": "Blue Bottle Coffee",
     "type": "cafe",
     "engine": "google_maps",
     "rating": 4.5,
     "address": "66 Mint St, San Francisco, CA 94103",
     "reviews": 1200,
     "latitude": 37.789,
     "place_id": "ChIJ...",
     "position": 1,
     "longitude": -122.401
    },
    {
     "name": "Ritual Coffee Roasters",
     "type": "cafe",
     "engine": "google_maps",
     "rating": 4.4,
     "address": "1026 Market St, San Francisco, CA 94102",
     "reviews": 980,
     "latitude": 37.778,
     "place_id": "ChIJ...",
     "position": 2,
     "longitude": -122.412
    }
   ],
   "total_results": 245
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "serpapi"
   ],
   "degraded": [],
   "attribution": [
    "Search data by SerpApi (serpapi.com)"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-local-places-search-a9f97b08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meld402.vercel.app](https://www.zero.xyz/host/meld402.vercel.app/llms.txt)