# OpenStreetMap API: Get address for coordinates

> 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.

Unofficial. Not affiliated with or endorsed by OpenStreetMap.

- Page: https://fous.com/methods/openstreetmap.org/get-address
- Method: `openstreetmap.org/get_address`, version 1
- Website: openstreetmap.org
- Returns: full address, place name, type, house number, road, neighbourhood, city, state or region, postcode, country, OpenStreetMap link
- 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 |
|---|---|---|---|---|
| `detail` | string | no | `"street"` | Level of place to return, for example street; defaults to address. One of "address", "street", "city". Default "address". |
| `language` | string | no | `"French"` | Preferred language for names and addresses, for example French or fr; defaults to English. Default "English". |
| `latitude` | number | yes | `48.8584` | Latitude in decimal degrees, for example 48.8584. |
| `longitude` | number | yes | `2.2945` | Longitude in decimal degrees, for example 2.2945. |

## Output

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

```json
{
  "detail": "street",
  "language": "French",
  "latitude": 48.8584,
  "longitude": 2.2945
}
```

Its output:

```json
{
  "city": "Paris",
  "road": "Avenue Gustave Eiffel",
  "type": "Pedestrian street",
  "country": "France",
  "postcode": "75007",
  "place_name": "Avenue Gustave Eiffel",
  "full_address": "Avenue Gustave Eiffel, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, Île-de-France, France métropolitaine, 75007, France",
  "house_number": null,
  "neighbourhood": "Quartier du Gros-Caillou",
  "osm_object_id": 15920725,
  "osm_object_type": "way",
  "state_or_region": "Île-de-France",
  "openstreetmap_link": "https://www.openstreetmap.org/way/15920725"
}
```

## 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_address","input":{"detail":"street","language":"French","latitude":48.8584,"longitude":2.2945}}'
```

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's the street address at 40.7484, -73.9857?
- Using OpenStreetMap, tell me which city the coordinates -33.8688, 151.2093 fall in.
- I have a GPS fix of 35.6595, 139.7005 from a photo. What street is that on? Give me the names in Japanese.
- Reverse geocode 51.5007, -0.1246 to a full address with postcode, and include the OpenStreetMap link.
- My delivery driver sent me 52.5200, 13.4050. What's the neighbourhood and house number there? German names please.

## Input schema

```json
{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "detail": {
      "enum": [
        "address",
        "street",
        "city"
      ],
      "type": "string",
      "default": "address",
      "description": "Level of place to return, for example street; defaults to address."
    },
    "language": {
      "type": "string",
      "default": "English",
      "description": "Preferred language for names and addresses, for example French or fr; defaults to English."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude in decimal degrees, for example 48.8584."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude in decimal degrees, for example 2.2945."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "full_address",
    "place_name",
    "type",
    "house_number",
    "road",
    "neighbourhood",
    "city",
    "state_or_region",
    "postcode",
    "country",
    "openstreetmap_link",
    "osm_object_type",
    "osm_object_id"
  ],
  "properties": {
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "City or town."
    },
    "road": {
      "type": [
        "string",
        "null"
      ],
      "description": "Road or street name."
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type of mapped place in words."
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Country."
    },
    "postcode": {
      "type": [
        "string",
        "null"
      ],
      "description": "Postal code."
    },
    "place_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Name of the mapped place, when available."
    },
    "full_address": {
      "type": "string",
      "description": "The readable address."
    },
    "house_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Building or house number."
    },
    "neighbourhood": {
      "type": [
        "string",
        "null"
      ],
      "description": "Neighbourhood or quarter."
    },
    "osm_object_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "OpenStreetMap object ID."
    },
    "osm_object_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "OpenStreetMap object type."
    },
    "state_or_region": {
      "type": [
        "string",
        "null"
      ],
      "description": "State or region."
    },
    "openstreetmap_link": {
      "type": "string",
      "description": "Link to the place on OpenStreetMap."
    }
  },
  "additionalProperties": false
}
```

## See more

- [OpenStreetMap API: Get coordinates for an address](https://fous.com/methods/openstreetmap.org/get-coordinates.md): Finds map coordinates and address details for an address or place on OpenStreetMap, optionally restricted to a country.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Open Charge Map API: Search EV chargers near a place](https://fous.com/methods/openchargemap.org/search-chargers.md): Finds Open Charge Map charging locations near an address, city, or postcode, nearest first.
- [All OpenStreetMap methods](https://fous.com/methods/openstreetmap.org.md)