{"uid":"cap_HSRTWpHYM6nU-RtvXT3EG","slug":"x402datasource-com-04045c19","name":"x402datasource Enhanced Demographics","description":"Returns detailed demographic, housing, education, employment, and income data for a geographic area around a US address or coordinates.","url":"https://x402datasource.com/api/v1/enhanced-demographics?utm_source=zero.xyz","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":["address"],"properties":{"lat":{"type":"number","description":"Latitude. Required if address is not provided."},"lon":{"type":"number","description":"Longitude. Required if address is not provided."},"address":{"type":"string","description":"Full US street address to geocode. Required if lat/lon are not provided."},"vintage":{"type":"integer","description":"ACS data vintage year. Defaults to the latest available. Available: 2022, 2023, 2024"},"radius_miles":{"type":"number","description":"Search radius in miles. Defaults to 3."},"radius_meters":{"type":"integer","description":"Search radius in meters. Overrides radius_miles if provided."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"pop_male":{"type":"integer","description":"Male population."},"pop_asian":{"type":"integer","description":"Asian population."},"pop_black":{"type":"integer","description":"Black population."},"pop_white":{"type":"integer","description":"White population."},"pop_female":{"type":"integer","description":"Female population."},"pop_25_plus":{"type":"integer","description":"Population aged 25 and over."},"pop_masters":{"type":"integer","description":"Population with master's degree."},"pop_hispanic":{"type":"integer","description":"Hispanic population."},"housing_owner":{"type":"integer","description":"Owner-occupied housing units."},"housing_units":{"type":"integer","description":"Total housing units."},"pop_bachelors":{"type":"integer","description":"Population with bachelor's degree."},"pop_doctorate":{"type":"integer","description":"Population with doctorate degree."},"housing_renter":{"type":"integer","description":"Renter-occupied housing units."},"housing_vacant":{"type":"integer","description":"Vacant housing units."},"pop_unemployed":{"type":"integer","description":"Unemployed population."},"housing_occupied":{"type":"integer","description":"Occupied housing units."},"total_population":{"type":"integer","description":"Total population within the search radius."},"pop_below_poverty":{"type":"integer","description":"Population below poverty level."},"weighted_median_age":{"type":"number","description":"Population-weighted median age."},"civilian_labor_force":{"type":"integer","description":"Civilian labor force."},"weighted_median_hh_income":{"type":"number","description":"Population-weighted median household income."},"weighted_median_gross_rent":{"type":"number","description":"Population-weighted median gross rent."},"weighted_median_home_value":{"type":"number","description":"Population-weighted median home value."},"weighted_per_capita_income":{"type":"number","description":"Population-weighted per capita income."},"weighted_avg_household_size":{"type":"number","description":"Population-weighted average household size."}}},"meta":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"address":{"type":"string"},"radius_miles":{"type":"number"},"radius_meters":{"type":"integer"}}}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"address":"1600 Pennsylvania Avenue NW, Washington, DC 20500","vintage":2023,"radius_miles":3}}},"response":{"data":{"pop_male":177884,"pop_asian":27196,"pop_black":75333,"pop_white":205944,"pop_female":185643,"pop_25_plus":279122,"pop_masters":79939,"pop_hispanic":48548,"housing_owner":67160,"housing_units":219745,"pop_bachelors":92432,"pop_doctorate":15819,"housing_renter":129348,"housing_vacant":23237,"pop_unemployed":10020,"housing_occupied":196508,"total_population":363527,"pop_below_poverty":0,"weighted_median_age":34.94,"civilian_labor_force":252074,"weighted_median_hh_income":131847.78,"weighted_median_gross_rent":2269.34,"weighted_median_home_value":661304.23,"weighted_per_capita_income":92995.14,"weighted_avg_household_size":1.82},"meta":{"lat":38.897675,"lon":-77.036547,"address":"1600 Pennsylvania Avenue NW, Washington, DC 20500","radius_miles":3,"radius_meters":4828}}},"exampleRequest":{"address":"1600 Pennsylvania Avenue NW, Washington, DC 20500","vintage":2023,"radius_miles":3},"tags":["x402"],"displayCostAmount":"0.05","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PJeoIoQ0W8z-_blF8UGd8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed demographic, housing, education, employment, and income data for a US address or geographic coordinates within a configurable radius.","exampleAgentPrompt":"Pull the detailed census demographics — population breakdown by race, gender, education, housing, and income — for the area within 3 miles of 1600 Pennsylvania Ave NW, Washington DC, using the 2023 ACS vintage.","exampleUseCases":null,"resultDescription":"A structured object containing detailed demographic counts and statistics for the specified geographic area, including male/female population, racial/ethnic breakdowns (white, Black, Asian, Hispanic), educational attainment (bachelor's, master's, doctorate), housing unit counts, owner-occupied housing, and income data derived from the ACS survey for the selected vintage year.","failureModes":["Address cannot be geocoded — returns error if the provided US address is unrecognizable","Missing required address/lat/lon — returns validation error if neither address nor coordinates are provided","Invalid vintage year — returns error if requested ACS vintage is not one of 2022, 2023, 2024","Payment failure — returns 402 if USDC payment is not included or insufficient","No census data available — sparse or unpopulated areas may return empty or null fields"],"whenToPreferThis":"Use this endpoint when you need comprehensive, multi-dimensional demographic data (demographics, housing, education, employment, income all in one call) for a specific US location. Prefer this over the sibling basic demographics endpoint when you need granular breakdowns beyond just population and median income. Ideal for real estate analysis, site selection, market research, or any enrichment workflow that needs census-derived neighborhood statistics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-05-19T01:02:30.513Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T11:26:23.800Z","isFirstParty":false,"canonicalSlug":"x402datasource-com-04045c19"}