Podatkovni vmesnik (API)
Vsi grafi na tej strani berejo podatke prek odprtega vmesnika REST. Isti vmesnik lahko uporabiš v svojih prikazih in člankih: brez prijave in brez ključa, z navedbo vira.
Končne točke
15 javnih poti pod https://mcbot.si/wp-json/mvs/v1/. Odgovor je JSON (UTF-8). Deluje tudi brez lepih povezav: https://mcbot.si/?rest_route=/mvs/v1/indicators.
GET /mvs/v1/indicators
Seznam vseh aktivnih kazalnikov: slug, ime, enota, kategorija, pogostost (Y, H, Q, M).
Primer: https://mcbot.si/wp-json/mvs/v1/indicators
[
{
"slug": "delez_0_14",
"name": "Delež otrok do 14 let",
"unit": "%",
"category": "prebivalstvo",
"frequency": "Y"
},
{
"slug": "delez_65",
"name": "Delež starih 65 let ali več",
"unit": "%",
"category": "prebivalstvo",
"frequency": "Y"
},
{
"slug": "tujci_delez",
"name": "Delež tujih državljanov",
"unit": "%",
"category": "prebivalstvo",
"frequency": "H"
},
{
…GET /mvs/v1/series
Časovna vrsta enega kazalnika po območjih: obdobja (2025, 2025Q3, 2025M08) in vrednosti, s podatki o kazalniku, viru in območjih.
| Parameter | Opis |
|---|---|
indicator obvezen | Slug kazalnika (seznam: /indicators). |
areas | Slugi območij, ločeni z vejico (največ 12); brez parametra vsa območja. |
from | Prvo leto (npr. 2015). |
pogled | desezonirano: sezonsko prilagojena serija (le mesečne in četrtletne, enostavna metoda drsečega povprečja). |
Primer: https://mcbot.si/wp-json/mvs/v1/series?indicator=neto_placa&areas=ljubljana%2Cmaribor&from=2015
{
"indicator": {
"slug": "neto_placa",
"name": "Povprečna mesečna neto plača",
"unit": "€",
"decimals": 2,
"source": "SURS, SiStat 2640010S (Izbrani podatki po občinah)",
"source_url": "https://pxweb.stat.si/SiStatData/pxweb/sl/Data/-/2640010S.px",
"theme": "denar"
},
"events": [
{
"d": "2007-01-01",
"t": "Uvedba evra",
"to": "",
"themes": []
},
{
"d": "2008-09-15",
…GET /mvs/v1/compare
Primerjalnik: pripravljeni podatki za graf, statistika in tabela – en kazalnik po območjih ali dva kazalnika na enem območju. Isti parametri kot stran /primerjava/.
| Parameter | Opis |
|---|---|
a obvezen | Slug kazalnika A. |
b | Slug kazalnika B (za primerjavo dveh kazalnikov). |
obmocja | Slugi območij, ločeni z vejico (en kazalnik). |
obmocje | Slug območja (dva kazalnika). |
pogled | En kazalnik: vrednost, indeks, sprememba, razlika, slovenija, na1000, lestvica, lestvica_leta, sezonsko, desezonirano. Dva kazalnika (pogled2): indeks, dveosi, razmerje, razsevni. |
frekvenca | M, Q, H ali Y (le v grobejšo smer). |
od | Prvo leto. |
do | Zadnje leto. |
bazno | Bazno leto za indeks (= 100). |
Primer: https://mcbot.si/wp-json/mvs/v1/compare?a=neto_placa&obmocja=ljubljana%2Cmaribor&pogled=indeks
{
"ok": true,
"view": "indeks",
"title": "Povprečna mesečna neto plača – indeks",
"subtitle": "Vsako območje glede na svojo raven v letu 2008.",
"notes": [],
"chart": {
"type": "line",
"labels": [
"2008",
"2009",
"2010",
"2011",
"2012",
"2013",
"2014",
"2015",
"2016",
"2017",
"2018",
"2019",
"2020",
"2021",
…GET /mvs/v1/denar
Stran Denar: vloge, skladi, pokojnine, borza, krediti (ECB, Eurostat, ATVP, Ljubljanska borza).
Primer: https://mcbot.si/wp-json/mvs/v1/denar
{
"v": 1,
"fetched": "2026-11-16 06:39:31",
"s": {
"dep_on": {
"2015M01": 7580.1940000000004147295840084552764892578125,
"2015M02": 7762.3059999999995852704159915447235107421875,
"2015M03": 7933.3699999999998908606357872486114501953125,
"2015M04": 7971.3810000000003128661774098873138427734375,
"2015M05": 8138.1760000000003856257535517215728759765625,
"2015M06": 8309.53700000000026193447411060333251953125,
"2015M0
…GET /mvs/v1/evropa
Slovenija v Evropi: kazalniki Eurostata za Slovenijo, sosede in EU.
Primer: https://mcbot.si/wp-json/mvs/v1/evropa
{
"v": 1,
"fetched": "2026-11-12 10:43:32",
"geo": {
"SI": "Slovenija",
"EU27_2020": "EU",
"AT": "Avstrija",
"HR": "Hrvaška",
"IT": "Italija",
"HU": "Madžarska",
"DE": "Nemčija"
},
"defs": {
"odhod": {
"ds": "yth_demo_030",
"label": "Starost ob odhodu od staršev",
"unit": "let",
"dec": 1,
"dir": 0,
"grp": "mladi",
"note": "Ocenjena povprečna starost,
…GET /mvs/v1/goriva
Cene goriv: regulirane cene bencina, dizla in kurilnega olja po dnevih ter primerjava s sosednjimi državami.
Primer: https://mcbot.si/wp-json/mvs/v1/goriva
{
"si": {
"dates": [
"2005-01-03",
"2005-01-10",
"2005-01-17",
"2005-01-24",
"2005-01-31",
"2005-02-07",
"2005-02-14",
"2005-02-21",
"2005-02-28",
"2005-03-07",
"2005-03-14",
"2005-03-21",
"2005-03-28",
"2005-04-04",
"2005-04-11",
"2005-04-18",
"2005-04-25",
"2005-05-02",
"2005-0
…GET /mvs/v1/krediti
Krediti in obrestne mere (ECB).
Primer: https://mcbot.si/wp-json/mvs/v1/krediti
{
"v": 1,
"fetched": "2026-11-12 11:13:24",
"labels": {
"hp_growth_si": {
"label": "Rast stanovanjskih posojil, Slovenija",
"unit": "%",
"dec": 1,
"grp": "rast"
},
"hp_growth_ea": {
"label": "Rast stanovanjskih posojil, evrsko območje",
"unit": "%",
"dec": 1,
"grp": "rast"
},
"cc_growth_si": {
"label": "Rast potrošniških posojil, Slovenija",
"uni
…GET /mvs/v1/moja-obcina
Moja občina: ključne številke občine po šifri SURS (odgovor vsebuje tudi HTML za vdelavo).
| Parameter | Opis |
|---|---|
o obvezen | Šifra občine (SURS, tri števke, npr. 061 za Ljubljano). |
Primer: https://mcbot.si/wp-json/mvs/v1/moja-obcina?o=061
{
"code": "061",
"name": "Ljubljana",
"slug": "ljubljana",
"html": "<div class=\"mvs-mine-head\"><div><span class=\"mvs-lede-type\">Moja občina</span><h2>Ljubljana</h2><p class=\"mvs-desc\">Osrednjeslovenska regija · <a href=\"https://mcbot.si/obmocje/osrednjeslovenska/\">vse o regiji</a></p></div><div class=\"mvs-mine-links\"><a class=\"mvs-btn\" href=\"https://mcbot.si/obmocje/ljubljana/\">Vse o občini</a><button type=\"button\" class=\"mvs-btn is-ghost\" data-mine=\"change\">Zamenjaj</button><but
…GET /mvs/v1/nakup
Kazalec nakupa stanovanja (izračun MCBOT) za zadnje leto: ocena 0–100, pet stebrov (dostopnost, donos, trg, povpraševanje, tveganje), ključne številke po občinah in občine s premalo posli. Ni nasvet za nakup.
Primer: https://mcbot.si/wp-json/mvs/v1/nakup
{
"y": 2026,
"per": "za zadnjih 12 mesecev (posli GURS sep 2025–avg 2026, plače do avg 2026)",
"win": {
"from": "2025-09",
"to": "2026-08",
"wm": "2026M08",
"um": "2026M08"
},
"made": "2026-11-18 16:42:55",
"min": {
"sales": 20,
"rents": 10
},
"w": [
30,
20,
15,
25,
10
],
"pillars": [
[
"Dostopnost",
"Dostopnost cen"
],
[
"Donos",
…GET /mvs/v1/orodja/cene
Podatki za orodja: indeksi cen po skupinah, Euribor, cene energije.
Primer: https://mcbot.si/wp-json/mvs/v1/orodja/cene
{
"v": 1,
"cpi": {
"periods": [
"2000M01",
"2000M02",
"2000M03",
"2000M04",
"2000M05",
"2000M06",
"2000M07",
"2000M08",
"2000M09",
"2000M10",
"2000M11",
"2000M12",
"2001M01",
"2001M02",
"2001M03",
"2001M04",
"2001M05",
"2001M06",
"2001M07",
"2001M08",
…GET /mvs/v1/orodja/zivljenje
Podatki za orodja Življenje: plače, krediti, energija po občinah.
Primer: https://mcbot.si/wp-json/mvs/v1/orodja/zivljenje
{
"v": 1,
"fetched": "2026-11-18 07:10:36",
"obcine": {
"001": [
"Ajdovščina",
"11"
],
"213": [
"Ankaran",
"12"
],
"195": [
"Apače",
"01"
],
"002": [
"Beltinci",
"01"
],
"148": [
"Benedikt",
"02"
],
"149": [
"Bistrica ob Sotli",
"06"
],
"003": [
"B
…GET /mvs/v1/revisions
Primer: https://mcbot.si/wp-json/mvs/v1/revisions
{
"count": 50,
"revisions": [
{
"indicator": "udelezba_lv",
"area": "zasavska",
"period": "2026",
"old_value": 53.74000000000000198951966012828052043914794921875,
"new_value": 53.780000000000001136868377216160297393798828125,
"pct": 0.070000000000000006661338147750939242541790008544921875,
"source": "dvk",
"changed_at": "2026-11-18 00:22:46"
},
{
"indicator": "udelezba_lv",
…GET /mvs/v1/v-zivo
Volilni večer: izidi v živo, ko je vklopljen prenos (sicer active: false).
Primer: https://mcbot.si/wp-json/mvs/v1/v-zivo
{
"active": true,
"fetched": "2026-11-18T01:04:51+01:00",
"elections": [
{
"key": "lv2026",
"type": "lv",
"label": "Lokalne volitve 2026",
"date": "2026-11-15",
"dateLabel": "nedelja, 15. 11. 2026",
"phase": "koncni",
"updated": "2026-11-17T18:00:00Z",
"final": true,
"counted": 0.99870000000000003215205879314453341066837310791015625,
"turnout": {
"prev": {
…GET /mvs/v1/v-zivo/obcina
Volilni večer: izid za eno občino.
| Parameter | Opis |
|---|---|
st obvezen | Šifra občine (SURS, tri števke, npr. 061 za Ljubljano). |
Primer: https://mcbot.si/wp-json/mvs/v1/v-zivo/obcina?st=061
{
"code": "061",
"name": "Ljubljana",
"mayor": [
{
"name": "Zoran Janković",
"votes": 39239,
"pct": 34.93999999999999772626324556767940521240234375
},
{
"name": "Luka Mesec",
"votes": 29352,
"pct": 26.1400000000000005684341886080801486968994140625
},
{
"name": "Aleš Vrhovec",
"votes": 9882,
"pct": 8.800000000000000710542735760100185871124267578125
},
…GET /mvs/v1/zrak
Kakovost zraka ARSO: zadnja ura na merilnih postajah (PM10, PM2,5).
Primer: https://mcbot.si/wp-json/mvs/v1/zrak
{
"ok": true,
"time": "2026-11-18 19:00",
"stations": [
{
"id": "E403",
"name": "LJ Bežigrad",
"area": "ljubljana",
"area_name": "Ljubljana",
"pm10": 6,
"pm25": 4,
"no2": 10,
"o3": 67
},
{
"id": "E405",
"name": "LJ Celovška",
"area": "ljubljana",
"area_name": "Ljubljana",
"pm10": 11,
"pm25": 8,
"no2": 1
…Pogoji uporabe
- Podatki so iz javnih virov (SURS in drugi, navedeni pri vsakem kazalniku v polju
source). Ob uporabi navedi izvorni vir in to stran: »MCBOT, mcbot.si, po podatkih SURS«; pri drugih virih namesto SURS navedi vir iz odgovora. - Izračunani kazalniki (formula), desezonirane serije, percentili, položaji in signali so izdelek te strani in niso uradni podatki. Pred objavo številko preveri pri izvornem viru.
- Vmesnik je brezplačen in brez ključa, namenjen prikazom in člankom z zmernim številom zahtev. Množično prenašanje ni dovoljeno; za celotne tabele uporabi SiStat in druge izvorne vire.
- Oblika odgovorov se lahko spremeni z novo različico teme; spremembe so zapisane v dokumentaciji teme.
Omejitve
- Največ 60 zahtev na minuto z enega naslova IP za poti
/wp-json/mvs/v1/; ob prekoračitvi strežnik vrne429s sporočilom, čez koliko sekund lahko poskusiš znova. - Odgovori nosijo
Cache-Control(5 minut) inETag; podatki se osvežijo največ enkrat na dan, zato ni razloga za pogostejše poizvedovanje. - Pot
/seriesvrne največ 12 območij v enem klicu (parameterareas).
Izvoz CSV
Vsak prikaz primerjalnika je mogoče prenesti kot CSV (podpičje, decimalna vejica, UTF-8 z oznako BOM – odpre se v slovenskem Excelu): poti /primerjava/ dodaj parameter izvoz=csv, na primer https://mcbot.si/primerjava/?a=neto_placa&izvoz=csv. Trenutno izvoz je na voljo urednikom; omejitev je 10 izvozov na uro z enega naslova. Datoteka ima v zadnjih vrsticah vir in navedbo.