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
Request
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
Response
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
Request
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
Response
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
Request
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
Response
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
Request
Headers
Authorization
required
string
Authentication token
Query Parameters
ip
required
string
IP address
Response
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
Request
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
Response
200: OK
{
"value": 88.6129,
"pretty": "88.61 EUR"
}
404: Not Found
{
"error": true,
"code": 404,
"message": "currency hahayes does not exist"
}