# Meteo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get detailed weather forecasts with temperature, pressure, wind, precipitation, and cloud data for any location using multiple weather models (UM, GFS) from Poland's Institute of Meteorology and Water Management. Search locations and access available forecasts to plan ahead with comprehensive meteorological information.

**Category:** Weather | **Website:** [meteo.pl/](https://meteo.pl/) | **Docs:** [parse.bot/marketplace/d1c937ed-5e93-477a-8858-0933c197a1a8/meteo-pl-api](https://parse.bot/marketplace/d1c937ed-5e93-477a-8858-0933c197a1a8/meteo-pl-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-meteo-pl-api-d1c937ed/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_available_forecasts

Get available forecast models and their latest run timestamps as Unix epoch integers. Returns arrays of timestamps for each model (um4_60, um4_120, gfs). The most recent timestamp in each array is the latest available run. Use to discover valid date values for get_forecast.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-meteo-pl-api-d1c937ed/get_available_forecasts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_forecast

Fetch detailed weather forecast data for a location. Returns a time series of hourly meteorological parameters (temperature, dew point, pressure, wind speed/direction, precipitation, cloud cover, visibility, humidity) aligned by date_time. Either location or both lat and lon must be provided. The model auto-selects um4_60 for Central Europe coordinates or gfs otherwise. UM models cover Central Europe only; requesting them for out-of-range coordinates returns empty data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | integer | No | Unix timestamp of the forecast run. If omitted, uses the latest available run. Valid values from get_available_forecasts. |
| `lat` | number | No | Latitude. Required if location is not provided. |
| `location` | string | No | Location name (city). Coordinates will be resolved via geocoding. Required if lat and lon are not provided. |
| `lon` | number | No | Longitude. Required if location is not provided. |
| `model` | string | No | Forecast model to use. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-meteo-pl-api-d1c937ed/get_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<integer>","lat":"<number>","location":"<string>","lon":"<number>","model":"<string>"}'
```

### search_location

Search for a location by name to get coordinates, display name, and address details. Returns up to 5 matching results from the geocoding service. Each result includes latitude, longitude, display_name, address components, and OpenStreetMap metadata. Use to resolve a city name into coordinates for get_forecast.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | City name or location query (e.g. 'Warsaw', 'Krakow'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-meteo-pl-api-d1c937ed/search_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```