# OpenVerbs Local Place Search

> OpenVerbs Local Place Search is a paid API for AI agents from search.openverbs.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns live Google local-finder (map places) results for a search query, localised by location and language, including ranked place names, addresses, websites, phone numbers, ratings, and review counts.

## Facts

- Endpoint: POST https://search.openverbs.com/v1/local
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-local-place-search-75c7a38a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W5ilm4x8S4xKQylmi0_xi

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 openverbs-local-place-search-75c7a38a -d '<json body>'
```

Example prompt: Find me the top 10 Italian restaurants in London, England, United Kingdom — I need their names, addresses, phone numbers, and ratings.

## When to prefer this

Choose this endpoint when you need live, ranked local business/place data with rich details (phone, rating, address, website) for a specific geographic area and language. Ideal over static business databases when freshness and Google's ranking signal matter. Prefer over generic web search when structured place data fields (phone, rating, review count) are required rather than plain text snippets.

## Known failure modes

- No results found for the query and location combination
- Invalid or unsupported language code causes fallback to default
- Location string not recognized by the underlying search engine, returning unintended results
- Query string too long (over 700 characters) triggers validation error
- Payment not processed (x402 protocol failure) resulting in 402 response
- Rate limiting or quota exhaustion on the underlying Google data source

## How this service works

Live Google local-finder (map places) results for a query, localised by location and language. Returns ranked places with title, address, website domain, phone, rating and review count.

## Output

A ranked list of local places matching the query, each containing: place title, address, website domain, phone number, star rating, and review count — all sourced from live Google local-finder results and ordered by relevance/ranking.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "minLength": 1,
       "maxLength": 700,
       "description": "Search query."
      },
      "location": {
       "type": "string",
       "minLength": 2,
       "maxLength": 120,
       "description": "Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Language code (2-letter). Defaults to en."
      },
      "limit": {
       "type": "integer",
       "minimum": 1,
       "maximum": 100,
       "description": "Depth / maximum results. Defaults to 10."
      }
     },
     "required": [
      "q"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 20,
  "results": [
   {
    "cid": "12345678901234567890",
    "url": "https://bluebottlecoffee.com",
    "rank": 1,
    "phone": "+1 510-653-3394",
    "title": "Blue Bottle Coffee",
    "domain": "bluebottlecoffee.com",
    "rating": 4.5,
    "reviews": 1287,
    "description": "Coffee shop"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-local-place-search-75c7a38a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from search.openverbs.com](https://www.zero.xyz/host/search.openverbs.com/llms.txt)