{
"openapi": "3.0.1",
"info": {
"title": "Ozon Travel Hotel Scraper - Rooms, Rates & Availability",
"description": "Extract hotels from Ozon Travel with room types, nightly rates, guest ratings, amenities, addresses and photos. Add check-in and check-out dates for real availability and stay prices. 402 destinations, or paste any search link. Export to JSON, CSV or Excel.",
"version": "0.0",
"x-build-id": "GsGEICUkZWVbSz5Ew"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~ozon-travel-hotel-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-ozon-travel-hotel-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/zen-studio~ozon-travel-hotel-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-ozon-travel-hotel-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/zen-studio~ozon-travel-hotel-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-ozon-travel-hotel-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"destination": {
"title": "Город или регион / Destination",
"enum": [
"Абрау-Дюрсо",
"Абхазия",
"Адлер",
"Азов",
"Аксай",
"Алексеевка",
"Альметьевск",
"Амурск",
"Анапа",
"Арзамас",
"Армения",
"Архангельское",
"Архипо-Осиповка",
"Афонино",
"Ачинск",
"Ая",
"Бавлы",
"Балахна",
"Балашиха",
"Балтийск",
"Барабинск",
"Барановичи",
"Барнаул",
"Батайск",
"Батуми",
"Беларусь",
"Белокуриха",
"Белоозерск",
"Бердск",
"Берёза",
"Берёзовский",
"Бийск",
"Бирюзовая Катунь",
"Благовещенская",
"Богданович",
"Богородск",
"Болгар",
"Бологое",
"Большой Сочи",
"Бор",
"Борисоглебский",
"Боровичи",
"Боровое (Новосибирская область)",
"Боровое (Тверская область)",
"Брест",
"Бугульма",
"Буденновск",
"Букнари",
"Ванино",
"Великий Новгород",
"Верхняя Волга",
"Верхняя Пышма",
"Верхняя Салда",
"Верхотурье",
"Видное",
"Витязево",
"Владикавказ",
"Волгоград",
"Волгодонск",
"Волжский (Волгоградская область)",
"Волжский (Самарская область)",
"Всеволожск",
"Выборг",
"Выкса",
"Выселки",
"Вышний Волочек",
"Вьетнам",
"Вятское",
"Гаврилково",
"Гатчина",
"Геленджик",
"Георгиевск",
"Головинка",
"Голубицкая",
"Гонио",
"Горный (Новосибирская область)",
"Горный (Хабаровский край)",
"Городец",
"Городище",
"Городищи",
"Горячий Ключ",
"Греция",
"Григорьевская",
"Грузия",
"Гусев",
"Дагомыс",
"Данилов",
"Даниспараули",
"Деканашвилеби",
"Демянск",
"Деревянное",
"Джубга",
"Дзержинск",
"Дивеево",
"Дивногорск",
"Дивноморское",
"Дмитров",
"Долгопрудный",
"Должанская",
"Домодедово",
"Дубовка",
"Египет",
"Егорьевск",
"Ейск",
"Екатеринбург",
"Елабуга (Республика Татарстан)",
"Елабуга (Хабаровский край)",
"Елань",
"Емельяново",
"Енисейск",
"Ереван",
"Ессентуки",
"Жабинка",
"Железноводск",
"Железногорск",
"Жигули",
"Жигулёвск",
"Заволжье",
"Задонский",
"Заречный",
"Звенигород",
"Зеленогорск",
"Зеленогорск (Красноярский край)",
"Зеленоградск",
"Зеленодольск",
"Зелёный Бор",
"Золотое кольцо России",
"Зудилово",
"Иваново (Ленинградская область)",
"Иваново (Нижегородская область)",
"Инал",
"Иннополис",
"Иноземцево",
"Искитим",
"Испания",
"Истра",
"Италия",
"Кабардинка",
"Кавказские Минеральные Воды",
"Казань",
"Казахстан",
"Калач-на-Дону",
"Калининград",
"Калязин",
"Каменск-Уральский",
"Каменск-Шахтинский",
"Каменюки",
"Камское Устье",
"Камышин",
"Канск",
"Карасук",
"Карелия",
"Катунь",
"Квариати",
"Кеда",
"Кемер",
"Кильпола",
"Кимры",
"Кингисепп",
"Кировград",
"Кировск",
"Кисловодск",
"Клин",
"Ключи",
"Кобрин",
"Кобулети",
"Коломна",
"Колпино",
"Кольцово",
"Комарово",
"Комсомольск-на-Амуре",
"Конаково",
"Кондопога",
"Костомукша",
"Котельники",
"Котельниково",
"Красная Поляна",
"Красногорск",
"Краснодар",
"Краснодарский край, курорты",
"Красное Село",
"Красноуфимск",
"Красноярск",
"Красноярский край",
"Красный Партизан",
"Красный Яр",
"Криница",
"Кронштадт",
"Кстово",
"Куба",
"Кудряшовский",
"Кулебаки",
"Куркиёки",
"Курское",
"Куршская коса",
"Ладожское Озеро",
"Лазаревский район",
"Лаишево",
"Лахденпохья",
"Ленинградская область",
"Ленинск",
"Лермонтов",
"Лермонтово",
"Лесной",
"Ломоносов",
"Лукоянов",
"Лунинец",
"Лысково",
"Люберцы",
"Любытино",
"Макопсе",
"Малайзия",
"Малая Вишера",
"Марокко",
"Маслянино",
"Махинджаури",
"Медвежьегорск",
"Медвежьи Озера",
"Мериси",
"Металлострой",
"Миллерово",
"Минеральные Воды",
"Минск",
"Минусинск",
"Мирный",
"Михайловка",
"Можайск",
"Морозовск",
"Морское",
"Москва",
"Москва-Сити",
"Московская область (Подмосковье)",
"Московский",
"Мостовское",
"Мытищи",
"Мышкин",
"Набережные Челны",
"Навашино",
"Наро-Фоминск",
"Невинномысск",
"Нижнекамск",
"Нижнекаянча",
"Нижний Новгород",
"Нижний Тагил",
"Нижняя Тура",
"Николаевск-на-Амуре",
"Новая Тура",
"Новицковичи",
"Новоаннинский",
"Новокуйбышевск",
"Новомихайловский",
"Новосибирск",
"Новочеркасск",
"Ногинск",
"Норильск",
"Нурлат",
"ОАЭ",
"Обнинск",
"Обь",
"Одинцово",
"Озеро Селигер",
"Октябрьский",
"Окуловка",
"Ольгинка",
"Орел",
"Орехово-Зуево",
"Орловка",
"Осташков",
"Остров",
"Отрадный",
"Павловск",
"Павловское",
"Парголово",
"Первоуральск",
"Переславль-Залесский",
"Переяславка",
"Пермь",
"Перу",
"Пески",
"Песочный",
"Пестово",
"Пестрецы",
"Петергоф",
"Петрозаводск",
"Пинск",
"Пионерский",
"Питкяранта",
"Подгорное",
"Подольск",
"Поляна",
"Прибрежный",
"Приозерск",
"Приозёрский",
"Псковская область",
"Пушкин",
"Пушкино",
"Пятигорск",
"Репино",
"Ретлё",
"Ржев",
"Ростов Великий",
"Ростов-на-Дону",
"Ростовская область",
"Рощино",
"Руанда",
"Руза",
"Рыбинск",
"Рыбная Слобода",
"Сальск",
"Самара",
"Санкт-Петербург",
"Саратов",
"Свердловская область",
"Светлогорск",
"Свияжск",
"Семенов",
"Сергиев Посад",
"Серов",
"Серпухов",
"Сестрорецк",
"Сиде",
"Сириус",
"Смолячково",
"Советск",
"Советская Гавань",
"Соколиный",
"Сокольники",
"Солнечногорск",
"Солнечное",
"Солнечное (Алтайский край)",
"Солнечный",
"Солонцы",
"Сорочьи Горы",
"Сортавала",
"Сосново",
"Сосновый Бор",
"Сочи",
"Средняя Волга",
"Ставрополь",
"Ставропольский край",
"Стамбул",
"Стан-Бехтемир",
"Старая Русса",
"Стрельна",
"Ступино",
"Суоярви",
"Суровикино",
"Суходол",
"Сызрань",
"Сысерть",
"Сямозеро",
"Таганрог",
"Таджикистан",
"Таиланд",
"Тамань",
"Таруса",
"Татарск",
"Татарстан",
"Тверь",
"Темрюк",
"Тибета",
"Тихвин",
"Тольятти",
"Торжок",
"Троицкий",
"Троицкое (Алтайский край)",
"Троицкое (Хабаровский край)",
"Туапсе",
"Тунис",
"Турция",
"Тутаев",
"Углич",
"Урюпинск",
"Филиппины",
"Хабаровск",
"Хабаровский край",
"Химки",
"Хор",
"Хоста",
"Чакви",
"Чаны",
"Чапаевск",
"Черни",
"Черногория",
"Черняховск",
"Чеченская республика",
"Чистополь",
"Чудово",
"Шахты",
"Шахунья",
"Шимск",
"Шри-Ланка",
"Шушары",
"Щелково",
"Электросталь",
"Эсто-Садок",
"Ялта",
"Янтарный",
"Яровое",
"Ярославль",
"Ясенево",
"Яхрома"
],
"type": "string",
"description": "Начните печатать, чтобы найти город в списке.
Start typing to find a city in the list."
},
"urls": {
"title": "Ссылки / URLs",
"maxItems": 50,
"type": "array",
"description": "Ссылка на поиск, подборку или конкретный отель — по одной на строку.
A search link, a collection link, or a single hotel — one per line.
Ссылка используется как есть: её даты, фильтры и сортировка важнее полей ниже.
A link is used exactly as pasted: its own dates, filters and sorting win over the fields below.",
"items": {
"type": "string"
}
},
"checkIn": {
"title": "Заезд / Check-in",
"type": "string",
"description": "Дата в формате ГГГГ-ММ-ДД. С датами вы получаете реальные свободные номера и цены за проживание.
Date as YYYY-MM-DD. With dates you get the rooms actually available and what the stay costs."
},
"checkOut": {
"title": "Выезд / Check-out",
"type": "string",
"description": "Указывайте вместе с датой заезда.
Set together with the check-in date."
},
"adults": {
"title": "Гостей / Guests",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Сколько взрослых гостей. Учитывается только вместе с датами.
How many adult guests. Only matters together with dates.",
"default": 2
},
"maxResults": {
"title": "Макс. отелей / Max hotels",
"minimum": 0,
"type": "integer",
"description": "Сколько отелей на каждый город и каждую ссылку. 0 = все найденные.
How many hotels per destination and per link. 0 = every hotel found.",
"default": 100
},
"skipDetails": {
"title": "Только карточки из выдачи / Search results only",
"type": "boolean",
"description": "Быстрее и дешевле, но без номеров, тарифов, удобств, описания, фото-галереи и календаря цен. С датами карточки выдачи идут без цен, поэтому для цен на проживание оставьте выключенным.
Faster and cheaper, but no rooms, rates, amenities, description, photo gallery or price calendar. With dates, search cards carry no prices at all, so leave this off if you want stay prices.",
"default": false
},
"sorting": {
"title": "Сортировка / Sort order",
"enum": [
"popular",
"price_asc",
"price_desc",
"rating"
],
"type": "string",
"description": "Что показать первым. Вместе с лимитом определяет выборку.
What comes first. Combined with the limit, it decides the sample.",
"default": "popular"
},
"minRating": {
"title": "Оценка гостей / Guest rating",
"enum": [
"3",
"4",
"4.5"
],
"type": "string",
"description": "Минимальная оценка гостей.
Minimum guest rating."
},
"stars": {
"title": "Звёздность / Star rating",
"type": "array",
"description": "Можно выбрать несколько.
Pick as many as you like.",
"items": {
"type": "string",
"enum": [
"0",
"1",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"Без звёзд / Unrated",
"1*",
"2*",
"3*",
"4*",
"5*"
]
}
},
"placementType": {
"title": "Тип размещения / Property type",
"type": "array",
"description": "Можно выбрать несколько.
Pick as many as you like.",
"items": {
"type": "string",
"enum": [
"1%3B8%3B12%3B13%3B18%3B19",
"11",
"3%3B4%3B5",
"2%3B6%3B15",
"16",
"9",
"7%3B10",
"14",
"17"
],
"enumTitles": [
"Отель / Hotel",
"Апарт-отель / Apart-hotel",
"Квартира / Apartment",
"Коттедж, вилла / Cottage or villa",
"Гостевой дом / Guest house",
"Хостел / Hostel",
"Санаторий / Health resort",
"Кемпинг / Campsite",
"Глэмпинг / Glamping"
]
}
},
"mealType": {
"title": "Питание / Meals",
"type": "array",
"description": "Можно выбрать несколько. Работает для поиска без дат: если указаны даты, питание каждого тарифа видно в результатах.
Pick as many as you like. Works for a search without dates — with dates, each rate in the results states its own meal plan.",
"items": {
"type": "string",
"enum": [
"breakfast",
"halfboard",
"fullboard",
"allinclusive",
"ultraallinclusive",
"dinner",
"lunch",
"roomonly"
],
"enumTitles": [
"Завтрак / Breakfast",
"Двухразовое питание / Half board",
"Завтрак, обед и ужин / Full board",
"Всё включено / All inclusive",
"Ультра всё включено / Ultra all inclusive",
"Обед / Lunch",
"Ужин / Dinner",
"Без питания / Room only"
]
}
},
"amenities": {
"title": "Удобства / Amenities",
"type": "array",
"description": "Можно выбрать несколько.
Pick as many as you like.",
"items": {
"type": "string",
"enum": [
"273412150000",
"275468766000",
"278618084000",
"-126",
"-127",
"275470375000",
"10556306003000",
"2999413240000",
"10556035195000",
"-111",
"10555859716000",
"6257696248000",
"275478941000",
"275477588000",
"6257696272000",
"6257696288000",
"-40",
"-41",
"-42",
"-43",
"-44",
"-45"
],
"enumTitles": [
"Wi-Fi",
"Парковка / Parking",
"Бассейн / Pool",
"Открытый бассейн / Outdoor pool",
"Крытый бассейн / Indoor pool",
"SPA",
"Сауна / Sauna",
"Аквапарк / Water park",
"Кафе, ресторан / Cafe or restaurant",
"Бар / Bar",
"Круглосуточный ресепшен / 24-hour reception",
"Трансфер / Airport transfer",
"Можно с питомцами / Pets allowed",
"Доступная среда / Accessible",
"Можно курить / Smoking allowed",
"Подходит для детей / Family friendly",
"Детский бассейн / Children's pool",
"Детская кроватка / Cot",
"Детский клуб / Kids club",
"Детское меню / Children's menu",
"Детская анимация / Kids entertainment",
"Детская площадка / Playground"
]
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}