Open Data API — Smart Serbia Travel

Быстрый старт

Три примера, которые можно запустить прямо сейчас из терминала. Без регистрации и ключа.

$ curl https://mt.inovexlabs.com/ru/api/v1/stays?city=Beograd

$ curl https://mt.inovexlabs.com/ru/api/v1/events?type=festival

$ curl https://mt.inovexlabs.com/ru/api/v1/stats

Эндпоинты

Метод	URL	Описание	Действие
GET	/api/v1	Возвращает список эндпоинтов, версию и лицензию.	Открыть в браузере →
GET	/api/v1/places	Все туристические места (монастыри, крепости, города, этно-сёла…). Фильтры: category, region.	Открыть в браузере →
GET	/api/v1/stays	Размещение с ценой, вместимостью и рейтингом. Фильтры: type, city, region.	Открыть в браузере →
GET	/api/v1/tours	Экскурсии с длительностью, сложностью и ценой за человека. Фильтры: type, starts_in.	Открыть в браузере →
GET	/api/v1/events	Фестивали, концерты, спортивные и культурные события. Фильтры: type, city, region.	Открыть в браузере →
GET	/api/v1/news	Анонсы, предупреждения, партнёрства и новости EU funding. Заголовок/summary в текущей локали.	Открыть в браузере →
GET	/api/v1/stats	Ключевые KPI, распределение по регионам, топ-страны, Smart Tourism Score. Те же цифры, что и в /stats.	Открыть в браузере →
GET	/api/v1/regions	6 статистических макрорегионов Сербии с названиями на 4 языках.	Открыть в браузере →

GET https://mt.inovexlabs.com/ru/api/v1 Открыть в браузере →

Service descriptor

Возвращает список эндпоинтов, версию и лицензию.

Параметры запроса

Без параметров.

Пример ответа

{
    "name": "Smart Serbia Travel — Open Tourism Data API",
    "version": "1.0",
    "license": "CC-BY-4.0",
    "endpoints": {
        "places": "https://mt.inovexlabs.com/ru/api/v1/places",
        "stays": "https://mt.inovexlabs.com/ru/api/v1/stays",
        "tours": "https://mt.inovexlabs.com/ru/api/v1/tours",
        "events": "https://mt.inovexlabs.com/ru/api/v1/events",
        "news": "https://mt.inovexlabs.com/ru/api/v1/news",
        "stats": "https://mt.inovexlabs.com/ru/api/v1/stats",
        "regions": "https://mt.inovexlabs.com/ru/api/v1/regions"
    }
}

GET https://mt.inovexlabs.com/ru/api/v1/places Открыть в браузере →

Places

Все туристические места (монастыри, крепости, города, этно-сёла…). Фильтры: category, region.

Параметры запроса

Name	Type	Описание
`category`	string	monastery \| fortress \| park \| ethno_village \| spa \| gastro \| archaeological \| city \| mosque \| catholic_church \| synagogue
`region`	string	belgrade \| vojvodina \| sumadija \| western \| eastern \| southern

Пример ответа

{
    "count": 1,
    "license": "CC-BY-4.0",
    "data": [
        {
            "id": 7,
            "slug": "manastir-studenica",
            "name": "Manastir Studenica",
            "category": "monastery",
            "region": "western",
            "lat": 43.4861,
            "lng": 20.5325,
            "unesco": true,
            "year_founded": 1190,
            "photo_url": "https://example.com/assets/img/places/studenica.jpg",
            "detail_url": "https://example.com/sr/places/manastir-studenica"
        }
    ]
}

GET https://mt.inovexlabs.com/ru/api/v1/stays Открыть в браузере →

Stays

Размещение с ценой, вместимостью и рейтингом. Фильтры: type, city, region.

Параметры запроса

Name	Type	Описание
`type`	string	apartment \| etno_village \| hotel \| cabin \| guesthouse
`city`	string	e.g. Beograd, Novi Sad, Zlatibor
`region`	string	belgrade \| vojvodina \| sumadija \| western \| eastern \| southern

Пример ответа

{
    "count": 1,
    "license": "CC-BY-4.0",
    "data": [
        {
            "id": 12,
            "slug": "apartman-savamala",
            "name": "Apartman Savamala",
            "type": "apartment",
            "city": "Beograd",
            "region": "belgrade",
            "lat": 44.8125,
            "lng": 20.454,
            "price_per_night": 78,
            "currency": "EUR",
            "max_guests": 4,
            "bedrooms": 2,
            "bathrooms": 1,
            "rating_avg": 4.7,
            "rating_count": 142,
            "amenities": [
                "wifi",
                "kitchen",
                "aircon"
            ],
            "photo_url": "https://example.com/assets/img/stays/savamala.jpg",
            "detail_url": "https://example.com/sr/stays/apartman-savamala"
        }
    ]
}

GET https://mt.inovexlabs.com/ru/api/v1/tours Открыть в браузере →

Tours

Экскурсии с длительностью, сложностью и ценой за человека. Фильтры: type, starts_in.

Параметры запроса

Name	Type	Описание
`type`	string	walking \| day_trip \| multi_day \| wine \| adventure \| cultural
`starts_in`	string	starting city, e.g. Beograd

Пример ответа

