Weather Forecast Models

Base URL

The base URL for the API is:

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

Authentication

This API requires an API key to access. You must pass your API key as a query parameter:

apikey=<your-api-key>

Example

https://api.ouranos-app.com/recommendation_7days?apikey=<your_api_key> &latitude=47&longitude=1.5

Endpoints

/recommendation_1day , /recommendation_7days , /today

This endpoint provides astronomy recommendations based on the weather conditions, with access varying depending on the user's subscription plan.

Query Parameters:

Parameter Description Type Default Value Possible Values Examples
latitude Geographical latitude for the requested location. float 47 N/A &latitude=48.8566
longitude Geographical longitude for the requested location. float -1.5 N/A &longitude=2.3522
language Language of the recommendation. string 'en' en, fr, es, etc. (ref: https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) &language=fr
timezone Time zone for temporal data. string or null null auto or standard time zone names (e.g., Europe/Paris) &timezone=Europe/Paris

Response

Returns recommendation data including:

Variable Description Unit
latitude Geographical latitude of the location N/A
longitude Geographical longitude of the location N/A
timezone Time zone used for the data N/A
generationtime_ms Time taken to generate the data (in milliseconds) ms
nightly_summaries.date Date of the daily entry iso8601
nightly_summaries.sunset Time of sunset for the specific day iso8601
nightly_summaries.sunrise_next Time of the next day's sunrise iso8601
nightly_summaries.is_observable Whether stargazing is possible (true/false) boolean
nightly_summaries.observation_text A text description of the stargazing conditions N/A

Example

  "latitude": 47,
  "longitude": 2.56,
  "timezone": "GMT",
  "generationtime_ms": 0.4011392593383789,
  "nightly_summaries": [
      {
      "date": "2025-01-23",
      "sunset": "2025-01-23T16:38",
      "sunrise_next": "2025-01-24T07:23",
      "is_observable": true,
      "observation_text": "The best window for stargazing is between 22:00 and 01:00, with the lowest cloud cover at 9%.\n"
    },
    {