# Pohoda API

> Climate facts for trip planning, from pohoda.app: what the weather is normally like at any place on land through the year, how well it suits a beach, city, outdoor or snow trip, what the seasonal forecast says about the coming months, and when a region is busy or quiet.

Free to read, no key needed for light use. All endpoints are GET, return JSON, and take a latitude and longitude in decimal degrees. Look up the coordinates of a place first.

- [GET /v1/point?lat=&lon=&trip=](https://api.pohoda.app/v1/point?lat=38.72&lon=-9.14): normal climate in 26 fortnights (temperature, rain, sunshine, wind, humidity, snow, sea temperature) and a 0 to 100 match score per fortnight for each trip type, with the peak fortnight and the good periods. Use for "best time to visit X" and "weather in X in May". These are 30-year climate normals, not a forecast.
- [GET /v1/outlook?lat=&lon=](https://api.pohoda.app/v1/outlook?lat=38.72&lon=-9.14): chances of a colder, normal or warmer (drier, normal or wetter) month than usual for the next 3 months, with a confidence level. Rely only on months with moderate or high confidence.
- [GET /v1/region?lat=&lon=&trip=](https://api.pohoda.app/v1/region?lat=43.77&lon=11.25): how busy the region is through the year relative to its own average, the sweet spot (good weather in a quiet period), and tourism density. Crowd figures compare dates within one region; never compare them between regions.
- [POST /mcp](https://api.pohoda.app/mcp): the same three answers as MCP tools (Streamable HTTP, stateless).
- [OpenAPI description](https://api.pohoda.app/openapi.json)
- [How the numbers are made](https://pohoda.app/method.html)
- [Data sources and licences](https://pohoda.app/sources.html)

## Using the data

Credit "pohoda.app" and "Contains modified Copernicus Climate Change Service information". Each response carries the exact attribution lines for what it contains.

Trip parameter values: beach, city, outdoor, snow. Omit it to get all four.

Limits: 60 requests a minute per address without a key. Answers are cached for a day (the outlook for an hour), so repeat calls are cheap.