# Citiview Demographics API

> Citiview Demographics API is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns US neighborhood-to-national demographic statistics (population, income, housing, education, poverty, unemployment) for any address or place across multiple geographic levels in a single call.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/demographics/area?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-demographics-api-aaa980c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QEpfNoSoe3Bcsa0jFHxkC

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 citiview-demographics-api-aaa980c9
```

Example prompt: What are the demographics at 450 Fifth Avenue, New York, NY — give me population, median household income, homeownership rate, poverty rate, and college degree share at the census tract and city level.

## When to prefer this

Choose this endpoint when you need multi-level US demographic context (tract through national) in a single API call for any address, coordinates, or place name. It is ideal for real estate research, site selection, market analysis, grant writing, or socioeconomic reporting where income, housing, education, and labor market indicators are needed together rather than piecemeal.

## Known failure modes

- Address not found or unresolvable — returns error or empty result
- Coordinates outside the US — endpoint only covers US geographies
- Invalid geographic level parameter — returns error or falls back to default
- Census tract not available for very rural or unpopulated areas
- Rate limiting or payment failure via x402 micropayment protocol

## How this service works

Demographics for any US address or place at neighborhood (census tract), city, county, state and national level in one call: population, median age, households, median household and per-capita income…

## Output

A JSON object containing demographic metrics at one or more geographic levels (census tract, city, county, state, national): population, median age, number of households, median household income, per-capita income, median home value, median rent, homeownership rate, share with college degree, poverty rate, and unemployment rate — all in a single response.

## 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": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "level": {
       "type": "string",
       "description": "tract, city, county, state or united_states (default all)"
      },
      "address": {
       "type": "string",
       "description": "US street address or place"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-demographics-api-aaa980c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)