Euskalmet API

Weather / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

Euskalmet is the official meteorological API for the Basque Country in Spain, providing weather observations, forecasts, and climate records for the region. It is maintained by the Basque Government and offers data in open formats ideal for regional apps and research. An API key is required and can be requested through the Euskadi open data portal.

💡

Beginner Tip

Include your API key as a query parameter or header as documented in the portal. Start with the current observations endpoint to confirm connectivity before querying forecasts.

Available Data

country name and code
population
capital city
region and subregion
flag image URL
Response fields: euskadi eus

Example Response

JSON Response
{
  "name": "Japan",
  "capital": "Tokyo",
  "population": 125800000,
  "region": "Asia",
  "languages": [
    "Japanese"
  ],
  "flag": "https://flagcdn.com/jp.svg",
  "currencies": [
    {
      "code": "JPY",
      "name": "Japanese yen"
    }
  ]
}

Field Reference

stationId Unique identifier of the weather observation station.
temperature Air temperature recorded at the station in degrees Celsius.
precipitation Accumulated precipitation in millimetres for the observation period.
windSpeed Mean wind speed in km/h.
humidity Relative humidity percentage at the time of observation.

Implementation Example

const url = "https://opendata.euskadi.eus/api-euskalmet/-/api-de-euskalmet/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

403 Forbidden API key is missing, expired, or not yet approved by the portal.
Register on opendata.euskadi.eus, request API access, and use the issued key in every request.
No data returned for station The requested weather station ID does not exist or has no recent observations.
Fetch the list of available stations first and use a valid station code in your query.
Unexpected XML response Some endpoints return XML by default instead of JSON.
Add the Accept: application/json header or check the endpoint documentation for the correct format parameter.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 2/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Weather
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →