Name: Archív slovenských volebných dát
Creator: chcemvolit.sk
License: https://creativecommons.org/licenses/by/4.0/

Prehľad endpointov a dátová schéma

Všetky endpointy sú verejne prístupné cez HTTP GET a vracajú statické dáta priamo z produkčného buildu. V hlavičke je povolený CORS pre všetky domény.

JSON/api/prieskumy.json

133 záznamov

Všetky prieskumy v archíve. Jeden záznam zodpovedá jednému prieskumu, namerané hodnoty strán sú v poli results.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (15)

Prehľad atribútov pre endpoint /api/prieskumy.json
Pole	Typ	Význam
`id`	string	Jedinečný identifikátor prieskumu odvodený z dátumu a agentúry (napr. 2026-07-23-focus).
`agency_id`	string	Identifikátor agentúry, zodpovedá záznamu v /api/agentury.json.
`commissioner`	string \| null	Zadávateľ prieskumu. null znamená zber na vlastné náklady agentúry.
`field_start`	string (ISO)	Prvý deň terénneho zberu dát v tvare YYYY-MM-DD.
`field_end`	string (ISO)	Posledný deň terénneho zberu dát v tvare YYYY-MM-DD.
`published`	string (ISO)	Dátum oficiálneho zverejnenia výsledkov v tvare YYYY-MM-DD.
`sample_size`	number	Počet respondentov v reprezentatívnej vzorke.
`method`	string	Metóda zberu: cati (telefonicky), online, f2f (osobne) alebo mixed (kombinovane).
`poll_type`	string	Typ prieskumu: volebny_model alebo preferencie.
`election_type`	string	Typ volieb: nrsr, vuc, komunalne, ep alebo prezident.
`scope`	string	Územný rozsah: "SR" pre celoštátny, inak kód samosprávneho kraja.
`results`	Array<{ party_id, pct }> \| null	Namerané percentá jednotlivých strán. V čase volebného moratória je pole null.
`source_url`	string (URL)	Odkaz na primárny zdroj, z ktorého čísla pochádzajú.
`archive_url`	string (URL) \| null	Odkaz na archivovanú kópiu primárneho zdroja (Internet Archive a pod.).
`is_mock`	boolean	Príznak, či ide o vymyslený vývojový záznam.

CSV/api/prieskumy.csv

1 492 riadkov

Prieskumy v dlhom formáte (tidy data). Jeden riadok zodpovedá výsledku jednej strany v jednom prieskume. Vhodné pre Pandas, R a tabuľkové procesory.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (15)

Prehľad atribútov pre endpoint /api/prieskumy.csv
Pole	Typ	Význam
`poll_id`	string	Identifikátor prieskumu.
`agency_id`	string	Identifikátor agentúry.
`agency_name`	string	Čitateľný názov agentúry (napr. Focus, AKO).
`field_start`	string (ISO)	Prvý deň zberu v tvare YYYY-MM-DD.
`field_end`	string (ISO)	Posledný deň zberu v tvare YYYY-MM-DD.
`published`	string (ISO)	Dátum zverejnenia v tvare YYYY-MM-DD.
`sample_size`	number	Veľkosť vzorky respondentov.
`method`	string	Metodika zberu dát (cati, online, f2f, mixed).
`poll_type`	string	Typ prieskumu (volebny_model, preferencie).
`election_type`	string	Typ volieb (nrsr, vuc, komunalne, ep, prezident).
`scope`	string	Územný rozsah (SR alebo kód kraja).
`party_id`	string	Identifikátor politickej strany.
`pct`	number	Nameraná hodnota v percentách.
`source_url`	string (URL)	Odkaz na primárny zdroj.
`is_mock`	boolean	Príznak vymysleného záznamu.

JSON/api/vysledky.json

107 záznamov

Oficiálne volebné výsledky na všetkých územných úrovniach (celoštátna úroveň, kraje, okresy a vybrané mestá).

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (10)

