{
"openapi": "3.0.1",
"info": {
"title": "Авито Недвижимость: Парсер / Avito Real Estate Scraper",
"description": "Парсер недвижимости Авито: квартиры, комнаты, дома, участки, коммерческая недвижимость и гаражи. Аренда, продажа, посуточно и отели. Цена за м², площадь, этаж, адрес, координаты, продавец.",
"version": "0.0",
"x-build-id": "dktAkTb8vDJQ8E7iE"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~avito-realty-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-avito-realty-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~avito-realty-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-avito-realty-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~avito-realty-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-avito-realty-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": {
"searchUrl": {
"title": "URL поиска (Search URL)",
"type": "string",
"description": "Вставьте ссылку на поиск или категорию с сайта. Её фильтры применяются автоматически, поэтому поля фильтров задавать не нужно. Цена, продавец и сортировка дополняют ссылку, если в ней их нет. Ссылка заменяет поля ниже, поэтому в её пути должен быть раздел недвижимости: одного города мало (/tyumen/kommercheskaya_nedvizhimost/prodam). (Paste a search or category URL. Its own filters are used; price, seller and sort fill in where the URL is silent. A URL replaces the fields below, so its path must name a property section: a city on its own is not a search.)"
},
"propertyType": {
"title": "Тип недвижимости (Property type)",
"enum": [
"apartments",
"rooms",
"houses",
"land",
"commercial",
"garages",
"foreign",
"hotels"
],
"type": "string",
"description": "Что искать. Отели идут только посуточно и приносят номера с ценами. (What to look for. Hotels are daily only and come with their rooms and rates.)",
"default": "apartments"
},
"dealType": {
"title": "Тип сделки (Deal type)",
"enum": [
"sale",
"rent",
"daily",
"new",
"resale"
],
"type": "string",
"description": "Продажа или аренда. Посуточно есть у квартир, комнат, домов и отелей; у отелей только посуточно. Новостройки и вторичка разделены только у квартир: в остальных разделах вторичка это та же продажа. (Sale or rent. Daily applies to apartments, rooms, houses and hotels; hotels are daily only. New-build and resale are separate for apartments only: everywhere else resale is the same listings as sale.)",
"default": "sale"
},
"location": {
"title": "Местоположение (Location)",
"type": "string",
"description": "Город или регион. Район не подходит как область поиска: укажите город или область. Город за рубежом подходит, страна целиком нет: для неё propertyType \"foreign\" и фильтр country. Название подходит на русском и на английском (Moscow, Nizhny Novgorod Oblast). (City or region. A district is not a search area, name the city or the region. A city abroad works; a whole country does not, use propertyType \"foreign\" with the country filter. The name works in Russian or in English (Moscow, Nizhny Novgorod Oblast).)",
"default": "Россия"
},
"centerPoint": {
"title": "Центр области поиска (Search area centre)",
"type": "string",
"description": "Широта и долгота через запятую, например 60.040234, 30.209975. Вместе с radiusKm ограничивает поиск областью вокруг этой точки: удобно, когда запуск идёт по расписанию и ссылку вставлять некуда. Координаты есть в адресе страницы карты на сайте. Если ссылка в searchUrl уже задаёт область, побеждает она. (Latitude and longitude, comma separated. With radiusKm it limits the search to an area around that point, for scheduled runs where there is no URL to paste. A map area in searchUrl wins over this.)"
},
"radiusKm": {
"title": "Радиус, км (Radius, km)",
"type": "integer",
"description": "Сколько километров вокруг centerPoint искать. Область описывает прямоугольник вокруг круга, поэтому по углам захватывает чуть больше радиуса; точный круг отфильтруйте по latitude и longitude каждого объявления. (How many kilometres around centerPoint to search. The area is the rectangle around that circle, so it reaches a little beyond the radius at the corners; cut the exact circle with each listing's latitude and longitude.)"
},
"rooms": {
"title": "Комнат (Rooms)",
"type": "array",
"description": "Например [\"studio\", \"1\", \"2\"]. Для квартир и домов; у комнат вместо этого фильтр «Комнат в квартире». (E.g. [\"studio\",\"1\",\"2\"]. Apartments and houses.)",
"items": {
"type": "string"
}
},
"priceMin": {
"title": "Цена от (Price from)",
"type": "integer",
"description": "Минимальная цена. Для аренды: за месяц. (Minimum price; per month for rentals.)"
},
"priceMax": {
"title": "Цена до (Price to)",
"type": "integer",
"description": "Максимальная цена. Для аренды: за месяц. (Maximum price; per month for rentals.)"
},
"areaMin": {
"title": "Площадь от (Area from)",
"type": "integer",
"description": "Минимальная площадь. (Minimum area.)"
},
"areaMax": {
"title": "Площадь до (Area to)",
"type": "integer",
"description": "Максимальная площадь. (Maximum area.)"
},
"landAreaMin": {
"title": "Участок от (Land from)",
"type": "integer",
"description": "Минимальная площадь участка. Только для домов; у участков это «Площадь от». (Minimum land area. Houses only; for land use the area fields.)"
},
"landAreaMax": {
"title": "Участок до (Land to)",
"type": "integer",
"description": "Максимальная площадь участка. Только для домов; у участков это «Площадь до». (Maximum land area. Houses only; for land use the area fields.)"
},
"floorMin": {
"title": "Этаж от (Floor from)",
"type": "integer",
"description": "Минимальный этаж. Только для квартир и комнат. (Lowest floor. Apartments and rooms only.)"
},
"floorMax": {
"title": "Этаж до (Floor to)",
"type": "integer",
"description": "Максимальный этаж. Только для квартир и комнат. (Highest floor. Apartments and rooms only.)"
},
"notFirstFloor": {
"title": "Не первый этаж (Not first floor)",
"type": "boolean",
"description": "Исключить первый этаж. Только для квартир и комнат. (Exclude the first floor. Apartments and rooms only.)"
},
"notLastFloor": {
"title": "Не последний этаж (Not last floor)",
"type": "boolean",
"description": "Исключить последний этаж. Только для квартир и комнат. (Exclude the last floor. Apartments and rooms only.)"
},
"houseType": {
"title": "Тип дома (House type)",
"type": "string",
"description": "Материал дома. Для домов это «Материал стен»: кирпич, брус, бревно. Только для квартир, комнат и домов. (Building material; houses use their own wording. Apartments, rooms and houses only.)"
},
"renovation": {
"title": "Ремонт (Renovation)",
"type": "string",
"description": "Варианты зависят от типа сделки: у продажи «С ремонтом» и «Без ремонта», у аренды и вторички ещё «Косметический», «Евро», «Дизайнерский». Только для квартир и домов. (Options depend on the deal type. Apartments and houses only.)"
},
"objectType": {
"title": "Вид объекта (Object type)",
"type": "string",
"description": "Для коммерции: офис, склад, торговая площадь, производство, общепит. Для домов: дом, дача, коттедж, таунхаус. Для гаражей: гараж, машиноместо. (Commercial, houses and garages each have their own list.)"
},
"buildingType": {
"title": "Тип здания (Building type)",
"type": "string",
"description": "Только для коммерческой недвижимости: бизнес-центр, торговый центр, административное здание. (Commercial only.)"
},
"sellerType": {
"title": "Продавец (Seller)",
"enum": [
"any",
"owner",
"agency"
],
"type": "string",
"description": "Собственники или агентства. (Private owners or agencies.)",
"default": "any"
},
"metroWalkMinutes": {
"title": "Пешком до метро, мин. (Metro walk, min)",
"enum": [
"5",
"10",
"15",
"20",
"30"
],
"type": "string",
"description": "Не дальше указанного числа минут пешком от метро. (Within this many minutes' walk of a metro station.)"
},
"descriptionKeywords": {
"title": "Слова в описании (Words in description)",
"type": "string",
"description": "Например «балкон» или «без комиссии». (E.g. balcony or no commission.)"
},
"filters": {
"title": "Остальные фильтры (More filters)",
"type": "object",
"description": "Любой фильтр раздела, которого нет отдельным полем: ключ это имя фильтра, значение это его значение. Отели: {\"stars\": \"4\", \"meals\": \"Завтрак\"}. Числовой фильтр можно задать как {\"yearBuiltMin\": 2001, \"yearBuiltMax\": 2015} или одним диапазоном {\"yearBuilt\": {\"from\": 2001, \"to\": 2015}}. Незнакомый фильтр остановит запуск и покажет, что доступно в этом разделе. (Any other filter of the section, keyed by name. A numeric filter takes Min / Max fields or one range. Unknown names stop the run and list what the section offers.)"
},
"checkIn": {
"title": "Заезд (Check-in)",
"type": "string",
"description": "Только посуточно, в формате ГГГГ-ММ-ДД, не в прошлом. (Daily rentals only, YYYY-MM-DD, not in the past.)"
},
"checkOut": {
"title": "Выезд (Check-out)",
"type": "string",
"description": "Только посуточно, в формате ГГГГ-ММ-ДД, минимум на день позже заезда. (Daily rentals only, YYYY-MM-DD, at least one day after check-in.)"
},
"guests": {
"title": "Гостей (Guests)",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Только посуточно и отели. Влияет на цену и на то, какое жильё доступно. (Daily rentals and hotels only. Affects the price and which places are available.)"
},
"childAges": {
"title": "Возраст детей (Child ages)",
"type": "array",
"description": "Возраст каждого ребёнка в годах, 0-17. Отели подбирают номера и считают цену по возрасту детей. (Age of each child in years, 0-17. Hotels pick rooms and price them by these ages.)",
"items": {
"type": "string"
}
},
"sort": {
"title": "Сортировка (Sort)",
"enum": [
"newest",
"cheapest",
"expensive",
"relevance"
],
"type": "string",
"description": "Порядок сортировки. (Sort order.)",
"default": "newest"
},
"maxResults": {
"title": "Макс. результатов (Max results)",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Максимум объявлений. (Maximum listings.)",
"default": 100
},
"includeDetails": {
"title": "Полные данные (Full details)",
"type": "boolean",
"description": "Адрес, координаты, описание, характеристики, продавец. (Address, coordinates, description, parameters, seller.)",
"default": false
},
"includePhone": {
"title": "Телефоны (Phone numbers)",
"type": "boolean",
"description": "Телефон продавца, где он открыт. Включает полные данные. У аренды номер часто скрыт за защищённым номером сайта. (Seller phone where published; includes full details.)",
"default": false
},
"feedback": {
"title": "Feedback to the maintainers",
"type": "string",
"description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns."
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}