# Local Business Search (Google Maps via DataForSEO)

> Local Business Search (Google Maps via DataForSEO) is a paid API for AI agents from agent.chiemgaufilms.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-30).

Returns up to 20 Google Maps business listings for a keyword query, including name, category, address, phone, website, rating, and coordinates.

## Facts

- Endpoint: POST https://agent.chiemgaufilms.com/api/v1/local-business?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/local-business-search-google-maps-via-dataforseo-8f58ac1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j49Ssu33UEeCE7z11Q6kp

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 local-business-search-google-maps-via-dataforseo-8f58ac1a -d '<json body>'
```

Example prompt: Can you find me up to 20 coffee shops in Germany — I need their names, addresses, phone numbers, ratings, and websites from Google Maps?

## When to prefer this

Choose this endpoint when you need structured Google Maps business data (name, phone, address, rating, coordinates) for a keyword in a specific country. It is ideal for local business discovery, directory building, competitor research, or lead generation tasks that require rich contact and location metadata. Prefer it over generic web search endpoints when you specifically need Maps-sourced data with coordinates and review counts.

## Known failure modes

- Unsupported country/language pair returns an error before payment is charged
- Keyword exceeding 80 characters is rejected by schema validation
- No results found for niche queries in sparse regions returns an empty businesses array
- Invalid location_code returns an error
- Invalid language_code format returns a validation error
- Network or DataForSEO upstream timeout may return a 5xx error

## How this service works

Up to 20 Google Maps businesses for a query such as "plumber" or "coffee shop": name, category, address, phone, website, rating and coordinates (DataForSEO SERP Google Maps Live).

## Output

A JSON object containing the original keyword, language code, and location code, plus an array of up to 20 business objects each with: business name, category, address, city, postal code, phone number, website URL, star rating, review count, latitude, longitude, Google Maps place ID, position in results, and whether the listing is claimed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keyword": {
   "type": "string",
   "maxLength": 80,
   "minLength": 1
  },
  "language_code": {
   "type": "string"
  },
  "location_code": {
   "type": "integer",
   "default": 2840,
   "maximum": 99999999,
   "minimum": 1000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "keyword": "coffee shop",
  "businesses": [
   {
    "city": "Springfield",
    "name": "Example Coffee",
    "phone": "+15555550100",
    "rating": 4.6,
    "address": "1 Main Street, Springfield",
    "website": "https://www.example.com/",
    "category": "Coffee shop",
    "latitude": 40.7128,
    "place_id": "ChIJexample",
    "position": 1,
    "longitude": -74.006,
    "is_claimed": true,
    "postal_code": "12345",
    "reviews_count": 812
   }
  ],
  "language_code": "en",
  "location_code": 2840
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/local-business-search-google-maps-via-dataforseo-8f58ac1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.chiemgaufilms.com](https://www.zero.xyz/host/agent.chiemgaufilms.com/llms.txt)