Developers

Access to APIs and integration tools: Geo Index KAM data can be embedded in your applications, websites and analytics systems.

REST API /api/v2

The /api/v2 REST interface is available to third parties. Authentication uses a key in the X-API-Key header; each key is tied to a specific platform and precisely defined access scopes (for example, events:read for reading the events calendar). Production and test versions of keys are available, while access is logged and subject to quotas.

curl -H "X-API-Key: itk_test_..." https://racunalniske-resitve.si/api/v2/events

Responses use JSON with a consistent envelope and clear error codes. The set of resources is expanding by module: events, geo-points and content.

Site search (GET /isci/results?q=..., with suggestions at /isci/suggestions) and live statistics (GET /api/site_stats) are available without authentication.

Embedding the map (iFrame)

The map layer can be embedded in an existing website with a single iFrame element, without changing your technology. We use the same embed ourselves on the Geo Index KAM page.

<iframe src="https://savinjska.kupujlokalno.si/geo-kazalo-kam?embed=minimal"
        title="Geo Index KAM" loading="lazy"></iframe>

Open the live embed target: the same address read by the iFrame.

Data and formats

Routes are available as GPX tracks with conversion to GeoJSON, geo-points with coordinates, categories and administrators, and events with structured times and locations. Standardised point descriptions are ready for use by AI assistants: content has a clearly identified source, administrator and location.

For AI agents

If you are an AI agent or are building for them: a machine-readable content map is available at /llms.txt, while instructions for interacting with the website (queries, enquiries and the API) are available at /agents.md. Live statistics are available without authentication at /api/site_stats. Both are also listed in robots.txt.

Access

We issue API keys by agreement: describe your use case and the data you require. A test key for development is free of charge.

Request an API key Back to Geo Index KAM

Resources, scopes and limits

Per-key limits: 60 requests/minute and 10,000 requests/day (HTTP 429 with a Retry-After header when exceeded), with a page size of up to 50 records. The version is included in the path (/api/v2); changes within a version are backwards compatible.

Example response

{
  "success": true,
  "page": 1,
  "limit": 20,
  "has_more": false,
  "items": [
    {
      "event_id": "123",
      "naziv": "Event by the Savinja",
      "starts_at": "2026-08-01T18:00:00+02:00",
      "location": { "label": "Mozirje", "lat": 46.339, "lng": 14.963 }
    }
  ]
}