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

string

Your location query

fast

boolean

Default: fast, return location data faster, but with less information

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

{
    "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"
    }
}

{
    "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

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

{
    "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"
        }
    }
}

{
    "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

icons

string

Default: original, select icon pack

Headers

Name

Type

Description

Authorization

string

Authentication token

{
    "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
        }
    }
}

{
    "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

string

IP address

Headers

Name

Type

Description

Authorization

string

Authentication token

{
    "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"
        }
    }
}

{
    "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

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

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

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

PreviousBans API NextLyrics & Music API

Last updated 4 years ago