{
  "openapi": "3.0.1",
  "info": {
    "title": "Domclick Scraper | Парсер Домклик — недвижимость России",
    "description": "Парсер объявлений с Домклик (domclick.ru, Сбербанк). Квартиры, дома, коммерция по всей России — покупка и аренда. Цены, адреса, фото, координаты, данные о доме и продавце. Фильтры: комнаты, цена, площадь, ремонт, год постройки, тип продавца. До 50 000 объявлений за запуск.",
    "version": "0.0",
    "x-build-id": "On33MEPhG8Lxkp1GC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zen-studio~domclick-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zen-studio-domclick-search-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~domclick-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-zen-studio-domclick-search-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~domclick-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-zen-studio-domclick-search-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",
        "required": [
          "location"
        ],
        "properties": {
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Город или регион <b>на русском языке</b> (city or region in Russian).<br>Введите любой город — актор найдёт его автоматически.<br><i>The actor resolves any Russian city/region name automatically.</i><br><br>Примеры / Examples: <code>Москва</code>, <code>Краснодар</code>, <code>Московская область</code>, <code>Республика Татарстан</code>"
          },
          "dealType": {
            "title": "Deal type",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Тип сделки — <b>покупка</b> (buy) или <b>аренда</b> (rent).<br>Влияет на фильтры и формат цены (полная стоимость или цена/месяц).<br><i>Affects available filters and price format.</i>",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "flat",
              "room",
              "house",
              "townhouse",
              "lot",
              "office",
              "retail",
              "free_purpose",
              "catering",
              "warehouse",
              "garage"
            ],
            "type": "string",
            "description": "Тип недвижимости для поиска.<br><br><b>Жильё (Residential):</b> квартира, комната, дом, таунхаус, участок<br><b>Коммерция (Commercial):</b> офис, торговая площадь, помещение свободного назначения, общепит, склад, гараж",
            "default": "flat"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Максимальное количество объявлений (max listings to scrape).<br><br>Для первого запуска рекомендуем <code>100</code> — быстро и дёшево.<br><i>Start with 100 for a cheap test run.</i> Максимум: <code>50 000</code>.",
            "default": 1000
          },
          "includePhones": {
            "title": "Include phone numbers",
            "type": "boolean",
            "description": "Включить телефоны продавцов в результаты (include seller phone numbers).<br><br>📞 Открытые номера без маскировки — прямой контакт с продавцом.<br><i>Unmasked phone numbers for direct contact with sellers.</i>",
            "default": true
          },
          "rooms": {
            "title": "Rooms",
            "type": "array",
            "description": "Фильтр по количеству комнат (filter by room count). Можно выбрать несколько.<br><br><b>Студия</b> (Studio) — открытая планировка без отдельных комнат.",
            "items": {
              "type": "string",
              "enum": [
                "studio",
                "1",
                "2",
                "3",
                "4",
                "5+"
              ],
              "enumTitles": [
                "Студия (Studio)",
                "1",
                "2",
                "3",
                "4",
                "5+"
              ]
            }
          },
          "priceMin": {
            "title": "Min price",
            "type": "integer",
            "description": "Минимальная цена (minimum price).<br>Для <b>покупки</b> — полная стоимость (total price), для <b>аренды</b> — цена в месяц (monthly rent)."
          },
          "priceMax": {
            "title": "Max price",
            "type": "integer",
            "description": "Максимальная цена (maximum price).<br>Для <b>покупки</b> — полная стоимость, для <b>аренды</b> — цена в месяц.<br><br>Пример / Example: <code>15000000</code> (квартира в Москве)"
          },
          "areaMin": {
            "title": "Min area",
            "type": "number",
            "description": "Минимальная общая площадь (minimum total area)."
          },
          "areaMax": {
            "title": "Max area",
            "type": "number",
            "description": "Максимальная общая площадь (maximum total area)."
          },
          "floorMin": {
            "title": "Min floor",
            "type": "integer",
            "description": "Минимальный этаж (minimum floor number).<br>Например, <code>2</code> — исключить первый этаж (exclude ground floor)."
          },
          "floorMax": {
            "title": "Max floor",
            "type": "integer",
            "description": "Максимальный этаж (maximum floor number).<br>Это этаж квартиры, не этажность дома.<br><i>This is the apartment floor, not the building height.</i>"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "price_asc",
              "price_desc",
              "price_per_m2_asc",
              "price_per_m2_desc"
            ],
            "type": "string",
            "description": "Порядок сортировки результатов (sort order).<br><b>По релевантности</b> — Domclick default sorting.",
            "default": "relevance"
          },
          "buildYearMin": {
            "title": "Min build year",
            "type": "integer",
            "description": "Минимальный год постройки дома (earliest construction year).<br>Пример: <code>2010</code> — только новостройки (new builds only)."
          },
          "buildYearMax": {
            "title": "Max build year",
            "type": "integer",
            "description": "Максимальный год постройки дома (latest construction year).<br>Пример: <code>1990</code> — только старый фонд (older buildings only)."
          },
          "renovation": {
            "title": "Renovation",
            "type": "array",
            "description": "Фильтр по типу ремонта (renovation type). Можно выбрать несколько.<br><br><b>Евроремонт</b> — качественный современный ремонт (high-quality modern renovation).<br><b>Дизайнерский</b> — авторский проект (custom designer renovation).",
            "items": {
              "type": "string",
              "enum": [
                "without_repair",
                "cosmetic",
                "euro",
                "design"
              ],
              "enumTitles": [
                "Без ремонта (No renovation)",
                "Косметический (Cosmetic)",
                "Евроремонт (Euro renovation)",
                "Дизайнерский (Designer)"
              ]
            }
          },
          "wallType": {
            "title": "Wall type",
            "type": "array",
            "description": "Фильтр по материалу стен дома (building material).<br><br><b>Монолит</b> и <b>кирпич-монолит</b> — современные, тёплые (modern, well-insulated).<br><b>Панель</b> — типовые серии, дешевле (prefab panels, cheaper).",
            "items": {
              "type": "string",
              "enum": [
                "monolith",
                "brick_monolith",
                "brick",
                "panel",
                "block",
                "wood"
              ],
              "enumTitles": [
                "Монолит (Monolith)",
                "Кирпич-монолит (Brick-monolith)",
                "Кирпич (Brick)",
                "Панель (Panel)",
                "Блок (Block)",
                "Дерево (Wood)"
              ]
            }
          },
          "metroWalkMinutes": {
            "title": "Max walk to metro",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Макс. время пешком до метро (max walking time to nearest metro).<br>Актуально для Москвы, СПб, Казани и др.<br><br>Рекомендуемые значения: <code>5</code>, <code>10</code>, <code>15</code>, <code>20</code>, <code>30</code>"
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "owner",
              "developer",
              "agent"
            ],
            "type": "string",
            "description": "Фильтр по типу продавца (filter by seller).<br><br><b>Собственник</b> (Owner) — без посредников, direct sale.<br><b>Застройщик</b> (Developer) — первичный рынок, новостройки.<br><b>Агент</b> (Agent) — риелтор или агентство."
          },
          "publishedWithin": {
            "title": "Published within",
            "enum": [
              "1h",
              "24h",
              "today",
              "10d",
              "30d"
            ],
            "type": "string",
            "description": "Только свежие объявления за указанный период (recently published only).<br><br>Полезно для мониторинга новых предложений. <i>Useful for monitoring new listings.</i>"
          },
          "includeNewBuildings": {
            "title": "Include new buildings",
            "type": "boolean",
            "description": "Включить квартиры в новостройках — планировки от застройщиков (include new-build layouts from developers).<br><br>⚠️ Работает только для <b>«Квартира» + «Покупка»</b>.<br><i>Only applies when property type is Apartment and deal type is Buy. Ignored otherwise.</i>",
            "default": true
          },
          "excludeApartments": {
            "title": "Exclude apartments",
            "type": "boolean",
            "description": "Исключить <b>апартаменты</b> из результатов (exclude apartments).<br><br>В России апартаменты имеют статус <b>нежилого помещения</b> — нельзя получить постоянную прописку, коммунальные платежи выше.<br><i>In Russia, «апартаменты» have non-residential legal status — no permanent registration (прописка), higher utility bills. They look like flats but differ legally.</i>",
            "default": false
          },
          "onlyInsideCity": {
            "title": "Only inside this city",
            "type": "boolean",
            "description": "Только объявления в черте города, без пригородов (only listings inside the city itself, no suburbs).<br>Без этой опции поиск по городу захватывает и соседние населённые пункты: например, «Москва» добавляет Красногорск, Люберцы и другие города Подмосковья.<br><br>⚠️ Работает только для <b>городов</b>. Для региона или села поиск идёт как обычно.<br>Для <b>Сочи</b> опция убирает и сёла Сочинского района за чертой города (Верхневеселое, Раздольное и другие).<br><i>Without this option a city search also includes nearby towns (for «Москва»: Krasnogorsk, Lyubertsy and other Moscow Oblast towns). Works for cities only; a region or village search runs as usual. For Sochi it also leaves out the villages of the Sochi district outside the city.</i>",
            "default": false
          },
          "dropRepeatedListings": {
            "title": "Drop repeated listings",
            "type": "boolean",
            "description": "Убрать повторы, когда продавец разместил один объект дважды (remove repeats when a seller posts the same object twice).<br>Повтор — объявление с тем же <b>адресом</b>, <b>площадью</b> и <b>ценой</b>, что и уже выданное; остаётся первое. Повторы не попадают в результаты и не оплачиваются, а «Max results» считает только выданные объявления.<br>Два разных объекта в одном доме с одинаковой площадью и ценой тоже считаются повтором.<br><i>A repeat has the same address, area and price as a listing already returned; the first one is kept. Repeats are not returned or charged, and Max results counts returned listings only. Two different units in one building with the same area and price also count as a repeat.</i>",
            "default": false
          },
          "includePriceHistory": {
            "title": "Include price history",
            "type": "boolean",
            "description": "Загружать историю изменения цены (fetch price change history for each listing).<br><br>⚠️ <b>Замедляет парсинг</b> — дополнительный запрос на каждое объявление.<br><i>Slower — makes an extra request per listing. Useful for price trend analysis.</i>",
            "default": false
          },
          "includeDescription": {
            "title": "Include description",
            "type": "boolean",
            "description": "Включить полный текст описания объявления (include listing description text).<br><br>Описание пишется продавцом — детали о квартире, ремонте, инфраструктуре.<br><i>Seller-written description with details about the property, renovation, and neighborhood.</i>",
            "default": true
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}