Accueil

API La Bonne Météo

Une API météo publique, 100% gratuite, sans clé et sans inscription. Prévisions multi-modèles, conditions temps réel, qualité de l'air et géocodage, en JSON, avec CORS ouvert.

Sans clé d'API

Aucun compte, aucun token. Un simple GET suffit.

60 req / minute

Et 2 000 requêtes / 24 h par adresse IP, pour éviter le spam.

RGPD

Seule une empreinte anonyme de l'IP est conservée, jamais l'IP en clair.

Statistiques en direct

Appels total
—
Dernières 24 h
—
Clients uniques (7 j)
—
Temps de réponse
—

Démarrage rapide

curl "https://labonnemeteo.com/api/public/v1/forecast?city=Dijon&days=3"
const res = await fetch(
  "https://labonnemeteo.com/api/public/v1/current?lat=47.3220&lon=5.0415"
);
const { data } = await res.json();
console.log(data.current.temperature, data.current.weather_label);

Toutes les réponses suivent la même enveloppe : { ok, source, api_version, generated_at, data }.

Points d'entrée

GET/api/public/v1/forecast
Prévisions

Prévisions journalières (jusqu'à 10 jours) et horaires, issues d'une médiane pondérée multi-modèles (modèles régionaux kilométriques en Europe + modèles globaux).

  • cityNom de ville, ex. `Dijon`. Alternative à lat/lon.
  • latLatitude (-90 à 90).
  • lonLongitude (-180 à 180).
  • daysNombre de jours, 1 à 10 (défaut 7).
  • hourly`1` pour inclure le détail heure par heure.
GET https://labonnemeteo.com/api/public/v1/forecast?city=Dijon&days=5&hourly=1
GET/api/public/v1/current
Conditions actuelles

Température ressentie, vent, rafales, pression, nébulosité et code météo en temps réel.

  • cityNom de ville. Alternative à lat/lon.
  • latLatitude.
  • lonLongitude.
GET https://labonnemeteo.com/api/public/v1/current?lat=47.3220&lon=5.0415
GET/api/public/v1/air-quality
Qualité de l'air & pollens

Indice européen AQI, particules fines, NO₂, O₃, SO₂, CO et six familles de pollens.

  • cityNom de ville. Alternative à lat/lon.
  • latLatitude.
  • lonLongitude.
GET https://labonnemeteo.com/api/public/v1/air-quality?city=Paris
GET/api/public/v1/geocode
Recherche de lieux

Convertit un nom de ville en coordonnées (nom, région, pays, latitude, longitude).

  • q(requis) Texte recherché, 2 caractères minimum.
  • limitNombre de résultats, 1 à 10 (défaut 5).
GET https://labonnemeteo.com/api/public/v1/geocode?q=Talant&limit=3
GET/api/public/v1/stats
Statistiques d'usage

Volume d'appels, répartition par endpoint, clients uniques et temps de réponse moyen.

GET https://labonnemeteo.com/api/public/v1/stats

Limites d'usage

  • 60 requêtes par minute et 2 000 par 24 h, par adresse IP.
  • Chaque réponse renvoie les en-têtes x-ratelimit-remaining et x-ratelimit-remaining-day.
  • En cas de dépassement : code HTTP 429 avec un en-tête retry-after.
  • Erreurs : 400 paramètres invalides, 404 lieu introuvable, 502 source amont indisponible.
  • Réponses mises en cache 2 minutes, CORS ouvert à tous les domaines.

Attribution

L'API est libre d'usage, y compris commercial. Merci de mentionner « Données météo by La Bonne Météo » avec un lien vers labonnemeteo.com. Aucune donnée personnelle n'est collectée : nous conservons uniquement une empreinte anonymisée de l'IP pour appliquer le quota et publier ces statistiques.