# OpenStreetMap API: Get coordinates for an address

> Finds map coordinates and address details for an address or place on OpenStreetMap, optionally restricted to a country.

Unofficial. Not affiliated with or endorsed by OpenStreetMap.

- Page: https://fous.com/methods/openstreetmap.org/get-coordinates
- Method: `openstreetmap.org/get_coordinates`, version 1
- Website: openstreetmap.org
- Returns: coordinates, full address, place type, address parts, OpenStreetMap link, bounding box
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `address` | string | yes | `"10 Downing Street, London"` | Street address, place, or landmark to locate; for example, 10 Downing Street, London. |
| `country` | string | no |  | Country name or two-letter country code to restrict the search; for example, France or FR. Leave blank for any country. Default "". |
| `max_results` | integer | no |  | Maximum matches to return, from 1 to 10; for example, 3. Default 1. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "address": "10 Downing Street, London"
}
```

Its output:

```json
{
  "matches": [
    {
      "city": "City of Westminster",
      "road": "Downing Street",
      "type": "government",
      "country": "United Kingdom",
      "latitude": 51.5034878,
      "postcode": "SW1A 2AA",
      "longitude": -0.1276965,
      "bounding_box": {
        "east": -0.1273088,
        "west": -0.1277991,
        "north": 51.5036913,
        "south": 51.5033074
      },
      "full_address": "10 Downing Street, 10, Downing Street, Westminster, Covent Garden, City of Westminster, Greater London, England, SW1A 2AA, United Kingdom",
      "house_number": "10",
      "osm_object_id": 1879842,
      "osm_object_type": "relation",
      "state_or_region": "England",
      "openstreetmap_url": "https://www.openstreetmap.org/relation/1879842"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"openstreetmap.org/get_coordinates","input":{"address":"10 Downing Street, London"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the latitude and longitude of 10 Downing Street, London?
- Find the map coordinates for the Eiffel Tower and show me its full address details, limited to France.
- I need the bounding box and place type for Lake Titicaca, up to 3 matches.
- Where exactly is 221B Baker Street located? Give me coordinates and address parts.
- Locate the Sydney Opera House in AU and give me an OpenStreetMap link for it.

## Input schema

```json
{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "Street address, place, or landmark to locate; for example, 10 Downing Street, London."
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Country name or two-letter country code to restrict the search; for example, France or FR. Leave blank for any country."
    },
    "max_results": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum matches to return, from 1 to 10; for example, 3."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "matches"
  ],
  "properties": {
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "full_address",
          "latitude",
          "longitude",
          "type",
          "house_number",
          "road",
          "city",
          "state_or_region",
          "postcode",
          "country",
          "openstreetmap_url",
          "osm_object_type",
          "osm_object_id",
          "bounding_box"
        ],
        "properties": {
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "City or town, when available."
          },
          "road": {
            "type": [
              "string",
              "null"
            ],
            "description": "Street or road, when available."
          },
          "type": {
            "type": "string",
            "description": "Kind of place in words."
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Country name, when available."
          },
          "latitude": {
            "type": "number",
            "description": "Latitude in decimal degrees."
          },
          "postcode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Postal code, when available."
          },
          "longitude": {
            "type": "number",
            "description": "Longitude in decimal degrees."
          },
          "bounding_box": {
            "type": [
              "object",
              "null"
            ],
            "required": [
              "south",
              "north",
              "west",
              "east"
            ],
            "properties": {
              "east": {
                "type": "number"
              },
              "west": {
                "type": "number"
              },
              "north": {
                "type": "number"
              },
              "south": {
                "type": "number"
              }
            },
            "description": "Bounding box in decimal degrees, when available.",
            "additionalProperties": false
          },
          "full_address": {
            "type": "string",
            "description": "Full formatted address."
          },
          "house_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "House number, when available."
          },
          "osm_object_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "OpenStreetMap object ID, when available."
          },
          "osm_object_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "OpenStreetMap object kind (node, way, or relation), when available."
          },
          "state_or_region": {
            "type": [
              "string",
              "null"
            ],
            "description": "State or region, when available."
          },
          "openstreetmap_url": {
            "type": "string",
            "description": "Link to the place on OpenStreetMap."
          }
        },
        "additionalProperties": false
      },
      "description": "Matching locations, best first."
    }
  },
  "additionalProperties": false
}
```

## See more

- [OpenStreetMap API: Get address for coordinates](https://fous.com/methods/openstreetmap.org/get-address.md): Turns map coordinates into a readable address with OpenStreetMap Nominatim, at address, street or city detail, with the address parts and an OpenStreetMap link. Results reflect the nearest mapped feature.
- [OpenStreetMap API: Search places](https://fous.com/methods/openstreetmap.org/search-places.md): Finds named places or kinds of places in a city or area, in search order, using OpenStreetMap Nominatim. Results may be fewer than requested. Data © OpenStreetMap contributors (ODbL).
- [Google API: Get place](https://fous.com/methods/google.com/get-place.md): Looks up a public Google Maps place by name and location and returns its profile: address, rating, hours, phone, website and photos.
- [Walk Score API: Get Walk Score](https://fous.com/methods/walkscore.com/get-walk-score.md): Gets the Walk, Transit and Bike Scores and neighborhood details for a street address. Unpublished scores are null; unresolved or mismatched addresses are not found.
- [Zippopotam.us API: Get postal code](https://fous.com/methods/zippopotam.us/get-postal-code.md): Looks up the places, regions and coordinates for a postal code in a supported country on Zippopotam.us.
- [U.S. Census Bureau API: Get address details](https://fous.com/methods/census.gov/get-address-details.md): Matches a US street address and returns its city or place, county, state, ZIP code, census tract, congressional and state legislative districts, coordinates and FIPS codes. Districts follow the Census Geocoder's current geography vintage and may differ from sitting representation.
- [Zippopotam.us API: Search postal codes](https://fous.com/methods/zippopotam.us/search-postal-codes.md): Finds postal codes, place names and coordinates for a town and state or region in a country covered by Zippopotam.us.
- [Postcodes.io API: Get postcode details](https://fous.com/methods/postcodes.io/get-postcode.md): Looks up a UK postcode on Postcodes.io, including its location, administrative areas and whether it is still in use. Retired postcodes return location and retirement year only.
- [All OpenStreetMap methods](https://fous.com/methods/openstreetmap.org.md)
