{"uid":"cap_GpPaRf8buKHwEcbiky8Ff","slug":"us-census-acs-5-year-demographics-by-zip-code-f4060e70","name":"US Census ACS 5-Year Demographics by ZIP Code","description":"US Census Bureau American Community Survey (ACS) 5-Year estimates for a ZIP code: total population, median household income, median age, and total housing units. ZIP codes map to Census ZCTAs (Census-drawn approximations); some ZIPs (PO-box-only or very new) have no ZCTA match and return 404. Reflects a rolling 5-year survey window, not real-time.","url":"https://x402-seller.onrender.com/census/demographics","method":"GET","headers":{},"bodySchema":{"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":["zip"],"properties":{"zip":{"type":"string","description":"5-digit US ZIP code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"zip":{"type":"string"},"name":{"type":["string","null"]},"zcta":{"type":"string"},"source":{"type":"string"},"vintage":{"type":"string"},"medianAge":{"type":["number","null"]},"population":{"type":["number","null"]},"housingUnits":{"type":["number","null"]},"medianHouseholdIncome":{"type":["number","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_s7_vJGDjR4VJJldn63UhU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns US Census Bureau ACS 5-year estimates (population, median household income, median age, housing units) for a given 5-digit ZIP code via ZCTA mapping.","exampleAgentPrompt":"Can you pull up the census demographics for ZIP code 10001 — I want to see the population, median household income, median age, and total housing units for that area?","exampleUseCases":[{"title":"Identify high-income target markets for expansion","prompt":"I'm looking to open a new luxury retail location and need to find ZIP codes with median household incomes above $120,000. Can you pull the census data for these five ZIP codes I'm considering and show me which ones have the highest median income?"},{"title":"Assess neighborhood demographics before relocation","prompt":"My company is thinking about relocating our office to downtown Denver. Can you grab the latest census data for ZIP code 80202 so I can see what the population, median age, and housing situation look like in that area?"},{"title":"Validate market size for service rollout","prompt":"We're planning to launch a new service in the Northeast and want to prioritize markets with substantial populations. Can you look up the census demographics for these ZIP codes — 02134, 10002, and 07102 — and tell me which ones have the highest total population?"}],"resultDescription":"Returns a JSON object with the ZIP code, matched ZCTA code, geographic name, ACS vintage year, total population, median household income, median age, and total housing units. Values may be null for some fields if the Census did not collect enough data. Returns 404 if the ZIP has no corresponding ZCTA (e.g. PO-box-only or very new ZIPs).","failureModes":["404 if ZIP code has no matching ZCTA (PO-box-only ZIPs, very new ZIPs)","Invalid or non-existent ZIP code returns an error","Missing required 'zip' query parameter causes a bad request error","Census API upstream outage may cause service unavailability","Data is not real-time — reflects a rolling 5-year survey window, potentially lagging current conditions"],"whenToPreferThis":"Use this endpoint when you need official US Census Bureau demographic estimates (population, income, age, housing) for a specific ZIP code and can tolerate a rolling 5-year survey window rather than real-time data. Prefer this over third-party demographic APIs when authoritative government sourcing is required. Not suitable for ZIPs that are PO-box-only or very recently created.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:18.135Z","isFirstParty":false}