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