{
  "openapi": "3.0.1",
  "info": {
    "title": "Авито Недвижимость: Парсер / Avito Real Estate Scraper",
    "description": "Парсер недвижимости Авито: квартиры, комнаты, дома, участки, коммерческая недвижимость и гаражи. Аренда, продажа, посуточно и отели. Цена за м², площадь, этаж, адрес, координаты, продавец.",
    "version": "0.0",
    "x-build-id": "6aZ2Q9fGzmCmn7tJU"
  },
  "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": "Вставьте ссылку на поиск или категорию с сайта. Её фильтры применяются автоматически, поэтому поля фильтров задавать не нужно. Цена, продавец и сортировка дополняют ссылку, если в ней их нет. (Paste a search or category URL. Its own filters are used; price, seller and sort fill in where the URL is silent.)"
          },
          "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; new-build and resale to apartments; hotels are daily only.)",
            "default": "sale"
          },
          "location": {
            "title": "Местоположение (Location)",
            "type": "string",
            "description": "Город или регион. (City or region.)",
            "default": "Россия"
          },
          "rooms": {
            "title": "Комнат (Rooms)",
            "type": "array",
            "description": "Например <code>[\"studio\", \"1\", \"2\"]</code>. Для квартир и домов; у комнат вместо этого фильтр «Комнат в квартире». (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.)"
          },
          "landAreaMax": {
            "title": "Участок до (Land to)",
            "type": "integer",
            "description": "Максимальная площадь участка. (Maximum land area.)"
          },
          "floorMin": {
            "title": "Этаж от (Floor from)",
            "type": "integer",
            "description": "Минимальный этаж. (Lowest floor.)"
          },
          "floorMax": {
            "title": "Этаж до (Floor to)",
            "type": "integer",
            "description": "Максимальный этаж. (Highest floor.)"
          },
          "notFirstFloor": {
            "title": "Не первый этаж (Not first floor)",
            "type": "boolean",
            "description": "Исключить первый этаж. (Exclude the first floor.)"
          },
          "notLastFloor": {
            "title": "Не последний этаж (Not last floor)",
            "type": "boolean",
            "description": "Исключить последний этаж. (Exclude the last floor.)"
          },
          "houseType": {
            "title": "Тип дома (House type)",
            "type": "string",
            "description": "Материал дома. Для домов это «Материал стен»: кирпич, брус, бревно. (Building material; houses use their own wording.)"
          },
          "renovation": {
            "title": "Ремонт (Renovation)",
            "type": "string",
            "description": "Варианты зависят от типа сделки: у продажи «С ремонтом» и «Без ремонта», у аренды и вторички ещё «Косметический», «Евро», «Дизайнерский». (Options depend on the deal type.)"
          },
          "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": "Любой фильтр раздела, которого нет отдельным полем: ключ это имя фильтра, значение это его значение. Отели: <code>{\"stars\": \"4\", \"meals\": \"Завтрак\"}</code>. Незнакомый фильтр остановит запуск и покажет, что доступно в этом разделе. (Any other filter of the section, keyed by name. 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
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}