Locus Housing Stock

{
  "caveats": [
    "Tract-level ACS estimates carry margins of error; small tracts are noisy."
  ],
  "changes": {
    "bpsMultifamilyPermits": {
      "countyFips": "37183",
      "note": "Recent multifamily (5+ unit) permits authorized from Census BPS via HUD ArcGIS layer. Source for new permitted rental...",
      "permits": [],
      "provenance": {
        "source": "U.S. Census Bureau Building Permits Survey (BPS) via HUD Residential Construction Permits by County",
        "url": "https://services.arcgis.com/VTyQ9soqVukalItT/arcgis/rest/services/Residential_Construction_Permits_by_County/FeatureS..."
      }
    },
    "housingUnitNetChanges": {
      "countyFips": "37183",
      "exampleBulkFile": "https://www2.census.gov/geo/pvs/addcountlisting/2025/01_Alabama_AddressBlockCountList_112025.txt",
      "note": "Net housing unit changes (additions including multifamily, losses) from U.S. Census Bureau Address Count Listing File...",
      "provenance": {
        "source": "U.S. Census Bureau Address Count Listing Files (Master Address File)",
        "url": "https://www.census.gov/geographies/reference-files/time-series/geo/addcountlisting.html"
      }
    },
    "lihtcNearby": {
      "nearby": [
        {
          "CURCNTY": "183",
          "HUD_ID": "NCA1990265",
          "LI_UNITS": 6,
          "N_UNITS": 6,
          "PROJECT": "JEDAHOLU",
          "PROJ_ADD": "627 DOROTHEA DR",
          "PROJ_CTY": "RALEIGH",
          "PROJ_ST": "NC",
          "PROJ_ZIP": 27603,
          "TYPE": 1,
          "YR_ALLOC": 1989,
          "YR_PIS": 1990
        }
      ],
      "note": "LIHTC (Low-Income Housing Tax Credit) properties near the point from HUD data. Specific examples of subsidized multif...",
      "provenance": {
        "source": "U.S. Department of Housing and Urban Development LIHTC Properties",
        "url": "https://egis.hud.gov/arcgis/rest/services/affht/AffhtMapService/MapServer/30"
      }
    }
  },
  "county": {
    "countyFips3": "183",
    "name": "Wake County",
    "stateFips": "37"
  },
  "facts": [
    {
      "label": "housing stock (single keyed query)",
      "table": "B25001+B25002+B25003+B25064+B25077+B25035",
      "values": {
        "B25001_001E": "3842",
        "B25002_002E": "3018",
        "B25002_003E": "824",
        "B25003_001E": "3018",
        "B25003_002E": "510",
        "B25003_003E": "2508",
        "B25024_002E": "112",
        "B25024_003E": "179",
        "B25024_004E": "65",
        "B25024_005E": "111",
        "B25024_006E": "40",
        "B25024_007E": "64",
        "B25024_008E": "241",
        "B25024_009E": "2966",
        "B25024_010E": "0",
        "B25024_011E": "64",
        "B25032_001E": "3018",
        "B25032_007E": "40",
        "B25032_008E": "36",
        "B25032_009E": "71",
        "B25032_010E": "179",
        "B25035_001E": "2013",
        "B25036_001E": "3018",
        "B25036_002E": "510",
        "B25036_003E": "43",
        "B25036_004E": "116",
        "B25036_005E": "167",
        "B25036_006E": "8",
        "B25036_007E": "18",
        "B25064_001E": "1884",
        "B25077_001E": "599000"
      }
    }
  ],
  "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report...",
  "ok": true,
  "point": {
    "latitude": 35.780418000003195,
    "longitude": -78.63910200000142
  },
  "provenance": {
    "api": "api.census.gov (keyed)",
    "coverage": "national, census-tract level (ACS); county (BPS/Address Counts); point (LIHTC)",
    "geocoder": "https://geocoding.geo.census.gov/geocoder/geographies/coordinates",
    "source": "U.S. Census Bureau, American Community Survey 5-year (housing-stock tables) + BPS (via HUD) + Address Count Listing F...",
    "sourcePage": "https://www.census.gov/data/developers/data-sets/acs-5year.html",
    "vintage": "ACSDT5Y2023"
  },
  "tract": {
    "geoid": "37183050100",
    "name": "Census Tract 501"
  },
  "verifyNext": [
    {
      "step": "Explore the tract's full ACS tables at data.census.gov.",
      "url": "https://data.census.gov/profile?g=1400000US37183050100"
    }
  ]
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://api.locus.report/api/locus-housing-stock' \
  -H 'content-type: application/json' \
  --data-raw '{"address":"1 E Edenton St, Raleigh, NC 27601"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://api.locus.report/api/locus-housing-stock' \
  -H 'content-type: application/json' \
  --data-raw '{"address":"1 E Edenton St, Raleigh, NC 27601"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.locus.report%2Fapi%2Flocus-housing-stock&method=POST
const res = await pay("https://api.locus.report/api/locus-housing-stock", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "address": "1 E Edenton St, Raleigh, NC 27601"
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://api.locus.report/api/locus-housing-stock",
        json={
            "address": "1 E Edenton St, Raleigh, NC 27601",
        },
    )
    print(res.status_code, res.text)