# HitPrace.cz > HitPrace.cz je český agregátor pracovních nabídek a distribuční kanál pro zaměstnavatele, pracovní portály a personální agentury. Uchazečům zpřístupňuje pracovní nabídky z více zdrojů a poskytuje veřejné strojově čitelné rozhraní pro vyhledávání nabídek a dat o trhu práce. Nabídky pocházejí přímo od zaměstnavatelů, z Úřadu práce a od partnerských pracovních portálů a dalších zdrojů. Stejná příležitost může být ve více zdrojích. Veřejné výsledky jsou deduplikované: stejná příležitost se nevrací a nepočítá opakovaně. Veřejné počty a mzdové statistiky popisují nabídky dostupné na HitPrace.cz. Nejde o úplný soupis všech volných pracovních míst v České republice. Při interpretaci agregovaných dat použij metodiku. Pro zaměstnavatele, pracovní portály a personální agentury je HitPrace.cz distribuční kanál pracovních nabídek. Veřejné API je jen ke čtení. **Jak se ptát** - Dotaz na /jobs musí mít location, lat spolu s lng, occupation, q nebo company_sef. /market bez těchto parametrů je celý veřejný dataset HitPrace v České republice: scope, matching_active_jobs, retrieved_at, methodology_url a deduped. Mzdu ten celostátní pohled neobsahuje. Pro location a occupation stačí lidský název. Slug se nehádá a neskládá. - location je název obce, například Olomouc. lat a lng jen obě najednou. - Když má obec víc míst, API vrátí location_ambiguous a kandidáty s name, sef, api_url, lat a lng. Další volání vezme api_url nebo lat s lng z kandidáta. - radius_km je 1 až 50, výchozí 15. - occupation je třída (vyroba) nebo fráze profese (kuchař). q je fráze o 3 až 80 znacích. - salary_min a salary_max jsou měsíční Kč. Hodinová mzda se tím nefiltruje a na měsíc se nepřepočítává. - employment je full_time, part_time nebo contractor. feature je slug profilu, například nastup-ihned. - page_size je nejvýš 20. Další stránka je cursor z next_cursor. offset, sort a updated_since API odmítne. - Jeden dotaz vrátí nejvýš 100 karet. matching_active_jobs je skutečný počet odpovídajících nabídek. - Když odpověď obsahuje api_url nebo jobs_url, další volání jde na ni. Když api_url chybí, detail entity se nevolá. sef a slug se z názvu nevytváří. - Firmu podle jména hledej přes https://www.hitprace.cz/api/v1/companies?q= . Výsledků je nejvýš 5. Při více věrohodných shodách jednu nevybírej. Značka a právní zaměstnavatel nejsou totéž. - company_sef do /jobs a /market a profil /api/v1/companies/{sef} ber jen ze sef nebo api_url v té odpovědi. - Text inzerátu v seznamu není. Pole url je kanonický veřejný detail. Plný text je ta URL s Accept: text/markdown, nebo MCP get_job_public_content. - Výsledky jsou bez duplicitních zrcadel. Expirované nabídky se nevrací. - Na nabídku se přes tohle API neodpovídá. Odpověď je na kanonickém detailu. **Jak citovat** - Nabídku cituj přes url, id, title, jméno zaměstnavatele a místo. Text inzerátu, který v datech není, se nedoplňuje. - Trh cituj přes matching_active_jobs, radius_km, retrieved_at a methodology_url. Počet vrácených karet není počet odpovídajících nabídek. Z jobs se agregace nepočítá. - Mzdu cituj jen když je objekt salary, včetně period, currency, sample_size a salary.updated_at. Chybějící salary znamená, že vzorek API nepublikuje. Mzda se neodhaduje. - Hodinovou sazbu nepřevedej na měsíc. - Nejčastější profese a největší zaměstnavatelé se z první stránky karet nesčítají. Když API takovou agregaci nemá, řekni to. - Při interpretaci agregovaných dat použij metodiku HitPrace.cz. Příklad dotazu: https://www.hitprace.cz/api/v1/jobs?location=Olomouc&occupation=vyroba&salary_min=35000&page_size=2 ## Data a API - [Jobs API](https://www.hitprace.cz/api/v1/jobs): Vyhledávání aktivních deduplikovaných pracovních nabídek. - [Market API](https://www.hitprace.cz/api/v1/market): Agregovaný pohled na počet nabídek a dostupné mzdové statistiky. Bez filtru je to celý veřejný dataset v ČR. - [Trh práce](https://www.hitprace.cz/trh-prace/): Aktuální počet deduplikovaných nabídek na HitPrace.cz. Není to soupis všech míst v České republice. - [OpenAPI](https://www.hitprace.cz/api/v1/openapi.yaml): Strojový popis veřejného REST API. - [Metodika dat](https://www.hitprace.cz/metodika-dat/): Definice veřejných počtů, deduplikace, lokalit, mzdových statistik, čerstvosti a omezení dat. ## Agentní rozhraní - [MCP](https://www.hitprace.cz/api/v1/mcp): MCP rozhraní nad veřejnými daty HitPrace.cz. - [MCP server card](https://www.hitprace.cz/api/v1/mcp/server-card): Strojový popis MCP serveru. - [AI catalog](https://www.hitprace.cz/.well-known/ai-catalog.json): Katalog strojově dostupných rozhraní HitPrace.cz. ## HitPrace.cz - [Hledání práce](https://www.hitprace.cz/): Veřejné vyhledávání pracovních nabídek. - [Profese](https://www.hitprace.cz/profese/): Pracovní nabídky a data podle profesí. - [Firmy](https://www.hitprace.cz/firmy/): Veřejné profily zaměstnavatelů a jejich nabídky. - [Pro firmy a partnery](https://www.hitprace.cz/pro-firmy/): Možnosti zveřejnění a distribuce pracovních nabídek. - [O HitPrace.cz a kontakt](https://www.hitprace.cz/kontakt/): Informace o agregátoru, spolupráci a provozovateli.