# SiteCheck Shop & Social – AEMET Spain Weather Station Observations

> SiteCheck Shop & Social – AEMET Spain Weather Station Observations is a paid API for AI agents from api.shopsocial-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches the latest hourly meteorological observations from Spanish AEMET OpenData weather stations, returning temperature, humidity, wind, pressure, precipitation and more for all stations or a specific station ID.

## Facts

- Endpoint: GET https://api.shopsocial-api.workers.dev/api/social/aemet-spain-weather?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-shop-social-aemet-spain-weather-station-observations-0f7d9c1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rDjbOXO8z-VdVh_zg2WlP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-shop-social-aemet-spain-weather-station-observations-0f7d9c1e
```

Example prompt: Can you pull the latest official AEMET weather observations for Madrid Retiro station (ID 3195) — I need temperature, humidity, wind speed, and pressure readings?

## When to prefer this

Choose this endpoint when you need official, authoritative Spanish weather observations directly from AEMET OpenData — particularly for real-time hourly readings (temperature, wind, pressure, precipitation) for one or all Spanish meteorological stations. It is preferable over general weather APIs when Spain-specific official government data is required, when you need the raw idema station identifiers, or when data provenance from Spain's national meteorological agency matters.

## Known failure modes

- Invalid or unknown station ID returns empty observations array or an error from AEMET
- Missing or expired AEMET OpenData API key results in authorization failure
- AEMET OpenData service downtime causes upstream fetch failure
- Limit parameter out of range (outside 1–500) may return a validation error
- Station has no recent data if it is offline or under maintenance

## How this service works

Spanish weather station observations from AEMET OpenData (official): latest hourly readings (temperature, humidity, wind, pressure, precipitation…) for all stations or one station ID (idema, e.g. 3195 Madrid Retiro), as published by AEMET. Requires the operator's free AEMET OpenData key.

## Output

Returns a JSON object with a count of observations, the source AEMET API URL, the queried station ID, a timestamp, and an array of observation records each containing: station ID (idema), station name (ubi), coordinates (lat, lon), altitude (alt), observation datetime (fint), temperature (ta), max/min temperature (tamax, tamin), dew point (tpr), relative humidity (hr), wind direction (dv), wind speed (vv), max wind gust direction (dmax) and speed (vmax), wind direction standard deviation (stddv), wind speed standard deviation (stdvv), station pressure (pres), sea-level pressure (pres_nmar), and precipitation (prec).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Rows, 1 to 500 (default 100)"
      },
      "station": {
       "type": "string",
       "description": "AEMET station ID (idema), e.g. 3195; empty = all stations"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 12,
  "source": "https://opendata.aemet.es/opendata/api/observacion/convencional/datos/estacion/3195",
  "station": "3195",
  "checkedAt": "2026-10-23T09:37:49.769Z",
  "observations": [
   {
    "dv": 229,
    "hr": 65,
    "ta": 13.2,
    "vv": 2.2,
    "alt": 667,
    "lat": 40.411389,
    "lon": -3.677778,
    "tpr": 6.7,
    "ubi": "MADRID RETIRO",
    "dmax": 206,
    "fint": "2026-10-22T22:00:00+0000",
    "prec": 0,
    "pres": 946,
    "vmax": 4.5,
    "idema": "3195",
    "stddv": 17,
    "stdvv": 0.5,
    "tamax": 13.8,
    "tamin": 13.2,
    "pres_nmar": 1023.4
   },
   {
    "dv": 215,
    "hr": 70,
    "ta": 12.4,
    "vv": 1.9,
    "alt": 667,
    "lat": 40.411389,
    "lon": -3.677778,
    "tpr": 7.1,
    "ubi": "MADRID RETIRO",
    "dmax": 223,
    "fint": "2026-10-22T23:00:00+0000",
    "prec": 0,
    "pres": 945.8,
    "vmax": 3.4,
    "idema": "3195",
    "stddv": 13,
    "stdvv": 0.6,
    "tamax": 13.2,
    "tamin": 12.4,
    "pres_nmar": 1023.4
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-shop-social-aemet-spain-weather-station-observations-0f7d9c1e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shopsocial-api.workers.dev](https://www.zero.xyz/host/api.shopsocial-api.workers.dev/llms.txt)