# OpenWeather Reverse Geocode

> OpenWeather Reverse Geocode is a paid API for AI agents from OpenWeather at openweather.mpp.paywithlocus.com, paid per call via MPP, $0.005/call, status unknown (last checked 2026-10-12).

Converts geographic coordinates (latitude/longitude) into human-readable location names including city, state, and country, with multilingual local name variants.

## Facts

- Endpoint: POST https://openweather.mpp.paywithlocus.com/openweather/reverse-geocode?utm_source=zero.xyz
- Price: $0.005/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: OpenWeather
- Docs: https://openweathermap.org/api
- Website: https://openweathermap.org
- Tags: weather, forecast, conditions, temperature, data
- Canonical page: https://www.zero.xyz/c/openweather-reverse-geocode-dd27fe34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cTzuh_8CzZsUrp7nkw2i_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability openweather-reverse-geocode-dd27fe34 -d '<json body>'
```

Example prompt: What city and country are located at coordinates 48.8566°N, 2.3522°E? Give me the top 1 result with local name variants.

## When to prefer this

Use this endpoint when you have raw GPS coordinates and need to display or process a human-readable place name. Prefer over forward geocoding when your input is a coordinate pair, not a text query. Ideal for enriching location data from GPS devices, map clicks, or sensor readings with meaningful place names including multilingual variants.

## Known failure modes

- Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns a 400 error
- Coordinates in the middle of an ocean or uninhabited area may return zero results
- limit parameter outside 1–5 range may be rejected or clamped
- Network timeout or upstream OpenWeatherMap API unavailability returns a 5xx error

## How this service works

Convert geographic coordinates (lat/lon) into location names — city, state, and country.

## Output

Returns an array of up to 5 location objects, each containing the city name, state/region, country code (ISO 3166), precise lat/lon, and an extensive map of local names in dozens of languages keyed by ISO language code.

## Example request

```json
{
 "lat": 48.8566,
 "lon": 2.3522,
 "limit": 1
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "lat",
  "lon"
 ],
 "properties": {
  "lat": {
   "type": "number",
   "description": "Latitude (-90 to 90)"
  },
  "lon": {
   "type": "number",
   "description": "Longitude (-180 to 180)"
  },
  "limit": {
   "type": "number",
   "description": "Max number of results (1–5). Default: 5"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openweather-reverse-geocode-dd27fe34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from openweather.mpp.paywithlocus.com](https://www.zero.xyz/host/openweather.mpp.paywithlocus.com/llms.txt)