# Open-Meteo Geocoding API

> Look up places by name and get coordinates, country, timezone, population and elevation for use with the weather APIs.

Source: https://www.sandbase.ai/apis/open-meteo/geocoding
API reference: https://www.sandbase.ai/apis/open-meteo/geocoding/docs

## Facts

- Provider: Open-Meteo
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/open-meteo/geocoding`
- Price: $0.0001 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, open meteo, weather
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/open-meteo/geocoding` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `name` | string | yes |  |
| `count` | integer | no |  |
| `countryCode` | string | no |  |
| `format` | string | no | json, protobuf |
| `language` | string | no |  |

## FAQ

### How do I use the Open-Meteo Geocoding API?

Send a POST request to https://api.sandbase.ai/v1/api/open-meteo/geocoding with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Open-Meteo Geocoding API cost?

$0.0001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the Open-Meteo Geocoding API accept?

Required: name (string). Optional: count (integer), countryCode (string), format (one of json, protobuf) and language (string). The Parameters table and the Playground on this page list every field.

### What does the Open-Meteo Geocoding API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Open-Meteo developer account or API key?

No. Open-Meteo Geocoding runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Open-Meteo API access separately.

## README

### Open-Meteo Geocoding API

Look up places by name and get coordinates, country, timezone, population and elevation for use with the weather APIs.

The result is returned in `outputs[0].data` as the official Open-Meteo API response, unchanged.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/open-meteo/geocoding" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Berlin"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `count` | integer | No | Maximum number of results (1-100). Default 10. |
| `countryCode` | string | No | ISO-3166-1 alpha-2 country code to filter results. |
| `format` | string | No | Response format. Default `json`. |
| `language` | string | No | Two-letter language code for translated names. Default `en`. |
| `name` | string | Yes | Location name or postal code. Append `, ` or `, ` to narrow results. |

#### Pricing

Flat price per call. Failed calls are not charged.