{
    "count": 1,
    "license": "CC-BY-4.0",
    "data": [
        {
            "id": 4,
            "slug": "beograd-walking",
            "name": "Beograd — old town walking tour",
            "type": "walking",
            "starts_in": "Beograd",
            "duration_hours": 3,
            "duration_days": 0,
            "difficulty": "easy",
            "group_max": 12,
            "price_per_person": 18,
            "currency": "EUR",
            "languages": [
                "en",
                "sr",
                "de"
            ],
            "rating_avg": 4.8,
            "rating_count": 87,
            "meeting_point": "Knez Mihailova 1",
            "includes": [
                "Local guide",
                "Coffee stop"
            ],
            "photo_url": "https://example.com/assets/img/tours/beograd-walking.jpg",
            "detail_url": "https://example.com/sr/tours/beograd-walking"
        }
    ]
}

GET https://mt.inovexlabs.com/ru/api/v1/events Открыть в браузере →

Events

Фестивали, концерты, спортивные и культурные события. Фильтры: type, city, region.

Параметры запроса

Name	Type	Описание
`type`	string	concert \| festival \| sport \| cultural \| food
`city`	string	e.g. Guča, Novi Sad, Beograd
`region`	string	belgrade \| vojvodina \| sumadija \| western \| eastern \| southern

Пример ответа

{
    "count": 1,
    "license": "CC-BY-4.0",
    "data": [
        {
            "id": 9,
            "slug": "exit-festival-2026",
            "name": "EXIT Festival 2026",
            "type": "festival",
            "city": "Novi Sad",
            "region": "vojvodina",
            "venue": "Petrovaradinska tvrđava",
            "starts_at": "2026-07-09 20:00:00",
            "ends_at": "2026-07-12 06:00:00",
            "lat": 45.2519,
            "lng": 19.8635,
            "price_from": 8900,
            "currency": "RSD",
            "capacity": 50000,
            "has_tickets": true,
            "is_free": false,
            "external_url": "https://exitfest.org",
            "photo_url": "https://example.com/assets/img/events/exit.jpg",
            "detail_url": "https://example.com/sr/events/exit-festival-2026"
        }
    ]
}

GET https://mt.inovexlabs.com/ru/api/v1/news Открыть в браузере →

News

Анонсы, предупреждения, партнёрства и новости EU funding. Заголовок/summary в текущей локали.

Параметры запроса

Name	Type	Описание
`category`	string	announcement \| advisory \| funding \| event \| partnership \| update
`importance`	string	low \| normal \| high \| critical

Пример ответа

{
    "count": 1,
    "license": "CC-BY-4.0",
    "locale": "ru",
    "data": [
        {
            "id": 3,
            "slug": "horizon-europe-2026",
            "category": "funding",
            "importance": "high",
            "pinned": true,
            "published_at": "2026-04-12 09:00:00",
            "source": "Tourism Organisation of Serbia",
            "title": "€3.1M Horizon Europe grant awarded",
            "summary": "Sustainable mountain tourism project (Tara/Kopaonik) receives multi-year funding…",
            "locale": "ru",
            "detail_url": "https://example.com/ru/news/horizon-europe-2026"
        }
    ]
}

GET https://mt.inovexlabs.com/ru/api/v1/stats Открыть в браузере →

Statistics

Ключевые KPI, распределение по регионам, топ-страны, Smart Tourism Score. Те же цифры, что и в /stats.

Параметры запроса

Без параметров.

Пример ответа

{
    "period": "2026-YTD",
    "kpi": {
        "arrivals_ytd": 2847392,
        "avg_nights": 3.2,
        "occupancy_pct": 67.8,
        "revenue_eur_billion": 2.1,
        "smart_tourism_score": 78
    },
    "visitors_by_region": {
        "belgrade": {
            "share_pct": 28.4,
            "count": 808410
        },
        "vojvodina": {
            "share_pct": 19.2,
            "count": 546699
        },
        "...": "..."
    },
    "eu_projects_active": 4,
    "eu_funding_total_eur_million": 18,
    "updated_at": "2026-05-10T12:00:00+02:00"
}

GET https://mt.inovexlabs.com/ru/api/v1/regions Открыть в браузере →

Regions

6 статистических макрорегионов Сербии с названиями на 4 языках.

Параметры запроса

Без параметров.

Пример ответа

{
    "count": 6,
    "license": "CC-BY-4.0",
    "data": [
        {
            "code": "belgrade",
            "name_sr": "Beograd",
            "name_en": "Belgrade",
            "name_de": "Belgrad",
            "name_ru": "Белград"
        },
        "..."
    ]
}

Сценарии использования

Создайте тревел-приложение

Независимые разработчики могут создавать альтернативные клиенты для Сербии на тех же данных, что и официальное приложение.

Показывайте наличие онлайн

Сайты турбюро могут подгружать текущие предложения и события, не имея собственной базы.

Исследования туризма

Университеты и аналитические центры получают структурированные KPI: сезонность, распределение по регионам, страны происхождения.

Интеграция с государственным open-data

data.gov.rs и подобные порталы могут перераспределять фиды по той же лицензии CC-BY-4.0 — выполняя требования EU Open Data Directive.

Лимиты и честное использование

У v1 нет жёсткого rate-limit. Соблюдайте честное использование (мягкий лимит 60 запросов/мин на IP). В будущей v2 появятся опциональные API-ключи с увеличенными квотами и webhook-уведомлениями.

Лицензия и атрибуция

Все данные публикуются под лицензией Creative Commons Attribution 4.0 International (CC-BY-4.0). Свободное повторное использование, ремиксы и распространение — с обязательной атрибуцией "Smart Serbia Travel" со ссылкой на платформу.

Полный текст лицензии →

Контекст EU smart-tourism

Этот API — часть платформы, согласованной с EU Tourism Data Spaces, DEPLOYTOUR и наградой Smart Tourism Capital. См. /eu-tourism для обзора программ.

Страница EU Smart Tourism →