Your API Key
dk_••••••••••••••••••••••••••••••
⚡ New key — save it now
This is shown once. After closing, only the prefix is visible.
Rate limit: 600 req / min
Access: all /v1/* endpoints
Auth: Bearer <key>
Developer Platform

Build with
Deldown APIs

Privacy-first weather intelligence for your application.

APIs

All available Deldown services

🌤
Available
Weather API
Multi-source ensemble weather forecasting with AI weighting. 7-day forecasts, radar, geocoding, and chat.
Coming Soon
More APIs
Additional Deldown services are in development.

Weather API

Ensemble forecasting from up to 8 sources with AI weighting

🌐
Base URL
https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud
Rate Limit600 req / min per API key
🔑
Authentication required — all /v1/* endpoints require a key. Pass it as Authorization: Bearer dk_... header. Create a free account to get one.
GET /v1/weather

Main forecast endpoint. Fetches data from up to 8 providers, applies AI ensemble weighting and learning adjustments, and returns a unified forecast.

ParameterTypeRequiredDescription
latnumberrequiredLatitude
lonnumberrequiredLongitude
langstringoptionalLanguage for AI summaries. Default: de
curl
curl "https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud/v1/weather?lat=52.52&lon=13.41&lang=de" \ -H "Authorization: Bearer dk_your_api_key"

Returns: bestEstimate, hourly[], daily[], aiSummary, minutelyNowcast

GET/v1/radar

Rain radar data from RainViewer. Returns frame URLs for rendering precipitation overlays. Cached for 5 minutes. No parameters required.

curl
curl "https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud/v1/radar"
GET/v1/geocode

Location search. Resolves a place name to geographic coordinates. Returns up to 8 results.

ParameterTypeRequiredDescription
qstringrequiredPlace name query. 2–80 characters.
curl
curl "https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud/v1/geocode?q=Berlin"

Returns: locations[]{ id, name, lat, lon, timezone }

POST/v1/chat

AI weather chat assistant. Send natural-language questions about weather at a given location. Supports multi-turn conversations.

ParameterTypeRequiredDescription
latnumberrequiredLatitude (query param)
lonnumberrequiredLongitude (query param)
messagestringrequiredUser message. Max 500 chars. (body)
historyarrayoptionalPrior turns [ { role, content } ]. Last 8 used. (body)
curl
curl -X POST "https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud/v1/chat?lat=52.52&lon=13.41" \ -H "Content-Type: application/json" \ -d '{"message": "Soll ich heute einen Schirm mitnehmen?"}'

Returns: { reply: string }

GET/v1/sources

Raw provider responses from all 8 weather sources plus current ensemble weights. Useful for debugging or custom ensemble logic.

ParameterTypeRequiredDescription
latnumberrequiredLatitude
lonnumberrequiredLongitude
curl
curl "https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud/v1/sources?lat=52.52&lon=13.41"

Returns: location, sources[], weights

GET/healthz

Health check. Returns service status and current server time.

curl
curl "https://deldownweather6856e2f4-backend.functions.fnc.fr-par.scw.cloud/healthz"
response
{ "ok": true, "service": "deldown-weather-api", "time": "2026-05-17T12:00:00.000Z" }