Základy
Rychlý start: api.php?limit=5 vrátí pět naposledy změněných tisků.
- Adresa
https://cosepece.cz/api.php
- Metoda
- jen
GET, jen čtení
- Formát
- JSON v UTF-8 (
Content-Type: application/json), české znaky nejsou escapované
- CORS
Access-Control-Allow-Origin: * – jde volat přímo z prohlížeče na jiném webu
- Cache
Cache-Control: public, max-age=300 – odpověď se může 5 minut opakovat
- Aktualizace
- data se obnovují z psp.cz a Úřadu vlády zhruba každou hodinu; čas posledního běhu je v poli
aktualizovano
- Období
- jen aktuální volební období Sněmovny
Každá odpověď má stejnou obálku:
{
"verze": 1, // verze formátu
"zdroj": "https://cosepece.cz/",
"aktualizovano": "2026-11-19 15:01:06", // poslední synchronizace dat
"tisky": [ … ] // nebo "tisk", "upozorneni", "pripravovane"
}
Stabilita: v rámci verze 1 můžeme přidávat nová pole, ale existující neodebereme ani nepřejmenujeme. Nekompatibilní změnu označíme novou verzí a oznámíme ji v přehledu změn. Neznámá pole proto ignorujte.
Adresy
GET api.php
Tisky. Návrhy zákonů aktuálního volebního období seřazené od poslední změny, se skóre a důvody.
Filtry: since, min_score, zakon, limit
Vyzkoušet: api.php?limit=3
Ukázka odpovědi (zkrácená, živá data)
{
"verze": 1,
"zdroj": "https://cosepece.cz/",
"aktualizovano": "2026-11-21 14:59:43",
"tisky": [
{
"ct": 372,
"obdobi": 10,
"nazev": "Novela z. o sociálně-právní ochraně dětí",
"uplny_nazev": "Návrh poslanců Václava Pláteníka a Marie Krškové na vydání zákona, kterým se mění zákon č. 359/1999 Sb., o sociálně-právní ochraně dětí, …",
"typ_navrhu": "poslanecký",
"navrhovatel": "Pláteník V., Kršková M.",
"faze": "U vlády",
"predlozeno": "2026-11-16",
"posledni_zmena": "2026-11-20 00:00:00",
"zakony": [
"359/1999"
],
"skore": 15,
"uroven": "normal",
"duvody": [
{
"klic": "p90_requested",
"body": 10,
"popis": "Navrženo schválit už v 1. čtení (§ 90 odst. 2)"
},
{
"klic": "mp_bill",
"body": 5,
"popis": "Poslanecký návrh – text nepřipravovalo ministerstvo v připomínkovém řízení (zatím nepostoupil do 2. čtení)"
}
],
"priznaky": [
"Poslanecký návrh",
"Navrženo § 90/2"
],
"url": "https://cosepece.cz/tisk.php?ct=372",
"psp_url": "https://www.psp.cz/sqw/historie.sqw?o=10&T=372"
}
]
}
GET api.php?tisk={číslo}
Detail tisku. Jeden tisk: vše jako v seznamu a navíc hlasování ve Sněmovně (i podle klubů), upozornění a stav rozboru textů.
Vyzkoušet: api.php?tisk=48
Ukázka odpovědi (zkrácená, živá data)
{
"verze": 1,
"zdroj": "https://cosepece.cz/",
"aktualizovano": "2026-11-21 14:59:43",
"tisk": {
"ct": 48,
"obdobi": 10,
"nazev": "Novela z. o rostlinolékařské péči",
"uplny_nazev": "Vládní návrh zákona, kterým se mění zákon č. 326/2004 Sb., o rostlinolékařské péči a o změně některých souvisejících zákonů, ve znění poz…",
"typ_navrhu": "vládní",
"navrhovatel": "ministr zemědělství",
"faze": "3. čtení",
"predlozeno": "2025-12-01",
"posledni_zmena": "2026-11-03 00:00:00",
"zakony": [
"326/2004"
],
"skore": 65,
"uroven": "major",
"duvody": [
{
"klic": "ai",
"body": 24,
"popis": "Rozbor PN č. 824 (David Pražák): závažnost 8/10 – Rozsáhlá věcná úprava lesního zákona včetně nových přestupků, pravomocí Vojenské polici…"
}
],
"priznaky": [
"Zkrácená lhůta",
"Nával PN"
],
"url": "https://cosepece.cz/tisk.php?ct=48",
"psp_url": "https://www.psp.cz/sqw/historie.sqw?o=10&T=48",
"hlasovani": [
{
"id": 87504,
"datum": "2026-05-27 11:00",
"vysledek": "přijato",
"pro": 90,
"proti": 15,
"zdrzel": 18,
"kvorum": 76,
"kluby": [
{
"klub": "ANO2011",
"pro": 69,
"proti": 0,
"zdrzel_nehlasoval": 1,
"nepritomen": 10
}
],
"psp_url": "https://www.psp.cz/sqw/hlasy.sqw?g=87504"
}
],
"upozorneni": [
{
"id": "surge:48:31091",
"typ": "surge",
"ct": 48,
"obdobi": 10,
"datum": "2026-10-20 15:47:34",
"titulek": "Nával pozměňovacích návrhů: Novela z. o rostlinolékařské péči",
"text": "11 pozměňovacích návrhů od 3 poslanců: Marian Jurečka (9), David Pražák, Karel Tureček.",
"skore": 70,
"url": "https://cosepece.cz/tisk.php?ct=48"
}
],
"rozbor_textu": {
"posouzeno": 30,
"celkem": 31
},
"senat": null
}
}
GET api.php?upozorneni=1
Upozornění. Upozornění na kroky v projednávání (nové pozměňovací návrhy, § 90/2, zkrácené lhůty, schválení, vyhlášení) a na připravované zákony u vlády (krátké připomínky, mimo plán), od nejnovějších. Bez min_score jen od úrovně „Pozor“ (25 bodů).
Filtry: since, min_score, zakon, ct, limit
Vyzkoušet: api.php?upozorneni=1&limit=3
Ukázka odpovědi (zkrácená, živá data)
{
"verze": 1,
"zdroj": "https://cosepece.cz/",
"aktualizovano": "2026-11-21 14:59:43",
"upozorneni": [
{
"id": "surge:300:31360",
"typ": "surge",
"ct": 300,
"obdobi": 10,
"datum": "2026-11-19 19:40:46",
"titulek": "Nával pozměňovacích návrhů: Novela z. - zákoník práce",
"text": "Dne 19. 11. 2026 podáno 11 pozměňovacích návrhů. 11 pozměňovacích návrhů od 1 poslance: Marian Jurečka (11).",
"skore": 59,
"url": "https://cosepece.cz/tisk.php?ct=300"
}
]
}
GET api.php?pripravovane=1
Připravované zákony. Návrhy zákonů, které připravuje vláda a Sněmovna je ještě nedostala, od nejpokročilejší fáze. S parametrem druh=narizeni připravovaná nařízení vlády (ta do Sněmovny nejdou). Jiné filtry nemá.
Vyzkoušet: api.php?pripravovane=1
Ukázka odpovědi (zkrácená, živá data)
{
"verze": 1,
"zdroj": "https://cosepece.cz/",
"aktualizovano": "2026-11-21 14:59:43",
"pripravovane": [
{
"pid": "KORNDQQFC3B1",
"druh": "zakon",
"nazev": "Návrh zákona, kterým se mění zákon č. 76/2002 Sb., o integrované prevenci a omezování znečištění, o integrovaném registru znečišťování a …",
"resort": "Ministerstvo životního prostředí",
"faze": "schvaleno",
"stav_odok": "AS – zapracované změny schváleny",
"zalozeno": "2026-01-27",
"zmeneno": "2026-11-20",
"pripominky": {
"od": "2026-01-27",
"do": "2026-03-03",
"dni": 35,
"mist": 103
},
"vlada_projednala": "2026-10-19",
"mimo_plan": false,
"vyjimka": false,
"popis": "Hlavním cílem předkládaného návrhu zákona je zajištění transpozice směrnice Evropského parlamentu a Rady (EU) 2024/1785 ze dne 24. dubna …",
"duvod": "Plán legislativních prací vlády na rok 2025",
"veklep_url": "https://odok.gov.cz/portal/veklep/material/KORNDQQFC3B1/"
}
]
}
Filtry
Parametry v adrese, lze je kombinovat (např. api.php?zakon=159/2006&min_score=25). Stejné filtry platí pro RSS.
| Parametr | Hodnota | Význam | Příklad |
since | YYYY-MM-DD | jen tisky změněné / upozornění od tohoto dne (včetně) | since=2026-11-01 |
min_score | 0–100 | jen se skóre aspoň tolik (alias min) | min_score=50 |
zakon | číslo/rok | jen tisky, které mění daný zákon, a upozornění k nim i k připravovaným změnám tohoto zákona (alias law) | zakon=159/2006 |
ct | číslo | jen upozornění k tomuto tisku | ct=221 |
limit | 1–500 | nejvýš tolik položek (výchozí 100) | limit=20 |
Popis polí
Tisk
| Pole | Typ | Význam |
ct | číslo | číslo sněmovního tisku (v každém volebním období se čísluje znovu od 1) |
obdobi | číslo | volební období (10 = od roku 2025) |
nazev | text | krátký název podle psp.cz |
uplny_nazev | text | úplný název návrhu |
typ_navrhu | text | předkladatel: vládní, poslanecký, senátní, krajský |
navrhovatel | text | navrhovatel podle psp.cz |
faze | text | fáze projednávání (číselník níže) |
predlozeno | datum | den předložení Sněmovně (YYYY-MM-DD) |
posledni_zmena | datum a čas | poslední krok v historii tisku (YYYY-MM-DD HH:MM:SS) |
zakony | pole textů | čísla zákonů, které návrh mění (např. 159/2006) |
skore | číslo | skóre závažnosti postupu 0–100 |
uroven | text | major (od 50), watch (od 25), normal |
duvody | pole objektů | body skóre: klic (číselník níže), body, popis (čitelný důvod v češtině) |
priznaky | pole textů | štítky jako na webu (Poslanecký návrh, Zkrácená lhůta…) |
url | adresa | detail tisku na tomto webu |
psp_url | adresa | historie tisku na psp.cz |
Detail tisku (navíc)
| Pole | Typ | Význam |
hlasovani | pole objektů | id, datum, vysledek (přijato / zamítnuto), pro, proti, zdrzel, kvorum, kluby (klub, pro, proti, zdrzel_nehlasoval, nepritomen), psp_url |
upozorneni | pole objektů | upozornění k tisku (pole jako níže) |
rozbor_textu | objekt | posouzeno / celkem: kolik textů (návrh a pozměňovací návrhy) už posoudil rozbor AI |
senat | objekt nebo null | průchod Senátem: doruceno, vysledek (schvalen, vracen, zamitnut, nezabyval, necinny, bez_usneseni nebo null), rozhodnuto, lhuta_do (30 dní od doručení, dokud Senát nerozhodl), snemovna (setrvala = přehlasovala Senát, prijala = přijala jeho znění), snemovna_datum, veto, veto_prehlasovano, popis (věty česky); null = návrh do Senátu nedošel |
Upozornění
| Pole | Typ | Význam |
id | text | jednoznačný klíč upozornění (vhodný k odstranění duplicit) |
typ | text | druh upozornění (číselník níže) |
ct | číslo nebo null | číslo tisku; null u upozornění na připravovaný zákon (typ prep_…), který číslo tisku ještě nemá |
obdobi | číslo | volební období tisku |
datum | datum a čas | kdy událost nastala |
titulek | text | nadpis upozornění |
text | text | krátký popis |
skore | číslo | skóre tisku + příplatek za druh upozornění; u připravovaného zákona jen body podle druhu (prep_velmi 50, prep_kratke 30, prep_plan 30, prep_vlada 0, prep_narizeni 30) |
url | adresa | odkaz na web (detail tisku; u připravovaného zákona stránka připravovaných zákonů nebo VeKLEP) |
Připravovaný zákon
| Pole | Typ | Význam |
pid | text | identifikátor materiálu v eKLEP/VeKLEP |
druh | text | zakon (návrh zákona) nebo narizeni (návrh nařízení vlády, s parametrem druh=narizeni) |
nazev | text | název materiálu |
resort | text | ministerstvo nebo úřad, který návrh připravuje |
faze | text | pripominky, po_pripominkach, vlada, schvaleno |
stav_odok | text | původní stav v datech Úřadu vlády |
zalozeno | datum | založení první verze materiálu |
zmeneno | datum | poslední změna kterékoli verze |
pripominky | objekt nebo null | od, do, dni, mist (počet připomínkových míst); null = připomínkové řízení nenalezeno |
vlada_projednala | datum nebo null | schůze vlády |
mimo_plan | ano/ne | předloženo mimo plán legislativních prací |
vyjimka | ano/ne | udělena výjimka (např. z povinnosti hodnocení dopadů) |
popis | text | o čem návrh je (od předkladatele) |
duvod | text | důvod předložení (od předkladatele) |
veklep_url | adresa | materiál ve VeKLEP: texty, připomínky, stanovisko Legislativní rady vlády |
Číselníky
Klíče důvodů skóre (duvody[].klic)
Body a podmínky jednotlivých signálů popisuje stránka Jak hodnotíme.
mp_bill | poslanecký návrh |
senate_bill | senátní návrh |
region_bill | krajský návrh |
p90_passed | schváleno v 1. čtení |
p90_requested | návrh na § 90/2 |
deadline_cut | zkrácená lhůta |
short_gap | málo času na PN |
late_pn | PN na poslední chvíli |
surge | nával PN |
pn_other_law | přílepek |
pn_large | rozsáhlý PN |
retro_deadline | lhůta a zpětné použití |
pn_many | více sporných PN |
ai_bill | sporný text návrhu |
ai | sporné pozměňovací návrhy |
topic | citlivá oblast |
omnibus | souhrnná novela |
watched | sledovaný zákon |
Druhy upozornění (typ)
newbill | nový poslanecký nebo senátní návrh |
p90 | navrženo nebo schváleno podle § 90 odst. 2 (bez 2. a 3. čtení) |
cut | zkrácení lhůty pro projednání |
pn | nové pozměňovací návrhy |
surge | nával pozměňovacích návrhů najednou |
passed | schváleno Sněmovnou |
law | vyhlášeno ve Sbírce zákonů |
senate | Senát návrh zamítl, vrátil s pozměňovacími návrhy, odmítl se jím zabývat nebo se nevyjádřil |
override | Sněmovna přehlasovala Senát nebo veto prezidenta |
prep_velmi | připravovaný zákon: připomínkové řízení kratší než 10 dní |
prep_kratke | připravovaný zákon: připomínkové řízení kratší než 3 týdny |
prep_plan | připravovaný zákon: předloženo mimo plán legislativních prací vlády |
prep_vlada | připravovaný zákon: vláda návrh schválila |
prep_narizeni | připravované nařízení vlády: připomínkové řízení kratší než 10 dní |
Fáze tisku (faze)
Podáno · Organizační výbor · U vlády · Stanovisko vlády · 1. čtení · 2. čtení · 3. čtení · Schváleno Sněmovnou · V Senátu · Sněmovna po Senátu · U prezidenta · Sněmovna po vetu · Vyhlášeno · Vzat zpět · Zamítnuto · Vráceno předkladateli
Fáze připravovaného zákona
pripominky v připomínkovém řízení · po_pripominkach vypořádání připomínek · vlada předloženo vládě · schvaleno schváleno vládou, čeká na předložení Sněmovně
Chyby
Chyba vrací HTTP kód a objekt s polem error (bez obálky):
| Kód | Kdy | Příklad |
| 400 | chybný filtr | {"error": "since musí být datum ve tvaru YYYY-MM-DD"} |
| 404 | tisk v aktuálním období neexistuje | {"error": "Tisk nenalezen"} |
| 429 | příliš mnoho dotazů (viz limity); hlavička Retry-After říká, za kolik sekund to zkusit znovu | {"error": "Příliš mnoho dotazů…"} |
| 5xx | chyba serveru nebo údržba – zkuste to později | |
Limity a slušné chování
- Nejvýš 60 dotazů za minutu z jedné IP adresy (RSS 30, webové stránky 240). Při překročení vrátíme 429 s hlavičkou
Retry-After.
- Data se mění zhruba jednou za hodinu, častější stahování nic nového nepřinese. Pro průběžné sledování stačí dotaz s
since jednou za hodinu, nebo RSS.
- Celé období se vejde do jednoho dotazu (
limit=500); není potřeba stahovat tisk po tisku.
- Pokud potřebujete víc (výzkum, hromadná analýza), napište nám.
Pro AI asistenty (MCP)
Pro Claude a další AI asistenty je k dispozici MCP server s 21 nástroji nad návrhy zákonů, jejich texty, pozměňovacími návrhy, rozpravami ve Sněmovně a hlasováním. Návod k připojení a přehled nástrojů je na stránce Pro AI asistenty (MCP).
Příklady kódu
Příkazová řádka (curl + jq)
curl -s 'https://cosepece.cz/api.php?min_score=50&limit=500' | jq -r '.tisky[] | "\(.skore)\t\(.ct)\t\(.nazev)"'
JavaScript (prohlížeč i Node.js)
const res = await fetch('https://cosepece.cz/api.php?upozorneni=1&since=2026-11-01');
const { upozorneni } = await res.json();
for (const a of upozorneni) console.log(a.datum, a.titulek, a.url);
Python
import requests
data = requests.get('https://cosepece.cz/api.php', params={'tisk': 221}, timeout=30).json()
tisk = data['tisk']
print(tisk['skore'], tisk['uroven'])
for d in tisk['duvody']:
print(f"{d['body']:>3} {d['popis']}")
Zdroje a podmínky
- Data o tiscích, krocích, pozměňovacích návrzích a hlasování pocházejí z otevřených dat Poslanecké sněmovny, příprava u vlády z otevřených dat Úřadu vlády.
- Skóre, důvody a upozornění počítá tento web automaticky podle veřejné metodiky; rozbory textů dělá jazykový model a mohou se mýlit. Hodnotíme postup a formu, ne politický obsah.
- Při dalším použití uveďte zdroj (Hlídač zákonů, cosepece.cz) a u přebíraných údajů i původní zdroj.
- Zdrojový kód je na GitHubu pod licencí AGPL-3.0. Chyby a nápady na nová data: GitHub issues.