Prehľad atribútov pre endpoint /api/vysledky.json
Pole	Typ	Význam
`id`	string	Identifikátor územného výsledku (napr. nrsr-2023-sr, nrsr-2023-sk010).
`election_id`	string	Identifikátor volieb, ku ktorým výsledok patrí (napr. nrsr-2023).
`scope`	string	Kód územia ("SR", kód kraja, okresu alebo obce zo Štatistického úradu SR).
`registered_voters`	number	Počet zapísaných voličov v danom území.
`participation_pct`	number	Volebná účasť v percentách.
`valid_votes`	number	Celkový počet odovzdaných platných hlasov.
`rows`	Array<{ party_id, votes, pct, seats }>	Zoznam hlasov, percent a pridelených mandátov jednotlivých kandidujúcich subjektov.
`source_url`	string (URL)	Odkaz na oficiálny zdroj údajov zo Štatistického úradu SR.
`archive_url`	string (URL) \| null	Odkaz na archivovanú kópiu oficiálneho zdroja.
`is_mock`	boolean	Príznak vymysleného záznamu.

JSON/api/strany.json

17 záznamov

Register politických subjektov vrátane kanonickej brandovej farby, odvodených kontrastných tónov a historických názvov s časovou platnosťou.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (10)

Prehľad atribútov pre endpoint /api/strany.json
Pole	Typ	Význam
`id`	string	Trvalý identifikátor strany (slug, napr. ps, smer, kdh).
`name`	string	Aktuálny oficiálny názov podľa registra politických strán.
`abbr`	string	Oficiálna skratka používaná v grafoch a zoznamoch.
`color`	string (HEX)	Oficiálna brandová farba subjektu v tvare #RRGGBB.
`color_odvodeny_svetly`	string (HEX)	OKLCH odtieň so zaručeným kontrastom minimálne 4,5:1 na svetlom podklade.
`color_odvodeny_tmavy`	string (HEX)	OKLCH odtieň so zaručeným kontrastom minimálne 4,5:1 na tmavom podklade.
`ico`	string \| null	IČO subjektu z registra (8 číslic) alebo null.
`predecessor`	string \| null	Identifikátor strany, z ktorej táto vznikla.
`successor`	string \| null	Identifikátor nástupníckeho subjektu.
`aliases`	Array<{ name, abbr, from, to }>	Historické názvy a skratky s intervalom platnosti.

JSON/api/agentury.json

7 záznamov

Prehľad prieskumných agentúr v archíve, ich prevažujúca metodika, rok vzniku a profesijné členstvo v SAVA a ESOMAR.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (8)

Prehľad atribútov pre endpoint /api/agentury.json
Pole	Typ	Význam
`id`	string	Trvalý identifikátor agentúry (napr. focus, ako, ipsos).
`name`	string	Oficiálny obchodný názov agentúry.
`sava`	boolean	Členstvo v Slovenskej asociácii výskumných agentúr (SAVA).
`esomar`	boolean	Členstvo v medzinárodnej organizácii ESOMAR.
`typical_method`	string	Prevažujúci spôsob zberu dát (cati, online, f2f, mixed).
`founded`	number \| null	Rok založenia agentúry.
`website`	string (URL) \| null	Oficiálna webová stránka agentúry.
`methodology_note`	string \| null	Vecný popis metodických postupov agentúry.

JSON/api/volby.json

5 záznamov

Zoznam archivovaných a nadchádzajúcich volieb, termíny hlasovania a presné hranice moratória podľa zákona.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (10)

Prehľad atribútov pre endpoint /api/volby.json
Pole	Typ	Význam
`id`	string	Identifikátor volieb (napr. nrsr-2023, spojene-2026).
`name`	string	Oficiálny názov volieb.
`election_type`	string	Typ volieb (nrsr, vuc, komunalne, ep, prezident).
`date`	string (ISO)	Deň konania volieb v tvare YYYY-MM-DD.
`moratorium_start`	string (ISO)	Začiatok okna moratória v ISO 8601 s explicitným časovým posunom.
`moratorium_end`	string (ISO)	Koniec okna moratória (skončenie hlasovania) v ISO 8601 s posunom.
`seats_total`	number \| null	Celkový počet volených mandátov (150 pre NR SR, inak null).
`has_results`	boolean	Či sú k voľbám v archíve evidované oficiálne výsledky.
`source_url`	string (URL) \| null	Odkaz na oficiálny zdroj.
`is_mock`	boolean	Príznak vymysleného záznamu.

JSON/api/kandidati.json

2 984 záznamov

