# Neighborhood Intelligence

> Neighborhood Intelligence is a paid API for AI agents from agent-vending-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns a machine-ready demographic, economic, and housing profile for a U.S. geography with Census uncertainty margins and peer benchmarks.

## Facts

- Endpoint: POST https://agent-vending-production.up.railway.app/v1/neighborhood-intelligence?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/neighborhood-intelligence-b4761b85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2ZERpbVPwjGRcwJ7ez9HF

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 neighborhood-intelligence-b4761b85 -d '<json body>'
```

Example prompt: Can you pull the full demographic and housing profile for ZIP code 90210 — I need things like median household income, homeownership rate, poverty rate, and educational attainment, with peer benchmarks?

## When to prefer this

Choose this endpoint when you need a broad, multi-metric demographic and economic snapshot of a single U.S. geography without needing to know Census table or variable IDs. It is ideal for site selection research, real estate analysis, grant writing, market sizing, or any workflow that needs machine-ready Census data with uncertainty margins and peer benchmarks in one call. Prefer the sibling 'US Demographic Intelligence' endpoint if you need highly specific or custom Census variables beyond the 16 supported metrics, or 'Location Compare' when the primary goal is side-by-side comparison of multiple places.

## Known failure modes

- Geography not found — ambiguous name without state context returns an error or wrong match
- Unsupported geography type or GEOID format mismatch causes a 400-level error
- Census data unavailable for very small geographies (e.g. sparsely populated tracts) may return null values for some metrics
- Requesting a metric not in the allowed enum returns a validation error
- Payment failure via x402 protocol prevents the call from completing

## How this service works

Pay-per-call machine utilities for autonomous agents.

## Output

A structured JSON profile containing up to 16 Census-derived metrics (e.g. total population, median household income, poverty rate, homeownership rate, median home value, educational attainment, age demographics) for the requested U.S. geography, each accompanied by Census margin-of-error estimates and peer benchmark comparisons. No Census table or variable IDs are required from the caller.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "metrics": {
   "oneOf": [
    {
     "enum": [
      "DEFAULT_PROFILE"
     ],
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "enum": [
       "total_population",
       "median_age",
       "median_household_income",
       "per_capita_income",
       "poverty_rate",
       "unemployment_rate",
       "labor_force_participation_rate",
       "bachelors_or_higher_pct",
       "high_school_or_higher_pct",
       "homeownership_rate",
       "median_home_value",
       "median_gross_rent",
       "uninsured_rate",
       "foreign_born_pct",
       "under18_pct",
       "65plus_pct"
      ],
      "type": "string"
     }
    }
   ],
   "description": "Default profile (16 metrics) or a subset list"
  },
  "geography": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "name": {
     "type": "string",
     "description": "e.g. \"Ventura County\", \"Thousand Oaks\", \"91362\", \"CA\", tract code"
    },
    "type": {
     "enum": [
      "state",
      "county",
      "place",
      "zcta",
      "tract"
     ],
     "type": "string"
    },
    "geoid": {
     "type": "string",
     "description": "Census GEOID alternative to name (county 5, place 7, tract 11 digits)"
    },
    "state": {
     "type": "string",
     "description": "State name, postal code or FIPS (county/place/tract by name)"
    },
    "county": {
     "type": "string",
     "description": "County name or FIPS (tract only)"
    }
   },
   "description": "A U.S. geography by type plus name or GEOID. No Census table or variable IDs needed.",
   "additionalProperties": true
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "OK",
  "product": "neighborhood_intelligence",
  "profile": [
   {
    "unit": "usd",
    "metric": "median_household_income",
    "estimate": 143683,
    "percentiles": {
     "national": {
      "label": "93rd percentile among U.S. ZCTAs with 5,000+ residents",
      "percentile": 93.33
     }
    },
    "uncertainty": {
     "cv": 0.0417,
     "ci_90": {
      "lower": 133823,
      "upper": 153543
     },
     "moe_90": 9860
    }
   }
  ],
  "summary": {
   "notable_characteristics": [
    {
     "code": "HIGH_RELATIVE_TO_US_PEERS",
     "metric": "median_household_income",
     "percentile": 93.33
    }
   ]
  },
  "geography": {
   "name": "ZCTA5 91362",
   "geoid": "91362",
   "geo_type": "zcta",
   "census_geography": "ZIP Code Tabulation Area (ZCTA5)"
  },
  "provenance": [
   {
    "dataset": "acs/acs5/profile",
    "provider": "census_acs",
    "release_year": 2023
   }
  ],
  "data_vintage": {
   "label": "ACS 5-Year 2019-2023",
   "dataset": "ACS 5-Year",
   "release_year": 2023
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/neighborhood-intelligence-b4761b85/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-vending-production.up.railway.app](https://www.zero.xyz/host/agent-vending-production.up.railway.app/llms.txt)