API
API
Dashboard
Privacy Policy & Terms of Use
Introduction
Images API
Bans API
Kumo API
Lyrics & Music API
DBL Integration
Webhooks
Powered by GitBook

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.

get
Search for locations and get maps

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.
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
q
required
string
Your location query
fast
optional
boolean
Default: fast, return location data faster, but with less information
more
optional
boolean
Default: false, return more than one location
map_zoom
optional
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
optional
boolean
Default: false, if to include an image of the area
200: OK
{
    "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: Not Found
{
    "error": false,
    "code": 404,
    "message": "Nothing found."
}

get
Weather - easy

https://api.ksoft.si/kumo/weather/{report_type}
Request
Response
Path Parameters
report_type
required
string
Select weather report type. Can be one of: "currently", "minutely", "hourly", "daily"
Headers
Authorization
required
string
Authentication token
Query Parameters
q
required
string
Location query
units
optional
string
Default: auto, select units, you can choose from: "si", "us", "uk2", "ca", "auto"
lang
optional
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
optional
string
Default: original, select icon pack
200: OK
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: Not Found
{
    "error": false,
    "code": 404,
    "message": "That location was not found, try using lan and lon."
}

get
Weather - advanced

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.
Request
Response
Path Parameters
latitude
required
number
Latitude coordinate
longitude
required
number
Longitude coordinate
report_type
required
string
Select weather type. Can be one of: "currently", "minutely", "hourly", "daily"
Headers
Authorization
required
string
Authentication token
Query Parameters
units
optional
string
Default: auto, select units, you can choose from: "si", "us", "uk2", "ca", "auto"
lang
optional
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
optional
string
Default: original, select icon pack
200: OK
{
    "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: Not Found
{
    "error": false,
    "code": 404,
    "message": "That location was not found, try using lan and lon."
}

get
GeoIP

https://api.ksoft.si/kumo/geoip
Gets location data from the IP address.
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
ip
required
string
IP address
200: OK
{
    "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: Not Found
{
    "error": true,
    "code": 404,
    "message": "This IP address was not found!"
}

get
Currency conversion

https://api.ksoft.si/kumo/currency
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
from
required
string
ISO Standard for 3 letter currency naming: https://en.wikipedia.org/wiki/ISO_4217#Active_codes
to
required
string
ISO Standard for 3 letter currency naming: https://en.wikipedia.org/wiki/ISO_4217#Active_codes
value
required
string
Float or Integer you want to convert
200: OK
{
    "value": 88.6129,
    "pretty": "88.61 EUR"
}
404: Not Found
{
    "error": true,
    "code": 404,
    "message": "currency hahayes does not exist"
}
Previous
Bans API
Next
Lyrics & Music API
Last updated -1
Contents
get
Search for locations and get maps
get
Weather - easy
get
Weather - advanced
get
GeoIP
get
Currency conversion