{"uid":"cap_5Cs_mNqfGQKT5qJ0yZkDz","slug":"x402datasource-com-648bf1a4","name":"x402datasource Demographics (Address/Coordinates)","description":"Returns population and weighted median household income for a geographic area around a US address or coordinates.","url":"https://x402datasource.com/api/v1/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":["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":{"total_population":{"type":"integer","description":"Total population within the search radius."},"weighted_median_hh_income":{"type":"number","description":"Population-weighted median household income."}}},"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":{"total_population":343988,"weighted_median_hh_income":139336.92},"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.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_svwCjyPBdeWVg92y-YJPL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns total population and weighted median household income for a geographic radius around a US address or lat/lon coordinates, sourced from ACS data.","exampleAgentPrompt":"What's the total population and weighted median household income within 5 miles of 1600 Pennsylvania Ave NW, Washington DC, using the 2023 ACS vintage?","exampleUseCases":null,"resultDescription":"Returns a JSON object with total_population (integer) and weighted_median_hh_income (float) for the specified geographic area, plus metadata including resolved lat/lon, address, and the radius used.","failureModes":["Address cannot be geocoded — returns error if the address is invalid or outside the US","Missing required input — returns error if neither address nor lat/lon is provided","Invalid vintage year — returns error if a non-supported ACS year is specified (only 2022, 2023, 2024 available)","No census tracts found in radius — may return null or zero values if radius is too small or in unpopulated area","Payment failure — x402 payment of $0.01 USDC not completed, request rejected"],"whenToPreferThis":"Use this endpoint when you need a quick, lightweight demographic snapshot (population + income only) for a geographic area around a specific US address or coordinates. It is faster and cheaper than the full detailed demographics endpoint. Ideal for real estate analysis, site selection, market sizing, or any scenario where only population count and median household income are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-05-20T18:55:01.859Z","lastSuccessfullyRanAt":"2026-05-08T15:22:28.276Z","lastHealthCheckAt":"2026-09-15T12:52:25.222Z","isFirstParty":false}