# Meteo — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/meteo/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/meteo/get-available-forecasts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/meteo/get-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/meteo/search-location \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.