{"name":"geocode-address","id":"sfoln/geocode-address","title":"Geocoding API – Address to Coordinates","description":"Geocode addresses to coordinates and reverse-geocode coordinates to addresses worldwide: formatted address, latitude/longitude, confidence, address parts, timezone, currency and calling code. US street addresses add Census tract, county and congressional district. $0.80 per 1,000 lookups.","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":["DEVELOPER_TOOLS","AUTOMATION","TRAVEL"],"availability":"on_request","seoTitle":"Geocoding API – $0.80 per 1,000 Addresses","seoDescription":"Geocoding API: addresses to latitude/longitude and back, worldwide, with timezone and address parts; US addresses add Census tract. $0.80 per 1,000 lookups.","summary":"Geocoding API – Address to Coordinates converts addresses to coordinates and coordinates to addresses, worldwide, in bulk. Each result is one clean record with the formatted address, latitude/longitude, a confidence score, structured components (country, state, city, postcode, road, house number) and useful extras: timezone and UTC offset, currency, calling code, flag, driving side and an OpenStreetMap link. US street addresses are matched by the US Census Bureau geocoder and also get their Census geographies (tract, block, county FIPS, congressional and state legislative districts, ZIP code area, metro area) at no extra cost. Mix both directions in one list: anything that looks like lat,lng is reverse-geocoded. Built for CRM and lead enrichment, logistics, analytics, store locators and AI agents.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":10,"events":[{"name":"address-geocoded","title":"Geocoded address","description":"Charged once per address or coordinate pair looked up: a US Census match, an OpenCage result, or an OpenCage lookup with no match (OpenCage counts those too).","priceUsd":0.0008}]},"input":{"description":"List addresses (forward geocoding) or \"lat,lng\" pairs (reverse geocoding), one per line.","required":["queries"],"fields":[{"name":"queries","title":"Addresses or coordinates","type":"array","required":true,"description":"Addresses or place names (forward), or \"latitude,longitude\" pairs such as \"52.5163,13.3777\" (reverse; latitude first), one per line. Max 500 characters per line. Accounts on the Apify free plan can process up to 10 addresses per run.","prefill":["Brandenburger Tor, Berlin","40.7484,-73.9857"],"editor":"stringList"},{"name":"countryCode","title":"Country hint","type":"string","required":false,"description":"Restrict forward results to these countries: ISO 3166-1 alpha-2 code(s), comma separated, e.g. \"us\" or \"de,at,ch\". Strongly recommended for short or ambiguous addresses. With \"us\" every street address goes to the US Census geocoder first.","editor":"textfield"},{"name":"language","title":"Language","type":"string","required":false,"description":"Language for the formatted address and components, e.g. \"en\", \"de\", or \"native\" for the local language. Default: English where available.","editor":"textfield"},{"name":"useCensusForUs","title":"Use the US Census geocoder for US addresses","type":"boolean","required":false,"description":"US street addresses are geocoded by the free US Census Bureau geocoder first (adds censusGeographies: tract, county, congressional district …); addresses it cannot match fall back to OpenCage. Off = OpenCage for every input.","default":true},{"name":"maxItems","title":"Max items","type":"integer","required":false,"description":"Safety cap on how many addresses are processed in this run.","default":1000,"minimum":1,"maximum":100000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"Parallel requests (1–5). The geocoder limits requests per second, so more workers mostly add rate-limit errors.","default":2,"minimum":1,"maximum":5},{"name":"includeRaw","title":"Include raw upstream response","type":"boolean","required":false,"description":"Attach the unmodified upstream response to each record (OpenCage's answer, or { census } for US Census matches; larger output).","default":false}]},"exampleInput":{"queries":["Brandenburger Tor, Berlin","40.7484,-73.9857"]},"outputFields":[{"name":"input","type":"string | object","title":"Input","description":"The input item this record corresponds to."},{"name":"status","type":"string","title":"Status","description":"ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan"},{"name":"charged","type":"boolean","title":"Charged","description":"Whether the record's main event was charged."},{"name":"chargedEvent","type":"string | null","title":"Charged event","description":"Event charged by the runner for this record, if any."},{"name":"source","type":"string","title":"Source","description":"Which geocoder answered: census (US Census Bureau geocoder, US street addresses) or opencage (everything else)."},{"name":"fetchedAt","type":"string","title":"Fetched at","description":"ISO timestamp."},{"name":"warnings","type":"array | null","title":"Warnings","description":"Non-fatal problems (pages not reachable, truncation, budget limits)."},{"name":"error","type":"object | null","title":"Error","description":"{ code, message, provider?, status? } when status is not ok."},{"name":"query","type":"string | null","title":"Query","description":"The address or \"lat,lng\" pair as provided."},{"name":"mode","type":"string | null","title":"Mode","description":"forward (address → coordinates) or reverse (coordinates → address)."},{"name":"formatted","type":"string | null","title":"Formatted address","description":"Full formatted address of the best match."},{"name":"latitude","type":"number | null","title":"Latitude","description":"WGS84 latitude."},{"name":"longitude","type":"number | null","title":"Longitude","description":"WGS84 longitude."},{"name":"confidence","type":"integer | null","title":"Confidence","description":"OpenCage confidence 0–10 (10 = within ~250 m bounding box, 1 = > 25 km, 0 = unknown); US Census matches are street-address points (10)."},{"name":"type","type":"string | null","title":"Result type","description":"Kind of match: building, road, city, postcode, county, state, country ... (Census matches: building)."},{"name":"components","type":"object | null","title":"Components","description":"{ country, countryCode, state, city, postcode, road, houseNumber } (city falls back to town / village / municipality)."},{"name":"timezone","type":"string | null","title":"Timezone","description":"IANA timezone, e.g. Europe/Berlin."},{"name":"utcOffset","type":"string | null","title":"UTC offset","description":"Current UTC offset, e.g. +0200."},{"name":"currency","type":"string | null","title":"Currency","description":"ISO 4217 currency code of the location."},{"name":"callingCode","type":"integer | null","title":"Calling code","description":"International dialling code."},{"name":"flag","type":"string | null","title":"Flag","description":"Country flag emoji."},{"name":"driveOn","type":"string | null","title":"Drives on","description":"left | right."},{"name":"speedUnit","type":"string | null","title":"Speed unit","description":"kmh | mph."},{"name":"mapUrl","type":"string | null","title":"Map URL","description":"OpenStreetMap link to the location."},{"name":"attribution","type":"string | null","title":"Attribution","description":"Data source of the result (OpenCage / OpenStreetMap contributors, or the US Census Bureau geocoder)."},{"name":"matchType","type":"string | null","title":"Match type","description":"Census matches: exact (agrees with every part of the input) or non_exact (the Census corrected part of the address, e.g. the ZIP code); null for OpenCage."},{"name":"censusGeographies","type":"object | null","title":"Census geographies","description":"US Census matches: state, county, tract, blockGroup, block, congressionalDistrict, stateLegislativeDistrictUpper/Lower, place, countySubdivision, zcta, cbsa, csa, metropolitanDivision, schoolDistrict, urbanArea, puma, region, division. Null for OpenCage results."},{"name":"candidates","type":"array | null","title":"Candidates","description":"Census ambiguous_address records (OpenCage not configured): the matching addresses { formatted, latitude, longitude }."},{"name":"found","type":"boolean | null","title":"Found","description":"false on not_found records."},{"name":"raw","type":"object | null","title":"Raw","description":"Unmodified upstream response (includeRaw): OpenCage's answer, or { census } for US Census matches."}],"outputExample":{"input":"1600 Pennsylvania Ave NW, Washington, DC 20500","query":"1600 Pennsylvania Ave NW, Washington, DC 20500","mode":"forward","formatted":"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500","latitude":38.898702605245,"longitude":-77.035189204737,"confidence":10,"type":"building","timezone":"America/New_York","utcOffset":"-0400","currency":"USD","callingCode":1,"flag":"🇺🇸","driveOn":"right","speedUnit":"mph","mapUrl":"https://www.openstreetmap.org/?mlat=38.898702605245&mlon=-77.035189204737#map=17/38.898702605245/-77.035189204737","components":{"country":"United States","countryCode":"US","state":"District of Columbia","city":"WASHINGTON","postcode":"20500","road":"PENNSYLVANIA AVE NW","houseNumber":"1600"},"source":"census","attribution":"U.S. Census Bureau Geocoder (public domain)","matchType":"exact","censusGeographies":{"state":{"fips":"11","code":"DC","name":"District of Columbia"},"county":{"fips":"11001","name":"District of Columbia"},"tract":{"geoid":"11001980000","code":"980000","name":"Census Tract 9800"},"block":{"geoid":"110019800001034","code":"1034","name":"Block 1034"},"congressionalDistrict":{"geoid":"1198","code":"98","name":"Delegate District (at Large)","congress":120},"zcta":"20006","cbsa":{"geoid":"47900","code":"47900","name":"Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area","type":"metropolitan"}},"status":"ok","charged":true,"chargedEvent":"address-geocoded","fetchedAt":"2026-10-14T10:00:00.000Z"},"faq":[{"question":"Which geocoder answers my address?","answer":"US street addresses go to the US Census Bureau geocoder first (free, and it adds the Census tract, county and congressional district); every other address, coordinates and the US addresses the Census cannot match go to OpenCage (OpenStreetMap data). Each record says which one in its source field."},{"question":"Why is a US address in upper case?","answer":"Census results use the standardized USPS form of the address (\"1600 PENNSYLVANIA AVE NW\"). Turn off useCensusForUs to get OpenCage's formatting for every input."}],"mcpExamplePrompt":"Geocode \"Brandenburger Tor, Berlin\" and \"350 Fifth Avenue, New York\" and give me their coordinates and time zones.","related":["us-address-enrichment","weather-forecast","historical-weather","google-maps-search"],"urls":{"site":"https://www.sfoln.com/actors/geocode-address/","siteJson":"https://www.sfoln.com/actors/geocode-address.json","siteMarkdown":"https://www.sfoln.com/actors/geocode-address.md","runSync":"https://api.apify.com/v2/actors/sfoln~geocode-address/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~geocode-address/runs","mcp":"https://mcp.apify.com?tools=sfoln/geocode-address","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20Geocoding%20API%20%E2%80%93%20Address%20to%20Coordinates%20(sfoln%2Fgeocode-address)&body=Please%20publish%20geocode-address.%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"}