API

Build with Ouranos API

Integrate powerful stargazing forecasts, weather data, and sky analysis into your applications. Simple, reliable, and built for developers.

View Documentation
https://api.ouranos-app.com/

What You Can Build

Weather Forecasts

Get precise stargazing-optimized weather forecasts with cloud cover, seeing conditions, and atmospheric data.

  • • Hourly forecasts up to 7 days
  • • Cloud cover & seeing index
  • • Temperature, humidity, wind

Astronomy Recommendations

Get daily recommendations on the best times for stargazing based on weather conditions.

  • • 1-day and 7-day forecasts
  • • Observable conditions
  • • Optimal observation windows

Sky Quality Metrics

Access advanced astronomical metrics including seeing index and sky quality index.

  • • Seeing index (1-5 scale)
  • • Sky quality index (0-5 scale)
  • • Atmospheric clarity data

How It Works

1

Get Your API Key

Request access and receive your unique API key. Each key is tied to a single application for security.

2

Make Simple Requests

Use simple GET requests with your API key as a query parameter. No complex authentication needed.

https://api.ouranos-app.com/recommendation_7days?apikey=YOUR_KEY&latitude=48.8566&longitude=2.3522
3

Get Rich Data

Receive comprehensive JSON responses with weather forecasts, astronomical conditions, and recommendations.

Key Features

Global Coverage

Get forecasts for any location worldwide with precise latitude and longitude coordinates.

Multiple Timeframes

Access hourly data for 3 or 7 days, plus daily recommendations for optimal stargazing windows.

Simple Integration

RESTful API with straightforward JSON responses. Works with any programming language.

Secure & Reliable

Enterprise-grade security with API key authentication and rate limiting based on your plan.

Astronomy-Optimized

Data specifically designed for stargazers with seeing index, sky quality, and cloud cover metrics.

Flexible Units

Customize temperature (Celsius/Fahrenheit) and wind speed units (kmh/mph/ms/kn) to your needs.

Perfect For

Mobile Apps

Build stargazing apps that help users plan their stargazing sessions with accurate forecasts.

Web Platforms

Integrate weather and sky conditions into your website or web application.

Developer Tools

Create tools and services for the stargazing community with reliable data.