Overený register (~2984): primátori BA/ZA/TT/MT/NR/TN/Handlová/Modra/Humenné/Pezinok/Malacky/Galanta/Senec/Sereď/Svätý Jur/Ilava/Nová Dubnica/Žiar nad Hronom/Stará Ľubovňa/Kežmarok/Trebišov/Čadca/Nové Mesto nad Váhom/Dunajská Streda/Michalovce/Skalica, starosta Bernolákovo/Ivanka pri Dunaji/Báhoň/Blatnica/Zohor/Vyšný Klátov/Lozorno/Liptovský Peter/Vrbovce/Košeca/Báb/Veľké Leváre/Pusté Čemerné/Mokrá Lúka/Zbehy/Košice - Poľov/Limbach/Kvetoslavov/Záhorská Bystrica/Predajná/Slavkovce/Hamuliakovo/Vyšná Myšľa/Suché/Vyšná Šebastová/Ľubotice/Baka/Veľké Držkovce/Červený Hrádok/Polomka/Malcov/Hruštín/Bátovce/Rohožník/Nesluša/Ladce/Oravský Podzámok/Teplička/Bzenica, MsZ Bratislava (VO 1–9 a čiastočne VO 10), MsZ Rimavská Sobota / Handlová / Modra / Humenné / Pezinok / Malacky / Galanta / Senec / Sereď / Svätý Jur / Ilava / Nová Dubnica / Žiar nad Hronom / Stará Ľubovňa / Kežmarok / Trebišov / Čadca / Nové Mesto nad Váhom / Dunajská Streda / Michalovce / Skalica, MZ Košice - Poľov / Záhorská Bystrica, OZ Bernolákovo / Ivanka pri Dunaji / Báhoň / Blatnica / Zohor / Vyšný Klátov / Lozorno / Liptovský Peter / Vrbovce / Košeca / Báb / Veľké Leváre / Pusté Čemerné / Mokrá Lúka / Zbehy / Limbach / Kvetoslavov / Predajná / Slavkovce / Hamuliakovo / Vyšná Myšľa / Suché / Vyšná Šebastová / Ľubotice / Baka / Veľké Držkovce / Červený Hrádok / Polomka / Malcov / Hruštín / Bátovce / Rohožník / Nesluša / Ladce / Oravský Podzámok / Teplička / Bzenica, predseda aj poslanci VÚC BSK/TTSK/TSK (277+214+236). Košice (mesto) neoficiálne (neimportované); KSK PDF neoverené (403); KE/PO/BB/Poprad/Piešťany § 178 primátor ešte nie. Prázdne vyhľadávanie nie je dôkaz neexistencie kandidáta.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (12)

Prehľad atribútov pre endpoint /api/kandidati.json
Pole	Typ	Význam
`id`	string	Identifikátor záznamu odvodený z názvu súboru.
`name`	string	Celé meno kandidáta podľa oficiálnej listiny.
`party_id`	string \| null	Identifikátor strany z /api/strany.json, alebo null.
`list_name`	string \| null	Označenie listiny, koalície alebo nezávislého kandidáta.
`election_id`	string	Identifikátor volieb (napr. spojene-2026).
`scope`	string	Územný kód podľa ŠÚ SR (kraj, okres alebo obec).
`office`	string	Typ mandátu: starosta, primator, poslanec_obec, predseda_vuc, poslanec_vuc.
`list_position`	number \| null	Poradie na listine, ak je známe.
`source_url`	string (URL)	Odkaz na oficiálny zoznam kandidátov.
`archive_url`	string (URL) \| null	Archivovaná kópia zdroja, ak existuje.
`is_mock`	boolean	Príznak vymysleného záznamu (musí byť false v produkcii).
`notes`	string \| null	Voliteľná poznámka k záznamu.

JSON/api/uzemia.json

194 záznamov

Hierarchický register územných celkov: 8 krajov, 79 okresov a mestá. Slúži aj na rýchle klientske vyhľadávanie.

Zobraziť v prehliadači Stiahnuť súbor

Dátová schéma a popis polí (10)

Prehľad atribútov pre endpoint /api/uzemia.json
Pole	Typ	Význam
`id`	string	Identifikátor územia (slug).
`nazov`	string	Oficiálny slovenský názov územia s diakritikou.
`hladat`	string	Normalizovaný názov malými písmenami bez diakritiky pre vyhľadávanie.
`typ`	string	Typ územnej jednotky: "kraj", "okres" alebo "obec".
`kod`	string	Kód územia podľa Štatistického úradu SR (NUTS 3 pre kraje).
`okres`	string \| null	Názov nadradeného okresu pre obce.
`kraj`	string \| null	Názov nadradeného samosprávneho kraja.
`obyvatelov`	number \| null	Počet obyvateľov podľa posledného sčítania.
`mesto`	boolean	Príznak, či obec disponuje štatútom mesta.
`detail`	boolean	Príznak existencie samostatnej statickej podstránky s výsledkami.

