# Ziplore ZIP Radius Search

> Ziplore ZIP Radius Search is a paid API for AI agents from ziplore.cybermaxtools.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-17).

Returns all US ZIP codes within a specified mile radius of a center point, with county, time zone, and Census demographic data for each

## Facts

- Endpoint: GET https://ziplore.cybermaxtools.com/x402/api/radius?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ziplore-zip-radius-search-628a21fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ethplEmr7PV6C5miizwQX

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 ziplore-zip-radius-search-628a21fa
```

Example prompt: Find all ZIP codes within 10 miles of ZIP 90210, limit to 20 results, and only include ones with at least 1000 residents — I need the county, time zone, and Census demographics for each.

## When to prefer this

Choose this endpoint when you need geographic proximity search specifically for US ZIP codes, especially when you also need county assignments, time zone data, and Census demographics in a single call. It is ideal over raw geocoding APIs when the output unit must be ZIP codes rather than raw coordinates, and over simple ZIP lookup APIs when radius-based proximity is required alongside demographic filtering.

## Known failure modes

- Missing required 'miles' parameter returns a 400 validation error
- Neither 'zip' nor 'lat'+'lon' provided causes an invalid center point error
- ZIP code not found in database returns empty results or 404
- Miles value outside 0.1–25 range rejected with validation error
- Limit value outside 1–50 range rejected with validation error
- Non-US ZIP codes are not supported and will return no results

## How this service works

US ZIP codes to county, time zone and demographics. ZIP code facts, radius search and Census demographics in one call Try it free in one click, no sign-up.

## Output

A list of up to 50 US ZIP codes within the specified radius, each with associated county name, state, time zone, distance from center, and Census demographic statistics such as population, household counts, and median income.

## 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",
     "required": [
      "miles"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Center latitude"
      },
      "lon": {
       "type": "number",
       "description": "Center longitude"
      },
      "zip": {
       "type": "string",
       "description": "Center ZIP (or give lat + lon)"
      },
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 50,
       "minimum": 1,
       "description": "Max results (1-50, default 25)"
      },
      "miles": {
       "type": "number",
       "maximum": 25,
       "minimum": 0.1,
       "description": "Radius in miles (0.1-25)"
      },
      "minPopulation": {
       "type": "integer",
       "minimum": 0,
       "description": "Skip ZIPs with fewer residents"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ziplore-zip-radius-search-628a21fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ziplore.cybermaxtools.com](https://www.zero.xyz/host/ziplore.cybermaxtools.com/llms.txt)
