Kumo API

This is advanced real-time information API for geo-spatial, weather and information gathering data

Please note that we closely watch for suspicious activity on the /kumo/geoip endpoint! Any abuse will result in account suspension without notice.

Weather endpoints are deprecated and no longer supported.

Search for locations and get maps

GET https://api.ksoft.si/kumo/gis

You can get coordinates and more information about the searched location, if needed image of the area is generated.

Query Parameters

Name	Type	Description
q	string	Your location query
fast	boolean	Default: fast, return location data faster, but with less information
more	boolean	Default: false, return more than one location
map_zoom	integer	Default: 12, set your own zoom level, if fast is not set or false, then this setting will be ignored because map zoom is calculated
include_map	boolean	Default: false, if to include an image of the area

Headers

Name	Type	Description
Authorization	string	Authentication token

200

{
    "error": false,
    "code": 200,
    "data": {
        "address": "Ljubljanski grad, Grajska planota, Krakovo, Trnovo, Ljubljana, Upravna Enota Ljubljana, Osrednjeslovenska, 1104, Slovenija",
        "lat": 46.0487841,
        "lon": 14.508550980754,
        "bounding_box": [
            "46.0484431",
            "46.049276",
            "14.5079938",
            "14.5093049"
        ],
        "type": [
            "historic",
            "castle"
        ],
        "map": "https://cdn-proxy.ksoft.si/c/gis/https!d!p!pmaps!bgoogleapis!bcom!pmaps!papi!pstaticmap!qformat!epng!amaptype!eroadmap!asize!e1200x900!azoom!e12!acenter!e46!b0487841!k2C14!b508550980754!akey!eAIzaSyAbPsxpzvPlhpxLybzlO2VGghdDzcZ0owg!asignature!ek50BukFk0-3QH4obR69hx2YprHk!e"
    }
}

404

{
    "error": false,
    "code": 404,
    "message": "Nothing found."
}

Weather - easy

GET https://api.ksoft.si/kumo/weather/{report_type}

Path Parameters

Name	Type	Description
report_type	string	Select weather report type. Can be one of: "currently", "minutely", "hourly", "daily"

Query Parameters

Name	Type	Description
q	string	Location query
units	string	Default: auto, select units, you can choose from: "si", "us", "uk2", "ca", "auto"
lang	string	Default: en, select language, all available languages: 'ar', 'az', 'be', 'bg', 'bs', 'ca', 'cs', 'da', 'de', 'el', 'en', 'es', 'et', 'fi', 'fr', 'he', 'hr', 'hu', 'id', 'is', 'it', 'ja', 'ka', 'ko', 'kw', 'nb', 'nl', 'no', 'pl', 'pt', 'ro', 'ru', 'sk', 'sl', 'sr', 'sv', 'tet', 'tr', 'uk', 'x-pig-latin', 'zh', 'zh-tw'
icons	string	Default: original, select icon pack

Headers

Name	Type	Description
Authorization	string	Authentication token

200 Currently data set

{
    "error": false,
    "status": 200,
    "data": {
        "time": "2018-09-24T15:15:49",
        "summary": "Clear",
        "icon": "clear-day",
        "precipIntensity": 0,
        "precipProbability": 0,
        "temperature": 15.88,
        "apparentTemperature": 15.88,
        "dewPoint": 6.43,
        "humidity": 0.53,
        "pressure": 1026.44,
        "windSpeed": 4.45,
        "windGust": 7.72,
        "windBearing": 145,
        "cloudCover": 0.22,
        "uvIndex": 1,
        "visibility": 16.09,
        "ozone": 282.17,
        "sunriseTime": null,
        "sunsetTime": null,
        "icon_url": "https://cdn.ksoft.si/weather/original/clear-day.png",
        "alerts": [
            {
                "title": "Moderate Low Temperature Warning (Degree 2/4) - Slovenia / Central",
                "regions": [
                    "Slovenia / Central"
                ],
                "severity": "watch",
                "time": 1537916400,
                "expires": 1537948740,
                "description": "Low temperatures may affect the health of sensitive members of the population.\n",
                "uri": "http://www.meteo.si/met/sl/warning/"
            }
        ],
        "units": "si",
        "location": {
            "lat": 46.0569465,
            "lon": 14.5057515,
            "address": "Ljubljana, Slovenia"
        }
    }
}

404

{
    "error": false,
    "code": 404,
    "message": "That location was not found, try using lan and lon."
}

