{"uid":"cap_bVQo3OeQR0w9_6172vAXQ","slug":"2s-io-68e4ab10","name":"2s.io US Census ACS 5-Year Demographics by ZIP Code","description":"US Census ACS 5-year demographics for a ZIP code (ZCTA). Returns population, median age, median household income, poverty rate, household composition, race + ethnicity breakdown, education attainment, workforce (with computed unemployment rate), and housing (with computed owner-occupancy rate and median rent/home value). Backed by ~33k ZCTAs pre-ingested from api.census.gov; refreshed annually. Public-domain US government data.","url":"https://2s.io/api/census/zipcode","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["zip"],"properties":{"zip":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"zip":"10001"}}},"response":{"data":{"zip":"10001","race":{"asian":5031,"black":2355,"other":1279,"white":15428,"twoOrMore":2886,"americanIndianAlaskaNative":25,"nativeHawaiianPacificIslander":0},"income":{"medianHouseholdUSD":106509},"source":{"url":"https://www.census.gov/programs-surveys/acs","license":"Public domain (US government work, 17 USC § 105)","release":"ACS 5-year 2018-2022","provider":"US Census Bureau"},"acsYear":2022,"housing":{"units":16975,"occupied":14375,"ownerOccupied":3422,"renterOccupied":10953,"pctOwnerOccupied":23.81,"medianGrossRentUSD":2625,"medianHomeValueUSD":535100},"poverty":{"universe":25825,"rateBelow":15.86,"countBelow":4097},"education":{"masters":4344,"universe":21203,"bachelors":8911,"doctorate":561,"highSchool":1137,"professional":1223,"pctBachelorsOrHigher":70.93},"ethnicity":{"hispanicOrLatino":5206},"medianAge":35.7,"updatedAt":"2026-05-27T18:53:39.521Z","workforce":{"unemployed":761,"laborForceSize":17746,"unemploymentRate":4.29},"acsRelease":"ACS 5-year 2018-2022","households":{"total":14375,"singlePerson":10323},"population":27004},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"census.zipcode","settlement":{"txHash":"0x684037f8823d9da167ef96a50d1cd9d8d8b74336710dd76374c5145b74a2d5b9","network":"eip155:8453","success":true}}}},"exampleRequest":{"zip":"10001"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_asFNj2qvqJGs2GcohuXuG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed US Census ACS 5-year demographic data for a given 5-digit ZIP code (ZCTA), including population, income, poverty, race, education, workforce, and housing statistics.","exampleAgentPrompt":"What are the demographics for ZIP code 94103 — population, median household income, poverty rate, and racial breakdown?","exampleUseCases":null,"resultDescription":"A structured JSON object containing ACS 5-year estimates for the requested ZIP code (ZCTA), including: total population, median age, median household income, poverty rate, household composition, full race and ethnicity breakdown, education attainment levels, workforce size with computed unemployment rate, and housing data with owner-occupancy rate, median rent, and median home value. Data is sourced from ~33k pre-ingested ZCTAs refreshed annually.","failureModes":["Invalid ZIP format (not exactly 5 digits) — schema validation error","ZIP code not found in ZCTA database (rural or non-residential ZIPs may lack census data)","Service unavailable during annual data refresh","Payment failure via x402 protocol"],"whenToPreferThis":"Use this endpoint when you need rich, multi-dimensional US Census ACS demographic data for a specific ZIP code in a single call. Prefer this over raw Census API calls because it pre-ingests ~33k ZCTAs and computes derived metrics (unemployment rate, owner-occupancy rate). Ideal for enriching address data, building demographic profiles for market research, underwriting, site selection, or social analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:44:36.501Z","isFirstParty":false}