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í.

ZdrojLicenceUveďte
OpenStreetMapODbL 1.0© přispěvatelé OpenStreetMap
Národní registr poskytovatelů zdravotních služebCC BY 4.0NRPZS, Ministerstvo zdravotnictví ČR a ÚZIS ČR
Registr poskytovatelů sociálních služebotevřená dataRegistr poskytovatelů sociálních služeb, MPSV
Centrální adresář knihovenotevřená dataCentrální adresář knihoven, Národní knihovna ČR
Seznam lékáren SÚKLotevřená dataSeznam lékáren, Státní ústav pro kontrolu léčiv
oficiální weby obcí a úřadůveřejně uvedený údajoficiální web obce nebo úřadu (odkaz v poli url)
vlastní weby firem a poskytovatelůveřejně uvedený údajweb 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.czPodmínky APINezná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.

  1. 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.
  2. Limit. 1000 dotazů denně, pokud se nedohodneme jinak. Obcházet limit více tokeny nebo účty je zakázáno.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.