# Ziplore ZIP Radius Search

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

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

## Facts

- Endpoint: GET https://ziplore.cybermax-tools.workers.dev/x402/api/radius?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ziplore-zip-radius-search-6d7626ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iJVFpzx5ihrylLIGBAUeJ

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-6d7626ec
```

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

## When to prefer this

Use this endpoint when you need to discover all US ZIP codes within a geographic radius and want county, time zone, and Census demographics bundled in a single call. It is ideal for proximity-based marketing, delivery zone planning, franchise territory mapping, or any location intelligence workflow that starts from a ZIP code or lat/lon center. Prefer this over a basic ZIP lookup when radius search and demographic filtering by population are both needed simultaneously.

## Known failure modes

- Missing required 'miles' parameter returns validation error
- Neither 'zip' nor 'lat'+'lon' provided causes bad request
- Miles value outside 0.1–25 range rejected with schema error
- Limit value outside 1–50 range rejected
- Invalid ZIP code format returns empty results or error
- Center point in a non-US location may return no results
- minPopulation set too high may return empty result set

## 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 ZIP codes within the specified radius, each enriched with county name, time zone, Census demographic data (including population), and distance from the center point. Results are capped at the requested limit (default 25, max 50) and optionally filtered by minimum population.

## 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-6d7626ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ziplore.cybermax-tools.workers.dev](https://www.zero.xyz/host/ziplore.cybermax-tools.workers.dev/llms.txt)