{"name":"us-address-enrichment","id":"sfoln/us-address-enrichment","title":"US Address Geocoder – Census Tract & Flood","description":"Geocode US addresses with the US Census Bureau geocoder: matched address, latitude/longitude, state and county FIPS, census tract, block group, block, congressional and legislative districts, ZCTA and metro area, plus an optional FEMA flood zone. $3 per 1,000 addresses; no-match addresses are free.","version":"0.1","status":"ready","family":{"id":"data-utilities","name":"Data utilities","description":"Exchange rates, geocoding, weather forecasts and history, VIN decoding, US address enrichment, GitHub repository stats and DeFi protocol data.","actors":8},"categories":["REAL_ESTATE","DEVELOPER_TOOLS","AUTOMATION"],"availability":"on_request","seoTitle":"US Census Geocoder API – Census Tract, FIPS & Flood Zone","seoDescription":"Geocode US addresses with the Census Bureau: coordinates, county FIPS, census tract, block group, congressional district and FEMA flood zone. $3 per 1,000.","summary":"US Address Geocoder – Census Tract & Flood turns US street addresses into coordinates and Census geographies with the official US Census Bureau geocoder: the standardised matched address, latitude/longitude, state and county FIPS codes, census tract, block group and block, the congressional and state legislative districts, place, ZCTA, metro area and school district. Add the FEMA flood zone of each address (zone, Special Flood Hazard Area flag, base flood elevation, FIRM panel and its effective date) with one switch. Built for real estate, insurance, lending, public-sector and data teams who need tract-level joins or flood screening without a GIS stack. $3 per 1,000 matched addresses, plus $2 per 1,000 flood zones; addresses the Census cannot match are free.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":10,"events":[{"name":"address","title":"Enriched address","description":"Charged once per address (or latitude,longitude point) that the US Census geocoder matched to a single US location, with its Census geographies. Addresses without a match, ambiguous addresses, invalid inputs and errors are free.","priceUsd":0.003},{"name":"flood-zone","title":"Flood zone","description":"Optional add-on (includeFloodZone): charged once per enriched address for which FEMA's National Flood Hazard Layer has a flood zone at the point. Points outside the digital flood maps or marked \"AREA NOT INCLUDED\" (no flood hazard determination) are free.","priceUsd":0.002}]},"input":{"description":"US addresses (or latitude,longitude points) to geocode with the US Census Bureau geocoder. Each input produces one dataset record with a `status` field; only matched addresses are charged.","required":["addresses"],"fields":[{"name":"addresses","title":"Addresses","type":"array","required":true,"description":"US addresses, one per line, as one line of text (\"1600 Pennsylvania Ave NW, Washington, DC 20500\", at most 100 characters) or a point (\"38.8977,-77.0365\"). Through the API you can also send objects: {\"street\", \"city\", \"state\", \"zip\"}, {\"address\": \"<the whole address on one line>\"} or {\"latitude\", \"longitude\"}. Accounts on the Apify free plan can process up to 10 addresses per run.","prefill":["1600 Pennsylvania Ave NW, Washington, DC 20500"],"editor":"stringList"},{"name":"includeFloodZone","title":"Add the FEMA flood zone (+$0.002 per address)","type":"boolean","required":false,"description":"Look up the FEMA National Flood Hazard Layer at each matched point: flood zone (A, AE, VE, X …), Special Flood Hazard Area flag, base flood elevation, FIRM panel and its effective date. Charged as the flood-zone event only when FEMA has a zone at the point.","default":false},{"name":"includeFccArea","title":"Add the FCC block and market areas (free)","type":"boolean","required":false,"description":"Add the FCC Area API answer for each matched point: 2020 Census block, its population, and the FCC market areas (CMA, PEA, BTA, MTA, BEA …). No extra charge.","default":false},{"name":"vintage","title":"Census geography vintage","type":"string","required":false,"description":"Which geography vintage the tract, block, districts and other areas come from. Current_Current is the latest (e.g. the 120th Congress districts); Census2020_Current gives the 2020 Census tracts and blocks; ACS vintages match American Community Survey tables.","default":"Current_Current","enum":["Current_Current","Census2020_Current","ACS2026_Current","ACS2025_Current","ACS2024_Current","ACS2023_Current","ACS2022_Current","ACS2021_Current","Census2010_Current"],"editor":"select"},{"name":"maxItems","title":"Max addresses","type":"integer","required":false,"description":"Safety cap on how many addresses are processed in this run; the rest are ignored and reported as inputItemsDropped in the OUTPUT record.","default":1000,"minimum":1,"maximum":100000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"How many addresses are processed in parallel (the Census geocoder is also rate-limited to 10 requests per second per run).","default":5,"minimum":1,"maximum":10},{"name":"includeRaw","title":"Include raw upstream responses","type":"boolean","required":false,"description":"Attach the unmodified Census, FEMA and FCC answers to each record under raw (much larger output).","default":false}]},"exampleInput":{"addresses":["1600 Pennsylvania Ave NW, Washington, DC 20500"]},"outputFields":[{"name":"input","type":"string | object","title":"Input","description":"The address (or point) exactly as sent."},{"name":"status","type":"string","title":"Status","description":"ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan | skipped_unmetered","example":"ok"},{"name":"charged","type":"boolean","title":"Charged","description":"Whether this record incurred its pay-per-event charge (the address event; add-on charges are listed in chargedAddOns)."},{"name":"chargedEvent","type":"string","title":"Charged event","description":"Pay-per-event event charged for this record (present only when charged): address."},{"name":"chargedCount","type":"integer","title":"Events charged","description":"Events actually charged when the charge came back short of the requested count (present only then; a warning explains it)."},{"name":"chargedAddOns","type":"array","title":"Charged add-ons","description":"Add-on events charged for this record besides chargedEvent (present only then): flood-zone."},{"name":"source","type":"string","title":"Source","description":"Upstream data source: us-census-geocoder (with FEMA NFHL and the FCC Area API for the optional fields)."},{"name":"fetchedAt","type":"string","title":"Fetched at","description":"ISO timestamp."},{"name":"error","type":"object","title":"Error","description":"{ code, message, provider?, status? } when status is not ok. Codes: not_found (no match, or a point outside the US), ambiguous_address (several candidates, see candidates), invalid_input; set by the runtime: budget_exhausted, free_plan_limit, unmetered, aborted, charge_failed, record_too_large, invalid_record, dataset_push_failed; upstream: http_error (with the HTTP status), network, tls_error, timeout, invalid_json, unexpected_type, too_large, invalid_response."},{"name":"warnings","type":"array","title":"Warnings","description":"Notes about this record: a flood zone that was not charged or not available, an FCC lookup that failed, a charge that came back short."},{"name":"inputType","type":"string | null","title":"Input type","description":"address | coordinates."},{"name":"matchType","type":"string | null","title":"Match type","description":"exact (the match agrees with every part of the input) | non_exact (the Census corrected or completed the address: check matchedAddress) | tie (several candidates, not charged) | no_match (not charged) | null for coordinate inputs."},{"name":"matchedAddress","type":"string | null","title":"Matched address","description":"The address as the Census standardised it, e.g. \"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500\"."},{"name":"latitude","type":"number | null","title":"Latitude","description":"WGS84 latitude of the match (interpolated along the street segment), or the input point."},{"name":"longitude","type":"number | null","title":"Longitude","description":"WGS84 longitude."},{"name":"candidates","type":"array","title":"Candidates","description":"Only for matchType tie: up to 10 { matchedAddress, latitude, longitude, stateCode, countyFips } the address could be."},{"name":"addressComponents","type":"object | null","title":"Address components","description":"{ houseNumber, street, streetName, city, state, zip } of the matched address (mailing city and state, which can differ from the Census geography, e.g. Washington, DC addresses in Maryland)."},{"name":"tigerLineId","type":"string | null","title":"TIGER/Line ID","description":"Census TIGER/Line edge the address range lies on."},{"name":"tigerLineSide","type":"string | null","title":"Street side","description":"L or R side of the TIGER/Line edge."},{"name":"stateFips","type":"string | null","title":"State FIPS","description":"2-digit state FIPS code of the point (the Census geography)."},{"name":"stateCode","type":"string | null","title":"State","description":"USPS state code of the point."},{"name":"stateName","type":"string | null","title":"State name","description":"State name."},{"name":"countyFips","type":"string | null","title":"County FIPS","description":"5-digit state + county FIPS code."},{"name":"countyName","type":"string | null","title":"County","description":"County (parish, borough) name."},{"name":"tractGeoid","type":"string | null","title":"Census tract GEOID","description":"11-digit state + county + tract code (the key of tract-level ACS tables)."},{"name":"tractCode","type":"string | null","title":"Tract code","description":"6-digit tract code within the county."},{"name":"blockGroupGeoid","type":"string | null","title":"Block group GEOID","description":"12-digit block group GEOID."},{"name":"blockGroupCode","type":"string | null","title":"Block group","description":"1-digit block group within the tract."},{"name":"blockGeoid","type":"string | null","title":"Block GEOID","description":"15-digit Census block GEOID."},{"name":"blockCode","type":"string | null","title":"Block code","description":"4-digit block code within the tract."},{"name":"congressionalDistrict","type":"object | null","title":"Congressional district","description":"{ code, geoid, name, congress }: code is the district number (\"00\" at large, \"98\" non-voting delegate), congress e.g. 120."},{"name":"stateLegislativeDistrictUpper","type":"object | null","title":"State senate district","description":"{ geoid, code, name } of the upper-house district."},{"name":"stateLegislativeDistrictLower","type":"object | null","title":"State house district","description":"{ geoid, code, name } of the lower-house district (null where there is none, e.g. DC, Nebraska)."},{"name":"place","type":"object | null","title":"Place","description":"{ geoid, code, name, type }: the incorporated place (city, town) or census designated place."},{"name":"countySubdivision","type":"object | null","title":"County subdivision","description":"{ geoid, code, name } (township, town, census county division)."},{"name":"zcta","type":"string | null","title":"ZCTA","description":"ZIP Code Tabulation Area (the Census approximation of a ZIP code area)."},{"name":"cbsa","type":"object | null","title":"Metro / micro area","description":"{ geoid, code, name, type }: core-based statistical area, type metropolitan or micropolitan."},{"name":"csa","type":"object | null","title":"Combined statistical area","description":"{ geoid, code, name }."},{"name":"metropolitanDivision","type":"object | null","title":"Metropolitan division","description":"{ geoid, code, name } inside the largest metro areas."},{"name":"schoolDistrict","type":"object | null","title":"School district","description":"{ geoid, code, name, type }: unified, else elementary or secondary district."},{"name":"urbanArea","type":"object | null","title":"Urban area","description":"{ geoid, code, name } (null in rural areas)."},{"name":"puma","type":"object | null","title":"PUMA","description":"{ geoid, code, name } Public Use Microdata Area."},{"name":"censusRegion","type":"string | null","title":"Census region","description":"Northeast, Midwest, South or West."},{"name":"censusDivision","type":"string | null","title":"Census division","description":"e.g. South Atlantic."},{"name":"vintage","type":"string | null","title":"Vintage","description":"Census geography vintage used (input vintage)."},{"name":"floodZone","type":"object | null","title":"Flood zone","description":"Only with includeFloodZone: { zone, zoneSubtype, sfha, riskLevel, baseFloodElevation, depth, elevationUnit, verticalDatum, dfirmId, panel, panelEffectiveDate, panelType, otherZones } from FEMA's National Flood Hazard Layer; null when FEMA has no zone at the point (not charged)."},{"name":"fccArea","type":"object | null","title":"FCC area","description":"Only with includeFccArea: { blockFips, blockPopulation2020, countyFips, countyName, stateFips, stateCode, stateName, marketAreas: { cma, pea, bta, mta, bea, eag, mea, rea, rpc, vpc, ivm, amt } }."},{"name":"raw","type":"object","title":"Raw","description":"Only with includeRaw: the unmodified census, fema and fcc answers."}],"outputExample":{"input":"1600 Pennsylvania Ave NW, Washington, DC 20500","status":"ok","charged":true,"chargedEvent":"address","chargedAddOns":["flood-zone"],"source":"us-census-geocoder","fetchedAt":"2026-10-14T22:38:12.176Z","inputType":"address","matchType":"exact","matchedAddress":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500","latitude":38.898702605245,"longitude":-77.035189204737,"addressComponents":{"houseNumber":"1600","street":"PENNSYLVANIA AVE NW","streetName":"PENNSYLVANIA","city":"WASHINGTON","state":"DC","zip":"20500"},"tigerLineId":"76225813","tigerLineSide":"L","stateFips":"11","stateCode":"DC","stateName":"District of Columbia","countyFips":"11001","countyName":"District of Columbia","tractGeoid":"11001980000","tractCode":"980000","blockGroupGeoid":"110019800001","blockGroupCode":"1","blockGeoid":"110019800001034","blockCode":"1034","congressionalDistrict":{"geoid":"1198","code":"98","name":"Delegate District (at Large)","congress":120},"stateLegislativeDistrictUpper":{"geoid":"11002","code":"002","name":"Ward 2"},"stateLegislativeDistrictLower":null,"place":{"geoid":"1150000","code":"50000","name":"Washington city","type":"incorporated_place"},"countySubdivision":{"geoid":"1100150000","code":"50000","name":"Washington city"},"zcta":"20006","cbsa":{"geoid":"47900","code":"47900","name":"Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area","type":"metropolitan"},"csa":{"geoid":"548","code":"548","name":"Washington-Baltimore-Arlington, DC-MD-VA-WV-PA CSA"},"metropolitanDivision":{"geoid":"4790047764","code":"47764","name":"Washington, DC-MD Metro Division"},"schoolDistrict":{"geoid":"1100030","code":"00030","name":"District of Columbia Public Schools","type":"unified"},"urbanArea":{"geoid":"92242","code":"92242","name":"Washington--Arlington, DC--VA--MD Urban Area"},"puma":{"geoid":"1100106","code":"00106","name":"District of Columbia (South Central) PUMA"},"censusRegion":"South","censusDivision":"South Atlantic","vintage":"Current_Current","floodZone":{"zone":"X","zoneSubtype":"AREA OF MINIMAL FLOOD HAZARD","sfha":false,"riskLevel":"minimal","baseFloodElevation":null,"depth":null,"elevationUnit":null,"verticalDatum":null,"dfirmId":"110001","panel":"1100010018C","panelEffectiveDate":"2010-09-27","panelType":"Countywide, Panel Printed","otherZones":[]}},"faq":[{"question":"Which addresses can it geocode?","answer":"Street addresses in the 50 states, DC and Puerto Rico that are in the Census Bureau's address ranges (TIGER/Line). PO boxes, rural route boxes and addresses outside the US are not matched; they come back as no_match and are not charged."},{"question":"What does matchType mean?","answer":"exact: the match agrees with every part you gave (house number, street, directional, street type, city or ZIP, state). non_exact: the Census corrected or completed something, for example a missing street type or a different ZIP, so check matchedAddress. tie: the address fits several places (not charged; the candidates are listed). no_match: nothing found (not charged)."},{"question":"Is a ZCTA the same as a ZIP code?","answer":"Almost: a ZIP Code Tabulation Area is the Census Bureau's area approximation of a 5-digit ZIP code, so it can differ from the ZIP in the mailing address (addressComponents.zip)."},{"question":"How precise is the flood zone?","answer":"It is the FEMA National Flood Hazard Layer zone at the geocoded point. Census coordinates are interpolated along the street segment, so they can be a few lots away from the building; near a zone boundary otherZones lists the neighbouring zone."}],"mcpExamplePrompt":"Find the census tract, county FIPS code, congressional district and FEMA flood zone of 1600 Pennsylvania Ave NW, Washington, DC 20500.","related":["geocode-address","npi-lookup","weather-forecast","historical-weather"],"urls":{"site":"https://www.sfoln.com/actors/us-address-enrichment/","siteJson":"https://www.sfoln.com/actors/us-address-enrichment.json","siteMarkdown":"https://www.sfoln.com/actors/us-address-enrichment.md","runSync":"https://api.apify.com/v2/actors/sfoln~us-address-enrichment/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~us-address-enrichment/runs","mcp":"https://mcp.apify.com?tools=sfoln/us-address-enrichment","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20US%20Address%20Geocoder%20%E2%80%93%20Census%20Tract%20%26%20Flood%20(sfoln%2Fus-address-enrichment)&body=Please%20publish%20us-address-enrichment.%20What%20we%20plan%20to%20use%20it%20for%3A"},"publisher":{"name":"SFOLN LLC","apifyUsername":"sfoln","url":"https://www.sfoln.com","apifyProfile":"https://apify.com/sfoln","email":"contact@sfoln.com"},"generatedAt":"2026-10-22T04:28:58.477Z"}