# Local Business Data Autocomplete

> Local Business Data Autocomplete 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).

Returns place, address, business, and query predictions for partial text-based geographic search queries, biased by region and coordinates.

## Facts

- Endpoint: GET https://agents.openwebninja.com/local-business-data/autocomplete?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-data-autocomplete-9f9060b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qV-EF8ydLmYw2LcsIrn-x

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-data-autocomplete-9f9060b5
```

Example prompt: Can you suggest autocomplete predictions for the partial query 'new y' biased toward the US region with coordinates 40.7128,-74.0060, so I can show place and business suggestions as the user types?

## When to prefer this

Choose this endpoint when you need real-time place, address, or business autocomplete suggestions as a user types — especially when you want Google Maps-quality predictions with place IDs and coordinates, and you need results biased to a specific region or geographic coordinate. Prefer over generic geocoders when you need incremental suggestions with highlight metadata for UI rendering, or when you want both place predictions and open-ended query suggestions in the same response.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Empty or very short query may return zero predictions
- Invalid region or language code may fall back to defaults or return an error
- Coordinates in wrong format (not 'lat,lng') may cause a parsing error or be ignored
- Service unavailability or upstream Google Maps API issues return a non-200 status

## How this service works

Returns place/address, business and query predictions for text-based geographic queries.

## Output

Returns an array of prediction objects, each with a type ('place' or 'query'), a full description string, main_text and secondary_text for display, optional latitude/longitude, country code, Google Maps place_id and google_id, and highlight offset/length spans for both main and secondary text to render user-typed characters as bold. Also includes status, request_id, and echoed parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "example": "new y",
   "description": "Search query"
  },
  "region": {
   "type": "string",
   "default": "us",
   "description": "Return results based to a particular region.  \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/ISO_3166-1_alpha-2*."
  },
  "coordinates": {
   "type": "string",
   "description": "Geographic coordinates of the location from which the query is applied - recommended to use so that results are biased towards this location.  \n  Defaults to some central location in the region (see the region parameter)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "parameters",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "type",
     "description",
     "main_text"
    ],
    "properties": {
     "type": {
      "type": "string",
      "description": "Type of prediction. Values: place, query."
     },
     "country": {
      "type": "string",
      "nullable": true,
      "description": "ISO 3166-1 alpha-2 country code of the predicted place; null for query predictions."
     },
     "latitude": {
      "type": "number",
      "nullable": true,
      "description": "Latitude of the predicted place; null for query predictions."
     },
     "place_id": {
      "type": "string",
      "nullable": true,
      "description": "Google Maps Place ID when the prediction is a place; null for query predictions."
     },
     "google_id": {
      "type": "string",
      "nullable": true,
      "description": "Google identifier when the prediction is a place; null for query predictions."
     },
     "longitude": {
      "type": "number",
      "nullable": true,
      "description": "Longitude of the predicted place; null for query predictions."
     },
     "main_text": {
      "type": "string",
      "description": "Primary (left-hand) portion of the prediction text."
     },
     "description": {
      "type": "string",
      "description": "Full prediction text suitable for display in the suggestion list."
     },
     "secondary_text": {
      "type": "string",
      "nullable": true,
      "description": "Secondary (right-hand) portion of the prediction text (e.g. city / region)."
     },
     "main_text_highlights": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "length": {
         "type": "integer",
         "description": "Length of the highlighted span in characters."
        },
        "offset": {
         "type": "integer",
         "description": "0-based character offset of the highlighted span."
        }
       }
      },
      "nullable": true,
      "description": "Substring highlights inside main_text (each {offset, length})."
     },
     "secondary_text_highlights": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "length": {
         "type": "integer",
         "description": "Length of the highlighted span in characters."
        },
        "offset": {
         "typ
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-local-business-data-autocomplete-9f9060b5/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)
