{
  "openapi": "3.0.1",
  "info": {
    "title": "Domclick Scraper | Парсер Домклик — недвижимость России",
    "description": "Парсер объявлений с Домклик (domclick.ru, Сбербанк). Квартиры, дома, коммерция по всей России — покупка и аренда. Цены, адреса, фото, координаты, данные о доме и продавце. Фильтры: комнаты, цена, площадь, ремонт, год постройки, тип продавца. До 50 000 объявлений за запуск.",
    "version": "0.0",
    "x-build-id": "c6lAmsohUS2BbtXeA"
  },
  "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",
              "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
          },
          "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
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}