Start building

Open-Meteo Geocoding API docs

Open Playground →

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/open-meteo/geocoding
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/open-meteo/geocoding" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "name": "Berlin",
  "count": 5,
  "format": "json",
  "language": "en",
  "countryCode": "DE"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

namestringrequired

Location name or postal code. Append `, ` or `, ` to narrow results.

countinteger

Maximum number of results (1-100). Default 10.

Default: 10

countryCodestring

ISO-3166-1 alpha-2 country code to filter results.

formatstring

Response format. Default `json`.

Default: "json"

Possible values: json, protobuf

languagestring

Two-letter language code for translated names. Default `en`.

Default: "en"

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.