# Local Business Area Search by Radius

> Local Business Area Search by Radius is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search for businesses matching a keyword within a circular geographic area defined by a center coordinate and radius in meters, sourcing data from Google Maps.

## Facts

- Endpoint: GET https://agents.openwebninja.com/local-business-data/area-search-by-radius?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-local-business-area-search-by-radius-e030f020
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ohko6KZQcXz48bWwqidzj

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 agents-openwebninja-com-local-business-area-search-by-radius-e030f020
```

Example prompt: Find all pizza restaurants within 5000 meters of latitude 37.359428, longitude -121.925337 — return up to 30 results in English.

## When to prefer this

Choose this endpoint when you need to find businesses within a precise circular geographic boundary defined by coordinates, rather than a named location string. It is ideal for geospatial workflows, mapping applications, or when you already have lat/lng from another source and want to search within an exact meter-radius. Prefer this over text-based location search when precision matters and coordinates are already known.

## Known failure modes

- Missing required parameters (query, lat, lng, or radius) return a 400 validation error
- Radius outside the 1–50000 meter range may be rejected
- Unsupported region or language codes may default or return empty results
- No businesses matching the query in the area returns an empty data array
- Network or upstream Google Maps issues may cause 500 errors or timeouts
- Rate limits or payment failures return 402 or 429 responses

## How this service works

Search businesses within a circular area defined by a center coordinate point (lat, lng) and a radius in meters.

## Output

Returns an array of business objects, each containing the business name, address, city, state, country, ZIP code, latitude/longitude, primary category/type, Google rating, review count, phone number, website URL, opening hours, business status, Google business ID, and optionally extracted emails and social contacts. Also includes the request parameters and a status/request ID for tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "lat",
  "lng",
  "radius"
 ],
 "properties": {
  "lat": {
   "type": "string",
   "default": 37.359428,
   "example": "37.359428",
   "description": "Latitude of the center coordinate point of the area to search in."
  },
  "lng": {
   "type": "string",
   "default": -121.925337,
   "example": "-121.925337",
   "description": "Longitude of the center coordinate point of the area to search in."
  },
  "limit": {
   "type": "string",
   "default": 20,
   "description": "Maximum number of businesses to return.  \n\n  **Allowed values:** `1-500`"
  },
  "query": {
   "type": "string",
   "example": "pizza",
   "description": "Search query / keyword"
  },
  "fields": {
   "type": "string",
   "description": "A comma separated list of business fields to include in the response (field projection).  \n  By default all fields are returned."
  },
  "radius": {
   "type": "string",
   "example": "5000",
   "description": "The radius (in meters) of the circular search area around the center coordinate point (lat, lng). Allowed values: 1-50000."
  },
  "region": {
   "type": "string",
   "default": "us",
   "description": "Query Google Maps from a particular region or country.  \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "Set the language of the results.  \n  For a list of supported language codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes*."
  },
  "subtypes": {
   "type": "string",
   "description": "Find businesses with specific subtypes, specified as a comma separated list of types (business categories).  \n  For the complete list of types, see *https://daltonluka.com/blog/google-my-business-categories*.  \n  \n  **Examples:**  \n  `Plumber,Carpenter,Electrician`  \n  `Night club,Dance club,Bar,Pub`  "
  },
  "extract_emails_and_contacts": {
   "type": "boolean",
   "default": false,
   "description": "Extract emails, contacts and social profiles for each business in the response.  \n  In case true, businesses will be enriched with a emails_and_contacts field with emails, phones, Facebook, LinkedIn, Instagram and other social profiles.\n  \n  **Note:** in case `true`, the endpoint will scrape emails and contacts from the business website (in case non-empty).  \n  For each such business, the API will charge an additional credit."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "parameters",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "business_id",
     "google_id",
     "name",
     "business_status"
    ],
    "properties": {
     "cid": {
      "type": "string",
      "nullable": true,
      "description": "Google CID (Customer ID) of the business."
     },
     "tld": {
      "type": "string",
      "nullable": true,
      "description": "Top-level domain of the business website."
     },
     "city": {
      "type": "string",
      "nullable": true,
      "description": "City of the business location."
     },
     "name": {
      "type": "string",
      "description": "Display name of the business."
     },
     "type": {
      "type": "string",
      "nullable": true,
      "description": "Primary business category as labelled by Google Maps."
     },
     "about": {
      "type": "object",
      "nullable": true,
      "properties": {
       "details": {
        "type": "object",
        "nullable": true,
        "description": "Map of attribute groups (e.g. Amenities, Crowd, Service options) to attribute name -> boolean.",
        "additionalProperties": {
         "type": "object",
         "additionalProperties": {
          "type": "boolean"
         }
        }
       },
       "summary": {
        "type": "string",
        "nullable": true,
        "description": "Free-text description of the business."
       }
      },
      "description": "Free-form summary and a structured details map of business attributes."
     },
     "state": {
      "type": "string",
      "nullable": true,
      "description": "State / region of the business location."
     },
     "rating": {
      "type": "number",
      "nullable": true,
      "description": "Average review rating (1-5) on Google Maps."
     },
     "address": {
      "type": "string",
      "nullable": true,
      "description": "Street address line of the business."
     },
     "country": {
      "type": "string",
      "nullable": true,
      "description": "ISO 3166-1 alpha-2 country code of the business location."
     },
     "website": {
      "type": "string",
      "nullable": true,
      "description": "Business website URL."
     },
     "zipcode": {
      "type": "string",
      "nullable": true,
      "description": "ZIP / postal code of the business location."
     },
     "district": {
      "type": "string",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-local-business-area-search-by-radius-e030f020/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
