For Developers

Developer Hub

Integrate Nová Osmička data into your applications. The public API and RSS feeds are available for free without registration.

Public API v1

REST API with endpoints for events, articles, categories, tags, locations, and organisations.

RSS Feeds

RSS 2.0 feeds for articles and upcoming events in 4 languages.

REST API

Public API v1

Base URL

https://www.novaosmicka.cz/api/v1/

Rate Limiting

The API is limited to 3,600 requests per day per IP address. Exceeding the limit returns HTTP status 429.

Common Parameters

Pagination

Parameter Type Default Description
per_page integer 15 Number of items per page (1–100)
page integer 1 Page number

Language

Parameter Type Default Description
lang string cs Language code: cs, sk, en, pl. Affects translations of names and descriptions.

Response Structure

Collection (list)

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 15,
    "total": 73
  },
  "links": {
    "first": "...?page=1",
    "last": "...?page=5",
    "prev": null,
    "next": "...?page=2"
  }
}

Single Resource

{
  "success": true,
  "data": { ... }
}

Error Response (404)

{
  "success": false,
  "message": "Resource not found"
}

Events

GET /api/v1/events

Returns a paginated list of published events sorted by date.

Additional Parameters
date_from string (YYYY-MM-DD) Filter events from date (YYYY-MM-DD)
date_to string (YYYY-MM-DD) Filter events until date (YYYY-MM-DD)
category_id integer Filter by category ID
upcoming string Only upcoming events (value "true")
Example
curl -s "https://www.novaosmicka.cz/api/v1/events?upcoming=true&lang=en&per_page=5"
GET /api/v1/events/{id_or_slug}

Returns event details by ID or slug. Includes tickets and timetable.

Response Schema
{
  "id": "uuid",
  "slug": "summer-festival-2026",
  "name": "Summer Festival 2026",
  "description": "...",
  "short_description": "...",
  "date_from": "2026-07-15",
  "date_to": "2026-07-17",
  "time_from": "18:00",
  "time_to": "23:00",
  "price": 350,
  "banner_url": "https://...",
  "tickets_url": "https://...",
  "facebook_event_url": "https://...",
  "category": { "id": 1, "slug": "koncerty", "name": "Koncerty" },
  "tags": [{ "id": 1, "slug": "rock", "name": "Rock", "color": "#ff0000" }],
  "organisator": { "id": "uuid", "slug": "nova-osmicka", "name": "Nová Osmička" },
  "location": { "id": "uuid", "name": "Hlavní sál", "description": "...", "tag": "...", "type": "...", "position": { "lat": 49.68, "lng": 18.35 } },
  "tickets": [{ "id": "uuid", "name": "Standard", "price": 350 }],
  "timetable": [{ "id": "uuid", "name": "Opening act", "datetime_from": "2026-07-15T18:00:00", "datetime_to": "2026-07-15T19:00:00", "location_id": "uuid" }]
}

Articles

GET /api/v1/articles

Returns a paginated list of published articles sorted by publish date.

GET /api/v1/articles/{id_or_slug}

Returns article details by ID or slug.

Response Schema
{
  "id": "uuid",
  "slug": "new-season-opening",
  "title": "New Season Opening",
  "text": "...",
  "short_text": "...",
  "banner_url": "https://...",
  "article_tag": "news",
  "publish_date": "2026-01-15T10:00:00.000000Z"
}

Categories

GET /api/v1/categories

Returns a paginated list of event categories.

GET /api/v1/categories/{id}

Returns category details by ID.

Response Schema
{
  "id": 1,
  "slug": "koncerty",
  "name": "Koncerty"
}

Tags

GET /api/v1/tags

Returns a paginated list of tags.

GET /api/v1/tags/{id}

Returns tag details by ID.

Response Schema
{
  "id": 1,
  "slug": "rock",
  "name": "Rock",
  "color": "#ff0000"
}

Locations

GET /api/v1/locations

Returns a paginated list of public locations within the complex.

GET /api/v1/locations/{id}

Returns public location details by ID.

Response Schema
{
  "id": "uuid",
  "name": "Hlavní sál",
  "description": "...",
  "tag": "indoor",
  "type": "hall",
  "position": {
    "lat": 49.6833,
    "lng": 18.3500
  }
}

Organisations

GET /api/v1/organisations

Returns a paginated list of organisations. Does not support the lang parameter.

GET /api/v1/organisations/{id_or_slug}

Returns organisation details by ID or slug.

Response Schema
{
  "id": "uuid",
  "slug": "nova-osmicka",
  "name": "Nová Osmička",
  "email": "info@novaosmicka.cz",
  "short_description": "...",
  "long_description": "...",
  "icon_url": "https://...",
  "website": "https://www.novaosmicka.cz",
  "social": {
    "facebook": "https://...",
    "instagram": "https://...",
    "twitter": null,
    "youtube": "https://...",
    "linkedin": null
  }
}

RSS Feeds

RSS Feeds

Subscribe to Nová Osmička news and events through your RSS reader.

News

Latest 50 published articles.

https://www.novaosmicka.cz/rss/articles.xml

Events

50 upcoming events in chronological order.

https://www.novaosmicka.cz/rss/events.xml

Localized Feeds

Feeds are available in four languages. Default (no prefix) is Czech.

Czech (default):  /rss/articles.xml       /rss/events.xml
English:          /en/rss/articles.xml    /en/rss/events.xml
Slovak:           /sk/rss/articles.xml    /sk/rss/events.xml
Polish:           /pl/rss/articles.xml    /pl/rss/events.xml

Technical Details

  • ■ Format: RSS 2.0 with Atom self-link
  • ■ Cache: 1 hour (Cache-Control: public, max-age=3600)
  • ■ Auto-discovery: link tags are included in the HTML head of every page
  • ■ Articles: latest 50 items
  • ■ Events: 50 nearest upcoming events
Example
curl -s "https://www.novaosmicka.cz/en/rss/articles.xml"