API Documentation
Build powerful weather applications with our comprehensive REST API
Quick Start
Get started with the Rutuganit API in minutes. No authentication required for basic requests.
https://api.rutuganit.com/weather/current?latitude=51.5074&longitude=-0.1278Base URL
https://api.rutuganit.comEndpoints
/api/weather/currentGet current weather data for a specific location
Parameters
latitudenumberrequiredLatitude of the location
longitudenumberrequiredLongitude of the location
Request
GET /api/weather/current?latitude=51.5074&longitude=-0.1278Response
{
"temperature": 15.2,
"weather_code": 2,
"wind_speed": 12.5,
"humidity": 65,
"pressure": 1013
}/api/weather/forecastGet weather forecast for the next 7 days
Parameters
latitudenumberrequiredLatitude of the location
longitudenumberrequiredLongitude of the location
daysnumberNumber of days (1-7, default: 7)
Request
GET /api/weather/forecast?latitude=51.5074&longitude=-0.1278&days=7Response
{
"daily": {
"time": [
"2025-10-30",
"2025-10-31"
],
"temperature_max": [
16,
14
],
"temperature_min": [
10,
8
],
"weather_code": [
2,
3
]
}
}/api/satellite/imageryGet satellite imagery data for a location
Parameters
latitudenumberrequiredLatitude of the location
longitudenumberrequiredLongitude of the location
layerstringLayer type: clouds, temperature, precipitation
Request
GET /api/satellite/imagery?latitude=51.5074&longitude=-0.1278&layer=cloudsResponse
{
"layer": "clouds",
"coverage": 65,
"timestamp": "2025-10-30T12:00:00Z"
}Code Examples
JavaScript
const response = await fetch(
'https://api.rutuganit.com/weather/current?latitude=51.5074&longitude=-0.1278'
);
const data = await response.json();
console.log(data.temperature);Python
import requests
response = requests.get(
'https://api.rutuganit.com/weather/current',
params={'latitude': 51.5074, 'longitude': -0.1278}
)
data = response.json()
print(data['temperature'])cURL
curl -X GET \
'https://api.rutuganit.com/weather/current?latitude=51.5074&longitude=-0.1278' \
-H 'Accept: application/json'HTTP Status Codes
Success - Request completed successfully
Bad Request - Invalid parameters provided
Unauthorized - Authentication required
Not Found - Endpoint does not exist
Too Many Requests - Rate limit exceeded
Server Error - Internal server error
Rate Limiting
API requests are rate limited to ensure fair usage and service stability.
Free Tier
1,000 requests/day
Pro Tier
100,000 requests/day
Error Handling
{
"error": {
"code": "INVALID_COORDINATES",
"message": "Latitude must be between -90 and 90",
"status": 400
}
}