# Area Search (Bounding Box) — Local Business Search

> Area Search (Bounding Box) — Local Business Search 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 rectangular geographic area defined by south-west and north-east corner coordinates.

## Facts

- Endpoint: GET https://agents.openwebninja.com/local-business-data/area-search-by-bounding-box?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-area-search-bounding-box-local-business-search-4f943658
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__taAmTUI5b_yMjjOp_2Dr

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-area-search-bounding-box-local-business-search-4f943658
```

Example prompt: Find up to 50 pizza restaurants within the Manhattan bounding box — bottom-left at 40.606540,-74.013580 and top-right at 40.812151,-73.910522 — and include their ratings, addresses, and websites.

## When to prefer this

Use this endpoint when you need to search businesses within a specific rectangular map area (e.g. drawn on a map, defined by known corner coordinates). It is ideal for geofenced business discovery, competitive landscape mapping, lead generation within a territory, or powering map-based UIs. Prefer this over point-radius search when your area of interest is naturally rectangular or when you have exact bounding box coordinates. Choose over a text-based location search when precision matters and you already have coordinate boundaries.

## Known failure modes

- Missing required parameters (query, bottom_left, top_right) returns 400 validation error
- Invalid coordinate format (not 'lat,lng') returns parsing error
- Bounding box too large may return incomplete or truncated results
- Region/language codes not matching ISO 639-1 may default or fail
- extract_emails_and_contacts=true significantly increases latency and may time out for large result sets
- No businesses found in the area returns an empty data array
- Rate limit exceeded returns 429 or payment-required error

## How this service works

Search businesses within a rectangular area defined by its bottom-left (south-west) and top-right (north-east) corner coordinates.

## Output

Returns an array of business objects, each containing: business ID, Google Maps ID, name, primary category, address (street, city, state, zip, country), latitude/longitude, rating, review count, phone number, website URL, operating hours, business status, subtypes, owner information, and optionally emails and social media contacts. Also includes request metadata and status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "bottom_left",
  "top_right"
 ],
 "properties": {
  "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."
  },
  "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`  "
  },
  "top_right": {
   "type": "string",
   "example": "40.812151,-73.910522",
   "description": "The top-right (north-east) corner of the bounding box to search in, as a \"lat,lng\" string."
  },
  "bottom_left": {
   "type": "string",
   "example": "40.606540,-74.013580",
   "description": "The bottom-left (south-west) corner of the bounding box to search in, as a \"lat,lng\" string."
  },
  "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-area-search-bounding-box-local-business-search-4f943658/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)
