Pohoda API
Climate facts for trip planning, from pohoda.app. Read-only, JSON, free for light use.
Ask 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. Every endpoint takes a latitude and longitude in decimal degrees.
curl "https://api.pohoda.app/v1/point?lat=38.72&lon=-9.14&trip=beach"Endpoints
| Request | Answer |
|---|---|
GET /v1/point | Normal climate in 26 fortnights and a 0 to 100 match score per fortnight for each trip type, with the best fortnights. Climate normals, not a forecast. |
GET /v1/outlook | Seasonal outlook for the next 3 months: chances of a colder, normal or warmer (drier, normal or wetter) month than usual, with a confidence level. |
GET /v1/region | How busy the region is through the year, the sweet spot (good weather in a quiet period) and tourism density. |
POST /mcp | The same three answers as tools for AI agents (Model Context Protocol). |
GET /v1/health | Liveness check. |
Parameters
| Name | Meaning |
|---|---|
lat | Latitude, -90 to 90. Required. Data covers about -60 to 75. |
lon | Longitude, -180 to 180. Required. |
trip | beach, city, outdoor or snow. Optional on /v1/point and /v1/region; omit it for all four. |
Unknown or repeated parameters are refused with a 400, so a typo never gives you an answer to a different question.
Reading the answers
/v1/point
The year is cut into 26 fortnights (fortnights lists their dates). Each entry in climate has a unit and 26 values in the same order. trip_scores gives 26 scores per trip type, the peak fortnight and the good_periods (runs of fortnights scoring at least 60, joined across the turn of the year). When a place never suits a trip type, never_suitable names the requirement that rules it out. A point on water close to shore is moved to the nearest land cell and cell.snapped_to_land_km says how far.
/v1/outlook
prob_below, prob_normal and prob_above are the chances in percent of a month in the lower, middle or upper third of past years. confidence reflects how well the forecast has verified at that place in the past: use the outlook only where it says moderate or high. The grid is 1 degree and the answer is the nearest cell.
/v1/region
crowd.index is 1.0 for an average fortnight in that region and 2.0 for twice as busy. It compares dates within one region and must not be compared between regions. quality says how strong the underlying figure is. sweet_spot is the quietest fortnight among those whose weather scores at least 60 for the trip type. Coverage: Europe, Turkey, Japan, Canada, New Zealand, Brazil and US national parks.
Access and limits
| Level | How | Limit |
|---|---|---|
| Open | No key. | 60 requests a minute per address |
| Website widget | A publishable key (pk_...) that works only from your site's address. | 600 a minute per key |
| Partner | A secret key (sk_...) for server use. | 600 a minute per key |
Send a key as X-API-Key: ... or Authorization: Bearer .... Keys are never accepted in the URL. Over the limit you get a 429 with Retry-After. Answers are cacheable for a day (the outlook for an hour). What the open level includes may change; keyed access is the stable route. Keys are issued on request: info@pohoda.app.
Errors
{ "error": { "code": "invalid_parameter", "message": "lat must be between -90 and 90", "param": "lat" } }| Status | Code |
|---|---|
| 400 | invalid_parameter |
| 401 / 403 | invalid_key, origin_not_allowed |
| 404 | out_of_coverage, no_data, not_found |
| 429 | rate_limited |
| 502 | upstream_unavailable: try again shortly |
For AI agents
MCP endpoint: https://api.pohoda.app/mcp (Streamable HTTP, stateless, protocol 2026-07-28 and the older handshake versions). Tools: get_best_time_to_visit, get_seasonal_outlook, get_crowd_seasonality. A plain-text summary is at /llms.txt and the machine-readable description at /openapi.json.
Credit and sources
Show "pohoda.app" and "Contains modified Copernicus Climate Change Service information" where you use the data. Each response carries the exact attribution lines for what it contains. Climate: ERA5-Land. Sea temperature: NOAA OISST. Outlook: Copernicus C3S seasonal forecasts, five models. Crowds: Eurostat, national statistical offices and the US National Park Service. Details: method and sources and licences.
The 16-day weather forecast shown on pohoda.app is not part of this API.