Weather API Endpoint

GET https://api.data.gov.my/weather/forecast
GET https://api.data.gov.my/weather/warning
GET https://api.data.gov.my/weather/warning/earthquake

Source of Weather Data

The Weather API offers real-time weather information, including a 7-day general forecast and live weather warnings. Additionally, earthquake warnings are provided in a separate endpoint due to their unique format. The data is provided by MET Malaysia (Malaysian Meteorological Department). For more comprehensive weather-related information and additional resources, you can visit MET Malaysia's Official Portal (opens in a new tab).

Note: Marine forecast data is currently unavailable.

Frequency of Data Update

• The 7-day general forecast data is updated daily.
• The warning data (including earthquake data) is updated when required.

Request Query & Response Format

To filter and request data, use the standard filtering operations in the Request Query. For information on how the API responds to your requests, refer to the Response Format section.

7-day General Forecast

GET https://api.data.gov.my/weather/forecast

Example Query

To fetch data from the Weather API, use the following curl command. Open your terminal and enter this command:

curl --location 'https://api.data.gov.my/weather/forecast?limit=3'

Querying Nested Fields

    {
        // double underscore is used
        "location": {
            "location_id": "Ds001", // location__location_id
            "location_name": "Langkawi" // location__location_name
        },
        "date": "1957-08-31",
        "morning_forecast": "Hujan di satu dua tempat",
        "afternoon_forecast": "Ribut petir di satu dua tempat",
        "night_forecast": "Tiada hujan",
        "summary_forecast": "Ribut petir di satu dua tempat",
        "summary_when": "Petang",
        "min_temp": 26,
        "max_temp": 32
    },

The response data is structured as above. You can access nested fields using a double underscore. For instance, to filter forecast data for Langkawi, you can use the query parameter ?contains=Langkawi@location__location_name.

Filtering by Location Category

GET https://api.data.gov.my/weather/forecast?contains=<prefix>@location__location_id

The location_id is in "AA000" format, where the aphabetical prefix represents the type of location. There are five possible types of locations:

• St for State
• Rc for Recreation Centre
• Ds for District
• Tn for Town
• Dv for Division

To filter for forecast data for a specific location category, simply use the contains query parameter. For example, to retrieve State location forecast data only, use ?contains=St@location__location_id.

Understanding the Field Values

Possible Values for *_forecast Fields

Possible values for morning_forecast, afternoon_forecast, night_forecast, and summary_forecast:

Possible Values for summary_when Field

Note: Please be aware that the above field values are currently only available in Bahasa Melayu.

Warning Forecast

GET https://api.data.gov.my/weather/warning

Example Query

To fetch data from the Weather API, use the following curl command. Open your terminal and enter this command:

curl --location 'https://api.data.gov.my/weather/warning?limit=3'

Querying Nested Fields

    {
        // double underscore is used
        "warning_issue": {
            "issued": "1957-08-31T00:00:00", // warning_issue__issued
            "title_bm": "", // warning_issue__title_bm
            "title_en": "" // warning_issue__title_en
        },
        "valid_from": "1957-08-31T00:00:00",
        "valid_to": "2023-08-31T00:00:00",
        "heading_en": "",
        "text_en": "",
        "instruction_en": "",
        "heading_bm": "",
        "text_bm": "",
        "instruction_bm": ""
    },

The response data is structured as above. You can access nested fields using a double underscore. For instance, to filter for warnings issued from 1957-08-31 onwards, you can use the query parameter ?timestamp_start=1957-08-31 00:00:00@warning_issue__issued.

Understanding the Field Values

Earthquake Warning

GET https://api.data.gov.my/weather/warning/earthquake

Earthquake data is provided in a dedicated endpoint from weather/warning due to its unique format.

Example Query

To fetch data from the Weather API, use the following curl command. Open your terminal and enter this command:

curl --location 'https://api.data.gov.my/weather/warning/earthquake?limit=3'

Understanding the Field Values