API a MCP server
Zdarma, s tokenem. Data o českých telefonních číslech, firmách a institucích nabízíme vývojářům, výzkumníkům a službám na ochranu před podvody. Token vydáváme ručně na požádání e-mailem, limit je 1000 dotazů denně.
Jak získat token
Napište na info@neznamecisla.cz a uveďte:
- kdo jste (firma, projekt nebo jméno) a kontaktní e-mail,
- k čemu data použijete a kde se budou zobrazovat,
- odhad počtu dotazů denně.
Token posíláme e-mailem, obvykle do několika pracovních dnů. Žádosti, jejichž účelem je marketingové oslovování, odmítáme.
REST API
Každý dotaz musí obsahovat hlavičku Authorization: Bearer <token>. Odpovědi jsou v JSON. Zbývající počet dotazů na dnešní den je v hlavičce X-RateLimit-Remaining, po vyčerpání limitu API vrací stav 429.
Telefonní číslo
curl -H "Authorization: Bearer nc_…" https://neznamecisla.cz/api/v1/cislo/777123456
Typ čísla, oblast, držitel přídělu podle registru ČTÚ, oficiální linky, cena u placených linek, majitelé z veřejných rejstříků (každý se zdrojem, licencí a datem), hodnocení nebezpečnosti a posledních 20 komentářů. Číslo lze zadat v libovolném zápisu.
Firma nebo instituce podle IČO
curl -H "Authorization: Bearer nc_…" https://neznamecisla.cz/api/v1/firma/75032333
Telefony podle oboru a obce
curl -H "Authorization: Bearer nc_…" "https://neznamecisla.cz/api/v1/telefony/lekarny?obec=Brno"
Bez parametru obec vrátí seznam obcí s počty čísel. Obory: obecni-urady, lekarny, prakticti-lekari, detsti-lekari, zubari, gynekologove, lekari-specialiste, fyzioterapie, nemocnice, pohotovosti, veterinari, domovy-pro-seniory, pecovatelska-sluzba, policie, hasici, informacni-centra, knihovny, skoly, restaurace, kavarny, hotely, kadernictvi, autoservisy, posty, banky, obchody.
MCP server
Pro AI asistenty (Claude, ChatGPT, Cursor a další) je k dispozici MCP server se stejnými daty. Nabízí nástroje lookup_number, company_phones a phones_by_category.
Adresa: https://neznamecisla.cz/api/mcp (transport Streamable HTTP), token v hlavičce Authorization.
Claude Code:
claude mcp add --transport http neznamecisla https://neznamecisla.cz/api/mcp --header "Authorization: Bearer nc_…"
Konfigurace v JSON (Claude Desktop, Cursor a další):
{ "mcpServers": { "neznamecisla": { "type": "http", "url": "https://neznamecisla.cz/api/mcp",
"headers": { "Authorization": "Bearer nc_…" } } } }Do denního limitu se počítá jen volání nástrojů.
Licence dat
Část dat přebíráme z veřejných zdrojů a ta zůstávají pod svou původní licencí. Každý záznam v odpovědi proto nese pole source, licence a attribution. Licence zdroje má přednost a naše podmínky ji nijak neomezují.
| Zdroj | Licence | Uveďte |
|---|---|---|
| OpenStreetMap | ODbL 1.0 | © přispěvatelé OpenStreetMap |
| Národní registr poskytovatelů zdravotních služeb | CC BY 4.0 | NRPZS, Ministerstvo zdravotnictví ČR a ÚZIS ČR |
| Registr poskytovatelů sociálních služeb | otevřená data | Registr poskytovatelů sociálních služeb, MPSV |
| Centrální adresář knihoven | otevřená data | Centrální adresář knihoven, Národní knihovna ČR |
| Seznam lékáren SÚKL | otevřená data | Seznam lékáren, Státní ústav pro kontrolu léčiv |
| oficiální weby obcí a úřadů | veřejně uvedený údaj | oficiální web obce nebo úřadu (odkaz v poli url) |
| vlastní weby firem a poskytovatelů | veřejně uvedený údaj | web firmy nebo poskytovatele (odkaz v poli url) |
| otevřená data krajů | CC0 1.0 (infocentra Karlovarského kraje CC BY 4.0) | otevřená data krajů (Karlovarský, Královéhradecký, Liberecký, Olomoucký kraj) |
| Registr čísel ČTÚ | otevřená data | Český telekomunikační úřad |
| Hodnocení, komentáře a výpočty NeznáméČísla.cz | Podmínky API | NeznáméČísla.cz s odkazem |
Data z OpenStreetMap jsou pod licencí ODbL: databázi z nich odvozenou smíte šířit jen pod stejnou licencí a s uvedením „© přispěvatelé OpenStreetMap“. Data z NRPZS vyžadují uvedení zdroje podle CC BY 4.0. Jména fyzických osob přes API neposkytujeme.
Podmínky použití API
Platné od 19. 11. 2026. Použitím tokenu s nimi souhlasíte.
- Přístup. API je zdarma. Token je osobní a nepřenosný: patří jen žadateli, kterému jsme ho vydali, a jen pro účel uvedený v žádosti. Nezveřejňujte ho a nepoužívejte ho v kódu, který běží v prohlížeči nebo v mobilní aplikaci u uživatele.
- Limit. 1000 dotazů denně, pokud se nedohodneme jinak. Obcházet limit více tokeny nebo účty je zakázáno.
- Zakázané použití. Data nesmíte použít:
- k marketingovému nebo obchodnímu oslovování (telefonáty, SMS, e-maily) ani k sestavování kontaktních databází pro tento účel,
- k hromadnému stahování, systematickému kopírování databáze nebo jejímu dalšímu prodeji či poskytování,
- k profilování nebo sledování fyzických osob,
- k čemukoli, co je v rozporu se zákonem, zejména s ochranou osobních údajů a zákonem o elektronických komunikacích.
- Uvedení zdroje. Kde data zobrazujete, uveďte „Zdroj: NeznáméČísla.cz“ s odkazem na https://neznamecisla.cz a u převzatých údajů také text z pole
attribution. - Naše data. Hodnocení, komentáře a výpočty NeznáméČísla.cz smíte zobrazit uživatelům své služby. Ukládat je smíte nejvýš 30 dní (mezipaměť) a dál je poskytovat nesmíte. Pokud API přestane údaj vracet (např. na žádost majitele čísla), odstraňte ho i u sebe.
- Upozornění pro uživatele. Převzaté údaje říkají, komu číslo patří podle zdroje, ne kdo skutečně volal – číslo lze podvrhnout. Neprezentujte číslo jako „bezpečné“ jen proto, že je uvedeno v rejstříku.
- Bez záruky. API poskytujeme tak, jak je, bez záruky dostupnosti, úplnosti a správnosti. Za škody vzniklé jeho použitím neodpovídáme.
- Zablokování a změny. Token můžeme kdykoli omezit nebo zablokovat, zejména při porušení těchto podmínek. Podmínky můžeme měnit; o podstatných změnách informujeme e-mailem uvedeným v žádosti.