API Documentation

Authentication

All API requests require an API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Endpoints

GET/weather/current

Get current weather with confidence scores.

Parameters

  • lat - Latitude (required)
  • lon - Longitude (required)

Example

curl "https://api.confidentweather.com/weather/current?lat=51.5&lon=-0.1" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/weather/confidence

Get detailed confidence analysis for weather conditions.

Parameters

  • lat - Latitude (required)
  • lon - Longitude (required)
GET/forecast

Get 7-day forecast with confidence scores (Pro and above).

Parameters

  • lat - Latitude (required)
  • lon - Longitude (required)
  • days - Number of days (1-7, optional)

Response Format

{
  "overall": {
    "confidence": 78,
    "level": "high"
  },
  "temperature": {
    "value": 12.5,
    "confidence": 85,
    "min": 11.0,
    "max": 14.0
  },
  "precipitation": {
    "probability": 45,
    "confidence": 70
  },
  "weather": {
    "code": 3,
    "description": "Overcast",
    "confidence": 75
  }
}

Confidence Levels

High (70-100)

Ensemble members strongly agree. Trust the forecast.

Medium (40-69)

Some disagreement. Use with caution.

Low (0-39)

High uncertainty. Consider alternatives.

Rate Limits

PlanRequests/DayRequests/Minute
Free1,00060
Pro50,000300
Business500,0001,000
Get Your API Key →