# Search Nearby – Local Business Search by Coordinates

> Search Nearby – Local Business Search by Coordinates 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).

Searches for businesses matching a keyword query near specific geographic coordinates, returning rich business listings from Google Maps.

## Facts

- Endpoint: GET https://agents.openwebninja.com/local-business-data/search-nearby?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-search-nearby-local-business-search-by-f5e70489
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fbxbNqdVH2nunYEIJqX1B

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-search-nearby-local-business-search-by-f5e70489
```

Example prompt: Find me up to 20 plumbers near coordinates 37.359428, -121.925337 in the US — I need their names, addresses, ratings, and websites.

## When to prefer this

Use this endpoint when you need to find businesses near a specific geographic point (lat/lng) by keyword or category, especially when you want rich Google Maps data including ratings, addresses, hours, and optionally contact details. Prefer this over area/radius search when you want a simple proximity search around a pin-drop coordinate rather than a bounded geographic area.

## Known failure modes

- Missing required parameters (query, lat, or lng) returns a 400 validation error
- Invalid or out-of-range coordinates may return empty results or an error
- Exceeding the limit range (1-500) may cause a validation error
- Rate limiting or quota exhaustion returns a 402 or 429 error
- Unsupported region or language codes may result in fallback behavior or errors
- extract_emails_and_contacts=true may significantly increase latency due to website scraping

## How this service works

Search businesses near by specific geographic coordinates.  
  To see it in action, right click on a specific point in the map on Google Maps and select "Search nearby", enter a query and search.

## Output

Returns an array of business listings, each including business ID, name, address, city, state, country, ZIP code, latitude/longitude, primary category, rating, review count, website URL, phone number, business status, opening hours, photos, and optionally extracted emails and social media contacts. Also includes request metadata and status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "lat",
  "lng"
 ],
 "properties": {
  "lat": {
   "type": "string",
   "default": 37.359428,
   "example": "37.359428",
   "description": "Latitude of the geographic coordinates to search near by."
  },
  "lng": {
   "type": "string",
   "default": -121.925337,
   "example": "-121.925337",
   "description": "Longitude of the geographic coordinates to search near by."
  },
  "limit": {
   "type": "string",
   "default": 20,
   "description": "Maximum number of businesses to return.  \n\n  **Allowed values:** `1-500`"
  },
  "query": {
   "type": "string",
   "example": "plumbers",
   "description": "Search query / keyword  \n\n  **Examples:**  \n  `Bars and pubs`  \n  `Plumbers`"
  },
  "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. 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-search-nearby-local-business-search-by-f5e70489/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)