Météo-France Weather — Official Public APIs

Official French weather data from Météo-France's public APIs: real-time station observations, the official Vigilance alert bulletin, historical climatology series, and seasonal forest fire danger levels.

What it does

Four datasets, selectable via dataTypes:

• observations — real-time readings from 2,000+ French stations (métropole + outre-mer), 6-minute step: temperature, dew point, humidity, wind (speed/gusts/direction), precipitation, pressure, visibility, soil temperatures. Units normalized to °C, km/h, hPa, mm.
• alerts — the official Vigilance bulletin per department, for J and J+1: max colour per department, per-phenomenon colours (Vent, Pluie-inondation, Orages, Crues, Neige-verglas, Canicule, Grand froid, Avalanches, Vagues-submersion) with full timeline.
• climatologie — historical series per station, ordered on demand from Météo-France archives: daily, hourly, 6-min, 10-day or monthly step, CSV parsing included.
• forets — forest fire danger levels per department (J+1 / J+2). Seasonal feed: published during the forest fire campaign (~June–October); off-season the API returns no data and the actor logs an explicit note instead of failing.

Input example

{
  "dataTypes": ["observations", "alerts"],
  "departments": ["75"],
  "maxStations": 10
}

Climatology over a date range:

{
  "dataTypes": ["climatologie"],
  "stations": ["75114001"],
  "climateStartDate": "2026-10-06",
  "climateEndDate": "2026-10-12",
  "climatePeriod": "quotidienne"
}

Main fields: dataTypes, stations (8-digit IDs, e.g. 75114001 = Paris-Montsouris), departments (e.g. ["75"], ["2A"]), maxStations, climateStartDate, climateEndDate, climatePeriod, maxRecords.

Output example (observation, Paris-Montsouris)

{
  "dataset": "observations",
  "station_id": "75114001",
  "station_name": "PARIS-MONTSOURIS",
  "latitude": 48.821667,
  "longitude": 2.337833,
  "altitude_m": 75,
  "reference_time": "2026-10-13T08:57:05Z",
  "validity_time": "2026-10-13T08:48:00Z",
  "temperature_c": 19.2,
  "dewpoint_c": 16.1,
  "humidity_pct": 82,
  "wind_dir_deg": 270,
  "wind_speed_kmh": 11.2,
  "wind_gust_10min_kmh": 23.0,
  "precip_mm": 0.0,
  "pressure_hpa": 1013.4,
  "sea_level_pressure_hpa": 1022.6,
  "visibility_m": 20000
}

Output example (Vigilance alert):

{
  "dataset": "vigilance",
  "domain_id": "75",
  "echeance": "J",
  "begin_validity_time": "2026-10-13T04:00:00Z",
  "end_validity_time": "2026-10-13T22:00:00Z",
  "max_color_id": 1,
  "max_color": "vert",
  "phenomena": [
    {
      "phenomenon_id": 1,
      "phenomenon": "Vent",
      "max_color_id": 1,
      "max_color": "vert",
      "timeline": [{ "begin_time": "...", "end_time": "...", "color": "vert" }]
    }
  ]
}

Data source & authentication

• Source: Météo-France public APIs — https://public-api.meteofrance.fr (official French national weather service).
• Requires a free API key: create it at portail-api.meteofrance.fr and subscribe to the public APIs (DonneesPubliquesObservation, DonneesPubliquesVigilance, DonneesPubliquesClimatologie, DonneesPubliquesMeteoForets).
• The actor sends the key in the apikey HTTP header (Météo-France's custom scheme, not Bearer). Set it as the METEOFRANCE_API_KEY environment variable / Apify secret — never in code.

Notes

• Vigilance colour codes: 1 = vert (green), 2 = jaune (yellow), 3 = orange, 4 = rouge (red).
• Coastal departments may carry an extra sub-zone domain (e.g. 7510); department filters include it automatically.
• Quotas: the free tier allows 50–100 requests/minute per API; the actor caps stations per run (maxStations) to stay well within limits.
• Forest fire feed is seasonal; expect zero forets records outside the campaign.