Skip to main content

Documentation Index

Fetch the complete documentation index at: https://arnaud.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Current Weather Data API lets you retrieve real-time weather data for a specific location. You can use it to:
  • Get temperature, humidity, pressure, and wind data
  • Retrieve current weather conditions (for example, rain or clear sky)
  • Access optional data such as precipitation or wind gusts when available
The API aggregates data from multiple sources, including weather models, satellites, radars, and weather stations. Responses are returned in JSON by default.

​
Base URL

All endpoints use the following base URL: 
https://api.openweathermap.org/data/2.5

​
Request basics

A typical request requires:
  • A location (lat and lon are recommended)
  • Your API key (appid)
  • Optional parameters such as units
Example: 
curl "https://api.openweathermap.org/data/2.5/weather?lat=48.85&lon=2.35&units=metric&appid=YOUR_API_KEY"
By default, temperature is returned in Kelvin. Use units=metric or units=imperial to control the output.

​
Response behavior

The response structure is mostly stable, but some fields are optional:
  • rain and snow only appear when relevant
  • wind.gust is not always present
Always handle missing fields in your integration.