Data Hub for agencies and developers

What the Data Hub is

The Data Hub is the verified source of truth about the ski resort SkiResort ČERNÁ HORA – PEC: ski areas, lifts, slopes, cross-country trails, services and places, ski buses, products (ski passes), age categories, price lists and a glossary. It serves the resort's website and e-shop (agencies), the resort's own channels (TV panorama, displays, apps) and AI assistants.

Every value is a claim with its source (URL, verbatim excerpt, retrieval time, confidence). Source priority rules select the published value; conflicts are never resolved silently (_conflicts, quality report). An immutable release is published – the API, fact pages, llms-full.txt and MCP read the same release, so they say the same thing.

Addresses

Quick start

Reading requires no authentication, CORS is *, responses are cacheable (send If-None-Match with the ETag → 304). Language: ?lang=en or Accept-Language; a missing translation falls back to Czech and the response says so (meta.notes, Content-Language).

curl -s 'https://data.skiresort.cz/api/v2/lifts?area=cerna-hora&lang=en'
curl -s 'https://data.skiresort.cz/api/v2/status?area=pec&lang=en'
curl -s -H 'Accept: application/ld+json' 'https://data.skiresort.cz/api/v2/lifts/lift:cerna-hora:a1'   # JSON-LD (schema.org)
curl -s 'https://data.skiresort.cz/en/lifts/cerna-hora/a1.md'                                           # Markdown fact page

Identifiers have the form {type}:{area}:{designation} (lift:cerna-hora:a1) and are never reused; use the ID as the key, not the name. unknown does not mean closed – after validUntil without confirmation the API returns status: unknown with lastKnown. Errors are application/problem+json (RFC 9457).

OpenAPI and MCP

• OpenAPI 3.1: openapi.json – operations marked x-stage: stable are covered by the version policy (additive changes only; removals announced with ≥ 6 months overlap and Deprecation/Sunset headers). Clients must ignore unknown fields. Interactive reference: https://data.skiresort.cz/docs/api.
• MCP: read-only server at https://data.skiresort.cz/mcp (JSON-RPC over Streamable HTTP, no authentication) with tools for live status, lifts, slopes, prices, age categories, FAQ, glossary and search. Every answer carries the release ID and attribution – cite the fact page URL. Details (in Czech): https://data.skiresort.cz/docs/mcp.
• Schema version: 2.2.0; data dictionary: https://data.skiresort.cz/docs/data-dictionary.json.

Licence and attribution

• The resort's own data: see the terms of use – meta.license in API responses and https://data.skiresort.cz/docs/licence; attribute “SkiResort ČERNÁ HORA – PEC (MEGA PLUS s.r.o.), data.skiresort.cz”.
• Holidayinfo (Sitour CZ): operational data under a contract between MEGA PLUS s.r.o. and Sitour CZ – show “Data source: www.holidayinfo.cz, (c) Sitour CZ”.
• OpenStreetMap / OpenSkiMap: © OpenStreetMap contributors, ODbL 1.0.
• Display meta.attributions from each response (Data Hub and the sources used in it).

Contact and reporting data errors

Report a wrong value with the entity ID and the fact page URL (every page has a section “How this data is produced”). A dedicated Data Hub contact for agencies is being set up; until then use the operator contact at www.skiresort.cz. Full documentation (in Czech): https://data.skiresort.cz/docs.