Skip to content

Nowcast API 0.35.2

The Nowcast API provides access to minute-by-minute precipitation forecast for the next 4 hours.

Servers

Description URL
Production API server https://api.rainbow.ai

Endpoints

GET /nowcast/v1/precip/{longitude}/{latitude}

Minute-by-minute precipitation forecast

Description

This endpoint provides a minute-by-minute precipitation forecast for the next 4 hours.

The forecast includes:

  • Minute-by-minute precipitation for the next 4 hours.

Use Cases

  • Weather apps providing detailed short-term forecasts

  • Logistics & transportation companies planning routes

  • Outdoor activity planning, such as hiking, sports, and events

Data Coverage

  • The API supports global locations but may return 404 if weather data is unavailable in a specific area.

Input parameters

Parameter In Type Default Nullable Description
latitude path number No Latitude coordinate of the location for which the forecast is requested
longitude path number No Longitude coordinate of the location for which the forecast is requested
start_timestamp query No Start timestamp of the forecast (in seconds). This timestamp could be only in a past 30 minutes. It must be less that current time and aligned to 1-minute intervals.If not provided, the current time will be used.

Responses

JSON
{
    "forecast": [
        {
            "precipRate": 1.42,
            "precipType": "snow",
            "timestampBegin": 1737570600,
            "timestampEnd": 1737570660
        }
    ],
    "latitude": 52.2328940965463,
    "longitude": 21.0065536398819,
    "summary": {
        "intensity": "moderate"
    }
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
JSON
{
    "properties": {
        "longitude": {
            "type": "number",
            "title": "longitude",
            "description": "Longitude coordinate of the location for which the forecast is prepared",
            "example": 21.0065536398819
        },
        "latitude": {
            "type": "number",
            "title": "latitude",
            "description": "Latitude coordinate of the location for which the forecast is prepared",
            "example": 52.2328940965463
        },
        "summary": {
            "$ref": "#/components/schemas/PrecipForecastSummary",
            "title": "summary",
            "description": "Classification of the maximum precipitation intensity during the period"
        },
        "forecast": {
            "items": {
                "$ref": "#/components/schemas/PrecipForecastItem"
            },
            "type": "array",
            "title": "forecast",
            "description": "Precipitation forecast for the next 4 hours"
        }
    },
    "type": "object",
    "required": [
        "longitude",
        "latitude",
        "summary",
        "forecast"
    ],
    "title": "PrecipForecastResponse",
    "example": {
        "forecast": [
            {
                "precipRate": 1.42,
                "precipType": "snow",
                "timestampBegin": 1737570600,
                "timestampEnd": 1737570660
            }
        ],
        "latitude": 52.2328940965463,
        "longitude": 21.0065536398819,
        "summary": {
            "intensity": "moderate"
        }
    }
}

JSON
{
    "message": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
JSON
{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

JSON
{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
JSON
{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /nowcast/v1/precip-global/{longitude}/{latitude}

Minute-by-minute global precipitation forecast

Description

This endpoint provides a minute-by-minute global precipitation forecast for the next 4 hours.

The forecast includes:

  • Minute-by-minute precipitation for the next 4 hours.

Use Cases

  • Weather apps providing detailed short-term forecasts

  • Logistics & transportation companies planning routes

  • Outdoor activity planning, such as hiking, sports, and events

Data Coverage

  • The API supports global locations.

Input parameters

Parameter In Type Default Nullable Description
latitude path number No Latitude coordinate of the location for which the forecast is requested
longitude path number No Longitude coordinate of the location for which the forecast is requested
start_timestamp query No Start timestamp of the forecast (in seconds). This timestamp could be only in a past 30 minutes. It must be less that current time and aligned to 1-minute intervals.If not provided, the current time will be used.

Responses

JSON
{
    "forecast": [
        {
            "precipRate": 1.42,
            "precipType": "snow",
            "timestampBegin": 1737570600,
            "timestampEnd": 1737570660
        }
    ],
    "latitude": 52.2328940965463,
    "longitude": 21.0065536398819,
    "summary": {
        "intensity": "moderate"
    }
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
JSON
{
    "properties": {
        "longitude": {
            "type": "number",
            "title": "longitude",
            "description": "Longitude coordinate of the location for which the forecast is prepared",
            "example": 21.0065536398819
        },
        "latitude": {
            "type": "number",
            "title": "latitude",
            "description": "Latitude coordinate of the location for which the forecast is prepared",
            "example": 52.2328940965463
        },
        "summary": {
            "$ref": "#/components/schemas/PrecipForecastSummary",
            "title": "summary",
            "description": "Classification of the maximum precipitation intensity during the period"
        },
        "forecast": {
            "items": {
                "$ref": "#/components/schemas/PrecipForecastItem"
            },
            "type": "array",
            "title": "forecast",
            "description": "Precipitation forecast for the next 4 hours"
        }
    },
    "type": "object",
    "required": [
        "longitude",
        "latitude",
        "summary",
        "forecast"
    ],
    "title": "PrecipForecastResponse",
    "example": {
        "forecast": [
            {
                "precipRate": 1.42,
                "precipType": "snow",
                "timestampBegin": 1737570600,
                "timestampEnd": 1737570660
            }
        ],
        "latitude": 52.2328940965463,
        "longitude": 21.0065536398819,
        "summary": {
            "intensity": "moderate"
        }
    }
}

JSON
{
    "message": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
JSON
{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

JSON
{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
JSON
{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

Schemas

HTTPValidationError

Name Type Description
detail Array<ValidationError>

PrecipForecastItem

Name Type Description
precipRate number Precipitation rate in mm/h
precipType ResponsePrecipType Precipitation type. Possible values: no_precipitation, snow, rain, mixed
timestampBegin integer Start of the precipitation event in seconds since epoch
timestampEnd integer End of the precipitation event in seconds since epoch

PrecipForecastResponse

Name Type Description
forecast Array<PrecipForecastItem> Precipitation forecast for the next 4 hours
latitude number Latitude coordinate of the location for which the forecast is prepared
longitude number Longitude coordinate of the location for which the forecast is prepared
summary PrecipForecastSummary Classification of the maximum precipitation intensity during the period

PrecipForecastSummary

Name Type Description
intensity ResponsePrecipIntensity Classification of the maximum precipitation intensity during the period

ResponsePrecipIntensity

Type: string

ResponsePrecipType

Type: string

ValidationError

Name Type Description
loc Array<>
msg string
type string