Miloslav Hub Public API
Public API
The public read-only API provides machine-readable access to intentionally published content on the Miloslav Hub website.
The API is intended for developers, research tools, external applications and artificial intelligence systems. It does not expose non-public data or internal WordPress and plugin interfaces.
Basic information
- API version
- v1
- Format
- JSON
- Access
- Public, read-only
- OpenAPI
- 3.1
OpenAPI specification
The current machine-readable API documentation is available in OpenAPI 3.1 format.
The specification is generated dynamically from the current public API structure.
Endpoints
Site information
GET /site
Returns basic information about the website and the public API.
Content types
GET /content-types
Returns the current public content types and their taxonomies.
Content
GET /content
Returns published content from a selected public content type.
Example:
GET /content?type=prednaskaSearch
GET /search
Searches public pages, posts, lectures and other public content types.
Example:
GET /search?q=securityTaxonomies
GET /taxonomies
Returns the catalogue of public taxonomies or terms from a specific taxonomy.
Example:
GET /taxonomies?taxonomy=tema_prednaskyPublic Knowledge Base
GET /knowledge-base
Returns metadata for the current Miloslav Hub Public Knowledge Base release, including dataset version, licence, checksum, document and chunk counts, and download links.
OpenAPI
GET /openapi
Returns the dynamically generated OpenAPI 3.1 specification for the public API.
Canonical URL:
https://miloslavhub.cz/openapi.jsonPublic Knowledge Base
Miloslav Hub Public Knowledge Base is a separately versioned dataset intended for RAG, research tools and other machine-processing use cases. It contains only items explicitly approved for public export.
Current metadata are available through the /knowledge-base endpoint. The dataset itself is distributed
as a ZIP archive and does not include embeddings, the private knowledge base,
logs or authentication data.
Miloslav Hub Public Knowledge Base is published under the Creative Commons Attribution 4.0 International (CC BY 4.0) licence.
Public content
The API automatically recognises public content types available through the WordPress REST API.
The current list can be obtained from the /content-types endpoint.
A security whitelist is used for supplementary fields. New internal or private ACF fields are therefore not exposed automatically.
Using the API
The public API does not require authentication and allows read-only access to published content.
For example:
GET https://miloslavhub.cz/wp-json/mh/v1/search?q=AIor:
GET https://miloslavhub.cz/wp-json/mh/v1/content?type=prednaskaVersioning and compatibility
The current public API version is v1.
Backward-compatible extensions may be added to version v1 on an ongoing basis.
Changes that are not backward compatible will be published as a new API version.
Terms of use
Licensing and use
Licensing conditions differ depending on whether the material is software, technical documentation or content exposed through the API.
GNU Affero General Public License
AGPL-3.0-or-later
The source code of the public API is intended for distribution under the GNU Affero General Public License, version 3 or later.
GNU AGPL v3 termsCreative Commons Attribution
CC BY 4.0
The public API documentation and its OpenAPI specification may be used under the Creative Commons Attribution 4.0 International licence.
CC BY 4.0 termsCopyright in the provided content
Texts, publications, documents, images and other content exposed through the API remain subject to the copyright and licensing terms of their original sources unless explicitly stated otherwise for a specific item.
Further development
The public API will be gradually extended with additional data sources and safely exposed Miloslav Hub services.
New services will be added to the documentation and OpenAPI specification only after they have been released publicly and their access and security rules have been verified.
The Public Knowledge Base is already part of the API through
the /knowledge-base endpoint. Generative RAG services
are not publicly exposed yet.