Weather - advanced

GET https://api.ksoft.si/kumo/weather/{latitude},{longitude}/{report_type}

Gets weather by coordinates, this endpoint is faster than weather - easy, because it doesn't need to lookup the location.

Path Parameters

Name	Type	Description
latitude	number	Latitude coordinate
longitude	number	Longitude coordinate
report_type	string	Select weather type. Can be one of: "currently", "minutely", "hourly", "daily"

Query Parameters

Name	Type	Description
units	string	Default: auto, select units, you can choose from: "si", "us", "uk2", "ca", "auto"
lang	string	Default: en, select language, all available languages: 'ar', 'az', 'be', 'bg', 'bs', 'ca', 'cs', 'da', 'de', 'el', 'en', 'es', 'et', 'fi', 'fr', 'he', 'hr', 'hu', 'id', 'is', 'it', 'ja', 'ka', 'ko', 'kw', 'nb', 'nl', 'no', 'pl', 'pt', 'ro', 'ru', 'sk', 'sl', 'sr', 'sv', 'tet', 'tr', 'uk', 'x-pig-latin', 'zh', 'zh-tw'
icons	string	Default: original, select icon pack

Headers

Name	Type	Description
Authorization	string	Authentication token

200

{
    "error": false,
    "status": 200,
    "data": {
        "time": "2018-09-24T15:15:49",
        "summary": "Clear",
        "icon": "clear-day",
        "precipIntensity": 0,
        "precipProbability": 0,
        "temperature": 15.88,
        "apparentTemperature": 15.88,
        "dewPoint": 6.43,
        "humidity": 0.53,
        "pressure": 1026.44,
        "windSpeed": 4.45,
        "windGust": 7.72,
        "windBearing": 145,
        "cloudCover": 0.22,
        "uvIndex": 1,
        "visibility": 16.09,
        "ozone": 282.17,
        "sunriseTime": null,
        "sunsetTime": null,
        "icon_url": "https://cdn.ksoft.si/weather/original/clear-day.png",
        "alerts": [
            {
                "title": "Moderate Low Temperature Warning (Degree 2/4) - Slovenia / Central",
                "regions": [
                    "Slovenia / Central"
                ],
                "severity": "watch",
                "time": 1537916400,
                "expires": 1537948740,
                "description": "Low temperatures may affect the health of sensitive members of the population.\n",
                "uri": "http://www.meteo.si/met/sl/warning/"
            }
        ],
        "units": "si",
        "location": {
            "lat": 46.0569465,
            "lon": 14.5057515
        }
    }
}

404

{
    "error": false,
    "code": 404,
    "message": "That location was not found, try using lan and lon."
}

GeoIP

GET https://api.ksoft.si/kumo/geoip

Gets location data from the IP address.

Query Parameters

Name	Type	Description
ip	string	IP address

Headers

Name	Type	Description
Authorization	string	Authentication token

200

{
    "error": false,
    "code": 200,
    "data": {
        "city": "Research",
        "continent_code": "OC",
        "continent_name": "Oceania",
        "country_code": "AU",
        "country_name": "Australia",
        "dma_code": null,
        "latitude": -37.7,
        "longitude": 145.1833,
        "postal_code": "3095",
        "region": "VIC",
        "time_zone": "Australia/Melbourne",
        "apis": {
            "weather": "https://api.ksoft.si/kumo/weather/-37.7,145.1833/currently",
            "gis": "https://api.ksoft.si/kumo/gis?q=-37.7,145.1833&fast=yes",
            "openstreetmap": "https://www.openstreetmap.org/#map=15/-37.7/145.1833",
            "googlemaps": "https://www.google.com/maps/@-37.7,145.1833,15z"
        }
    }
}

404

{
    "error": true,
    "code": 404,
    "message": "This IP address was not found!"
}

Currency conversion

GET https://api.ksoft.si/kumo/currency

Query Parameters

Name	Type	Description
from	string	ISO Standard for 3 letter currency naming: https://en.wikipedia.org/wiki/ISO_4217#Active_codes
to	string	ISO Standard for 3 letter currency naming: https://en.wikipedia.org/wiki/ISO_4217#Active_codes
value	string	Float or Integer you want to convert

Headers

Name	Type	Description
Authorization	string	Authentication token

200

{
    "value": 88.6129,
    "pretty": "88.61 EUR"
}

404

{
    "error": true,
    "code": 404,
    "message": "currency hahayes does not exist"
}