# Aviato Geocoder Search

> Aviato Geocoder Search is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Search for a location by text and return geocoded matches with IDs usable in person/company search filters

## Facts

- Endpoint: GET https://x402.orthogonal.com/aviato/geocoder/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviato-geocoder-search-d6746787
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r8VZ8u5Z2rvr_a-bhrgjV

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 aviato-geocoder-search-d6746787
```

Example prompt: Search for 'Austin, Texas' using the Aviato geocoder and give me the location ID so I can use it to filter a people search.

## When to prefer this

Use this endpoint when you need to translate a human-readable location name (city, region, metro area) into a structured geocoded ID for use with Aviato's person or company search endpoints. It is the required prerequisite step before filtering professional searches by geography on the Aviato platform.

## Known failure modes

- Empty or ambiguous query text returns no matches or ambiguous results
- Misspelled or unrecognized location names may return zero results
- Rate limiting or payment failure returns an HTTP 402 or 429 error
- Very broad queries like 'United States' may return many low-utility results

## How this service works

Search for a location and get geocoded matches. Use the geocoded ID with person/company search locationIDList filter.

## Output

Returns a list of geocoded location matches for the query text, including location IDs and names. The location ID from the results can then be passed to Aviato person or company search endpoints as a locationIDList filter parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "text": {
       "type": "string",
       "description": "Location search query"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviato-geocoder-search-d6746787/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)