Skip to Content
🚀 Introduction

🌤️ Skycaster API

Welcome to the Skycaster API documentation. Skycaster delivers real-time and forecast weather data for TV and radio broadcasters, as JSON or XML, ready for your graphics, playout and automation systems.

🚀 Key Features

  • Global Coverage: Weather data for any location worldwide, from the city database or your own coordinates.
  • Comprehensive Data: 80+ fields — temperature, humidity, wind, precipitation, clouds, UV, sunshine and daylight, radiation, soil, air quality, pollen and weather alerts.
  • Current, Hourly and Daily: Current conditions plus hourly and daily forecasts up to 16 days ahead.
  • Your Own Wording: Replace weather descriptions and alert titles with your own text in any language (?lang=).
  • Presets: Save cities, fields and units as named presets and request any of them with ?preset=.
  • Weather Maps: Build map configurations in the dashboard and render them with the Rendering Client.

📘 Getting Started

To begin integrating Skycaster into your application:

Subscribe

Choose a plan on our Website  and create your account.

Create an API Key

In the dashboard, open Profile → API Keys and create a key.

Configure and Publish

On the Weather Data page, select cities, fields and units for each mode (current, hourly, daily) and click Publish to API.

Make API Calls

Call the endpoints below with your key.

🔗 App Overview

🛠️ Example Request

Here’s how to fetch current weather data:

curl 'https://www.skycaster.tv/api/public/v1/weather' \
-H 'Authorization: Bearer YOUR_API_KEY_HERE'

Sample Response (fields depend on what you published on the Weather Data page):

{
"message": [
  {
    "city": "Zürich",
    "data": {
      "icon": "https://cdn.skycaster.tv/set-2/01d.gif",
      "weather_description": "Clear sky",
      "temp": 17.6,
      "dew": 5.8,
      "wind": 4.9,
      "gusts": 10.6,
      "wind_direction": 70,
      "wind_direction_label": "ENE",
      "humidity": 46,
      "eu_aqi": 32,
      "ozone": 106.1
    }
  }
]
}

📞 Need Assistance?

If you have questions or need support, email us at support@skycaster.tv.

Last updated on
🔐 Authentication