Štruktúra JSON obálky

Každý JSON endpoint vracia štandardnú obálku. Samotné záznamy sú vždy uložené v poli data. Obálka obsahuje metadáta o licencii, čase generovania a informáciu, či odpoveď obsahuje vymyslené vývojové záznamy.

{
  "licencia": "CC BY 4.0",
  "zdroj": "https://www.chcemvolit.sk",
  "atribucia": "Oficiálne volebné výsledky pochádzajú zo Štatistického úradu SR. Pri ďalšom použití uveďte zdroj.",
  "generovane": "2026-07-30T19:00:00.000Z",
  "pocet": 133,
  "obsahuje_vymyslene_zaznamy": false,
  "data": [
    {
      "id": "2026-07-23-focus",
      "agency_id": "focus",
      "field_start": "2026-07-16",
      "field_end": "2026-07-23",
      "published": "2026-07-26",
      "sample_size": 1012,
      "method": "cati",
      "poll_type": "volebny_model",
      "election_type": "nrsr",
      "scope": "SR",
      "results": [ ... ],
      "source_url": "https://...",
      "archive_url": null,
      "is_mock": false
    }
  ]
}

Príznak is_mock je súčasťou každého jednotlivého záznamu. Kto si dáta stiahne a spracuje offline, má v samotnom súbore jednoznačnú informáciu o povahe údajov.

Príklady použitia

Vďaka otvorenému formátu a povolenému CORS môžete dáta načítať priamo zo svojich aplikácií, analytických skriptov alebo terminálu.

Príkazový riadok (cURL a jq)

# Stiahnutie zoznamu prieskumov a zobrazenie prvého záznamu
curl -s https://www.chcemvolit.sk/api/prieskumy.json | jq .data[0]

# Stiahnutie zoznamu strán a extrakcia skratiek a farieb
curl -s https://www.chcemvolit.sk/api/strany.json | jq '.data[] | {abbr, color}'

Python (pandas a requests)

import pandas as pd
import requests

# 1. Priame načítanie CSV do pandas DataFrame
df = pd.read_csv('https://www.chcemvolit.sk/api/prieskumy.csv')
print(f"Načítaných riadkov: {len(df)}")
print(df.head())

# 2. Načítanie JSON obálky
response = requests.get('https://www.chcemvolit.sk/api/prieskumy.json')
payload = response.json()
print("Licencia:", payload['licencia'])
print("Počet záznamov:", payload['pocet'])

JavaScript / TypeScript (Fetch API)

// Načítanie prieskumov v prehliadači alebo v Node.js
const response = await fetch('https://www.chcemvolit.sk/api/prieskumy.json');
if (!response.ok) {
  throw new Error('Nepodarilo sa načítať dáta');
}

const { data, obsahuje_vymyslene_zaznamy } = await response.json();
console.log('Počet prieskumov v archíve:', data.length);
console.log('Obsahuje vymyslené záznamy:', obsahuje_vymyslene_zaznamy);

Správanie počas volebného moratória

V okne volebného moratória podľa § 17 zákona č. 181/2014 Z. z. sa namerané hodnoty z odpovede vypúšťajú. V JSON endpointoch je pole resultsnastavené na null a v obálke pribudne poznamkas dátumom a časom skončenia moratória.

V CSV exporte sa v čase moratória vracia súbor s vysvetľujúcim textom. Zákaz zverejňovania sa vzťahuje na výsledky volebných prieskumov bez ohľadu na to, či ich čitateľ sleduje v prehliadači alebo sťahuje cez API. Metadáta prieskumov (agentúra, obdobie zberu, veľkosť vzorky) zostávajú prístupné.

Licencia a atribúcia

Dáta sú dostupné pod licenciou CC BY 4.0. Môžete ich slobodne používať, upravovať aj komerčne šíriť za podmienky uvedenia zdroja.

Oficiálne volebné výsledky pochádzajú zo Štatistického úradu SR a podliehajú jeho podmienkam použitia. Pri ďalšom šírení uveďte ŠÚ SR ako pôvodného autora dát a chcemvolit.sk ako spracovateľa archívu.

Prieskumy verejnej mienky sú duševným vlastníctvom agentúr, ktoré ich vykonali. Pri citovaní čísel vždy uvádzajte agentúru, presné obdobie terénneho zberu a veľkosť vzorky respondentov, nie samotné izolované percento.