# Locus Surrounding Area Analysis

> Locus Surrounding Area Analysis is a paid API for AI agents from api.locus.report, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns a comprehensive multi-layer geospatial intelligence bundle for a US address, including parcel topology, zoning, permits, environmental records, capital projects, and transit context within 500–1,000 m radii.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-surrounding-area-analysis
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-surrounding-area-analysis-b39f6d41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0Qjgqb2Y4QbSSrhYkuaOP

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 locus-surrounding-area-analysis-b39f6d41 -d '<json body>'
```

Example prompt: Pull a full surrounding area analysis for 742 Evergreen Terrace, Springfield, IL — I want zoning, permits, environmental records, and capital projects within 1000 meters.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-dimensional surrounding area profile for a single US address in one call — covering zoning, permits, environmental hazards, capital projects, and transit together. Prefer it over individual sibling endpoints (EPA-only, flood-only, etc.) when you want a broad contextual picture rather than a single data layer. Ideal for property due diligence, site selection research, or agent-driven real estate analysis workflows where breadth matters more than depth on any single dimension.

## Known failure modes

- Address not found or too ambiguous — returns empty or sparse records array
- Radius value outside 500–1000 m bounds — validation error
- Address string too short (under 5 characters) or too long (over 160 characters) — schema validation failure
- Data not yet available for a given address or region — thin/empty result returned without error
- Payment not completed via x402 protocol — 402 response before data is returned
- Timeout on heavy environmental data pulls — may require retry

## How this service works

Canonical packet for one US address: source-qualified parcel topology and proximity, zoning, development, permits, legislation, capital/transport, and environmental records in nested 100-1,000 m windows. Stored 90 days with an optional HTML/PDF upgrade. Awareness only: no score, valuation, consumer report, or tenant, employment, lending, insurance, or protected-class screening recommendation. Thin results are free. Install agent skill: npx @velinussage/locus-agent-skill add.

## Output

A JSON artifact with a unique ID, a generatedAt timestamp, caveats, and a records array containing nested multi-layer geospatial context including parcel topology, zoning classifications, development and building permits, environmental records (EPA/Superfund proximity), capital improvement projects, and transport/legislative records — all organized within 100–1,000 m proximity windows. Results are stored for 90 days and can optionally be upgraded to HTML/PDF. Thin results are returned free.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 160,
   "minLength": 5
  },
  "question": {
   "type": "string",
   "maxLength": 400,
   "minLength": 1
  },
  "radiusMeters": {
   "type": "integer",
   "default": 500,
   "maximum": 1000,
   "minimum": 500
  },
  "includeAerial": {
   "type": "boolean",
   "default": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-surrounding-area-analysis-b39f6d41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.locus.report](https://www.zero.xyz/host/api.locus.report/llms.txt)