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 |
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 |
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 |
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 |
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 |
Last updated