# Suverse Places Geocoding Search (Open-Meteo)

> Suverse Places Geocoding Search (Open-Meteo) is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.055/call, status unknown (last checked 2026-09-13).

Search for cities or towns by name and return matching places with coordinates, country code, timezone, elevation, and population.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-places-omgeo-search
- Price: $0.055/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-places-geocoding-search-open-meteo-4df59b19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KrQpOdMPeDYNEjwYoa-Nf

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 suverse-places-geocoding-search-open-meteo-4df59b19 -d '<json body>'
```

Example prompt: Can you look up 'Springfield' and return the top 5 matching cities with their coordinates, country, timezone, and population?

## When to prefer this

Use this endpoint when you need to resolve a human-readable city or town name into structured geographic metadata (coordinates, timezone, country, elevation, population) without requiring an API key. Prefer this over paid geocoding APIs (Google Maps, Mapbox) when cost per call is acceptable and open data accuracy is sufficient. Ideal for bootstrapping location-aware workflows, seeding weather or routing queries, or enriching records with geographic context.

## Known failure modes

- No matching places found for the given name — returns empty results list
- Ambiguous or misspelled name returns unexpected or irrelevant cities
- Missing required 'name' field in body causes a 400/422 validation error
- Upstream Open-Meteo geocoding API unavailability causes a 502/503 error
- Payment not processed via x402 protocol results in 402 Payment Required

## How this service works

Search for a city or town by name and get back matching places with coordinates, country code, timezone, elevation, and population. Pass a name (and optional count), get structured results. Free Open-Meteo geocoding.

## Output

A structured list of matching places, each containing the place name, latitude, longitude, country code, timezone identifier, elevation in meters, and population count. Results are ordered by relevance to the query name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-places-geocoding-search-open-meteo-4df59b19/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)