Geocoding Scraper - Address to Coordinates & Reverse (OpenStreetMap)

Turn messy addresses into clean coordinates, and coordinates back into full structured addresses, in batch. This actor is a complete geocoding and reverse geocoding tool powered by OpenStreetMap data. Give it a list of addresses and get latitude and longitude plus a fully parsed address (house number, road, city, state, postcode, country). Give it a list of coordinates and get the nearest address. It beats a bare lat/lon by returning the full structured address and place metadata, in both directions, over your whole list.

Perfect for address validation, CRM and data enrichment, lead list cleanup, logistics and routing, and any mapping workflow that needs coordinates or a normalized address.

What you get

• Forward geocoding - convert any address or place name to latitude and longitude.
• Reverse geocoding - convert coordinates to the nearest full address.
• Structured geocoding - geocode from separate street, city, state, country and postcode fields for cleaner matches.
• Fully parsed address - house number, road, neighbourhood, suburb, city, county, state, postcode, country and ISO country code, each in its own field.
• Place metadata - display name, category, type, place rank, importance score, bounding box and OSM identifiers.
• Country and language control - bias results to specific countries and choose the response language.
• Honest no-match handling - unresolved inputs are returned with matched: false and are never billed.
• Place details add-on - optional extra tags (website, phone, opening hours, Wikidata, Wikipedia), admin level and approximate area.
• Export to JSON, CSV or Excel.

Example output

{
  "input": "Empire State Building",
  "mode": "forward",
  "matched": true,
  "lat": 40.7484421,
  "lon": -73.9856589,
  "displayName": "Empire State Building, 350, 5th Avenue, Koreatown, Manhattan Community Board 5, Manhattan, New York County, New York, 10118, United States",
  "name": "Empire State Building",
  "category": "office",
  "type": "yes",
  "addressType": "office",
  "placeRank": 30,
  "importance": 0.58,
  "boundingBox": [40.7479255, 40.7489585, -73.9865012, -73.9848166],
  "osmType": "way",
  "osmId": "34633854",
  "houseNumber": "350",
  "road": "5th Avenue",
  "neighbourhood": "Koreatown",
  "suburb": "Manhattan",
  "city": "New York",
  "county": "New York County",
  "state": "New York",
  "postcode": "10118",
  "country": "United States",
  "countryCode": "US",
  "website": "https://www.esbnyc.com/explore",
  "phone": "+1-212-736-3100",
  "openingHours": "Mo-Su 08:00-02:00",
  "wikidata": "Q9188",
  "observedAt": "2026-08-17T13:50:00.000Z",
  "error": null
}

Input

Field	Type	Description
mode	string	forward (address to coordinates), reverse (coordinates to address) or structured (address fields to coordinates). Default forward.
queries	array	Address or place strings to geocode. Used in forward mode.
coordinates	array	List of { "lat": number, "lon": number } objects to reverse-geocode. Used in reverse mode. Optional per-item zoom (3-18) controls detail level.
structured	array	List of { "street", "city", "state", "country", "postalcode" } objects. Used in structured mode.
countryCodes	string	Optional comma-separated ISO country codes to bias forward and structured results, e.g. us,mx.
language	string	Preferred language for the address and display name, e.g. en, es, fr. Default en.
limit	integer	Maximum matches to return per forward or structured query (1-50). Default 1.
maxResults	integer	Optional overall cap on result rows across all inputs. Free plans are capped at 10.
includeDetails	boolean	Off by default. Enrich each resolved place with extra tags, admin level and approximate area (paid add-on).

Output fields

Field	Description
input	The original query, coordinate or structured object.
mode	The mode used for this row.
matched	Whether a location was resolved. false rows are never billed.
lat, lon	Latitude and longitude of the match.
displayName	Full human-readable address line.
name	Place name when present.
category, type, addressType	OpenStreetMap classification of the place.
placeRank, importance	Ranking and importance score of the match.
boundingBox	[south, north, west, east] bounding box.
osmType, osmId	OpenStreetMap element type and id.
houseNumber, road, neighbourhood, suburb, city, county, state, postcode, country, countryCode	Flattened structured address components.
website, phone, openingHours, wikidata, wikipedia, extratags, computedAreaSqKm, adminLevel	Extra fields from the place details add-on.
observedAt	When the record was collected.
error	Populated only on a fetch failure.

Use cases

• Geocoding - batch convert address lists to coordinates for maps, geofencing and spatial analysis.
• Reverse geocoding - turn GPS pings, store coordinates or device locations into readable addresses.
• Address validation and cleanup - normalize and standardize free-text addresses into structured fields with postcode and country code.
• CRM and data enrichment - add coordinates and clean address components to customer, lead and account records.
• Lead list cleanup - deduplicate and standardize prospect addresses before outreach.
• Logistics and routing - geocode delivery and pickup addresses for route planning and territory assignment.
• Real estate and mapping - place listings and points of interest accurately on a map.

Billing

This actor is priced pay per event:

Event	Price	When it is charged
result	$0.008	Once per resolved location. No-match and error rows are never charged.
place_details	$0.008	Once per place, only when the details add-on is enabled and returns data.

The place details add-on is optional and off by default. Both events are charged only on genuine success, never on a failed lookup.

Data source, licensing and rate limits

Location data comes from OpenStreetMap via the Nominatim service. OpenStreetMap data is licensed under the Open Database License (ODbL) and is free to use, including for commercial purposes, provided you credit OpenStreetMap contributors. When you display or redistribute results, include an attribution such as "Data (C) OpenStreetMap contributors, ODbL".

To respect the public usage policy, this actor paces requests to roughly one per second, identifies itself with a descriptive User-Agent, and retries politely on rate limits. Very large batches will therefore take proportionally longer to complete.