Парсер недвижимости 2ГИС — 2GIS Property Scraper | Квартиры, дома, коммерция (2026)

От Zen Studio, создателей парсеров Яндекс Карт, Apple Maps, Ozon и Avito.
From Zen Studio, the team behind established maps and Russian marketplace scrapers.

Почему этот актор? / Why choose this actor?

Сравнивайте предложения в одном доме. / Compare listings within the same building.
Получайте количество объявлений в доме, минимальную цену и площадки размещения вместе с данными объявления, когда эти сведения доступны.
Get the building’s listing count, lowest asking price and listing platforms alongside each property, where available. Building totals cover the selected property category, not just listings matching your filters.

Оценивайте площадь и расположение. / Compare space and location.
Цена за м², комнаты, площадь, этаж, фото и описание помогают сравнить объекты. Ближайшие остановки и расстояния показывают транспортную доступность.
Compare price per m², rooms, area, floor, photos and descriptions. Nearby transport stops and distances add location detail; fields depend on the listing and city.

Команда №1 по «Yandex», «Ozon» и «Avito». / From the team behind #1 results for “Yandex”, “Ozon” and “Avito”.
Акторы Zen Studio заняли первое место по этим запросам в Apify Store по релевантности. Этот парсер создан той же командой, что и наши инструменты для 2ГИС и Яндекс Карт.
Zen Studio actors have ranked first for these searches by Apify Store relevance. This scraper comes from the same team behind our 2GIS and Yandex Maps tools.

Быстрый старт / Quick start

Начните с 10 объявлений о продаже жилья в Москве, затем выберите свой город и тип недвижимости.
Start with 10 residential sale listings in Moscow, then choose your city and property category.

{
  "location": "Moscow",
  "category": "sale_residential",
  "maxResults": 10
}

Открыть ввод / Open actor input. Настройте комнаты, площадь и цену, чтобы сравнивать подходящие объекты.
Set rooms, area and price filters to focus on comparable properties.

Минимальная цена в доме относится ко всей выбранной категории: это не обязательно похожая квартира или цена за м². Характеристики дома и транспортные данные доступны не везде.
The building’s lowest price covers the whole selected category; it is not necessarily a comparable apartment or a per-m² price. Building and transport details vary by location.

Zen Studio · 2GIS Suite
Places Phones & emails	Reviews Reviews & replies	Jobs Salaries & employers	Property Вы здесь

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

zen-studio/2gis-property-scraper on Apify. Call: ApifyClient("TOKEN").actor("zen-studio/2gis-property-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: location (string, required, city name e.g. "Moscow"), category (string, real estate type), maxResults (integer, 0=unlimited). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/zen-studio~2gis-property-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: pay-per-event, $0.003/listing. Get token: https://console.apify.com/account/integrations

---

Что вы получите

70 полей на каждое объявление — название, тип помещения, количество комнат, площадь, этаж, полный список характеристик, цена, период цены (сутки / месяц), цена за м², структурированные цены, валюта, описание, все категории, адрес и его структурированные компоненты, название жилого комплекса, ориентир, почтовый индекс, район, город, регион, страна, полная административная цепочка с ID, координаты (lat/lon), ссылка на объявление, провайдер (ЦИАН, ДомКлик), рекламная маркировка, фото, ближайшие станции транспорта.

Контекст по дому — сколько ещё объявлений в этом же доме и с какой цены они начинаются. Считается по всей категории, а не по вашим фильтрам, поэтому показывает весь дом целиком. How many other listings sit in the same building and the cheapest of them.

Данные о доме — этажность, материал стен, год постройки, тип дома, лифты, аварийность, количество квартир и подъездов. То, по чему уже можно было фильтровать на входе, теперь возвращается и в результате. Building data: floor count, wall material, year built, building type, apartments and entrances.

5 категорий — продажа жилой, продажа коммерческой, аренда жилой, аренда коммерческой, посуточная аренда. Переключайте одним параметром.

12 фильтров — комнаты, цена, цена за м², площадь, тип помещения, новостройка/вторичка, этаж, не первый/последний этаж, этажность дома, близость к метро, провайдер. Все фильтры работают на стороне сервера — возвращаются только подходящие объявления.

Ключевые возможности — Key Capabilities

• Высокая скорость: объявления собираются за секунды, без дополнительной настройки
• 12 фильтров — комнаты, цена, площадь, этаж, тип помещения, метро и другие — серверная фильтрация
• 5 категорий — продажа/аренда жилой и коммерческой недвижимости + посуточная аренда
• Период аренды — сут. или мес. рядом с ценой: посуточная и помесячная аренда больше не выглядят одинаково
• Характеристики дома — этажность, материал, год постройки и количество квартир для каждого объявления
• 7 языков — характеристики возвращаются на языке запроса, а не только на русском
• Россия, Казахстан, Кыргызстан — 155+ российских городов + Алматы, Атырау, Семей, Бишкек и другие

---

Быстрый старт — Quick Start

Минимальный — квартиры на продажу в Москве

{
    "location": "Moscow",
    "maxResults": 100
}

Аренда с фильтрами — 1-2 комнаты до 50,000

{
    "location": "Saint Petersburg",
    "category": "rent_residential",
    "rooms": ["1", "2"],
    "priceMax": 50000,
    "notFirstFloor": true,
    "maxResults": 500
}

Коммерческая недвижимость — по цене

{
    "location": "Moscow",
    "category": "sale_commercial",
    "sort": "price_asc",
    "areaMin": 50,
    "areaMax": 200,
    "maxResults": 200
}

Полная конфигурация — Full Configuration

{
    "location": "Moscow",
    "country": "RU",
    "language": "ru",
    "category": "sale_residential",
    "sort": "price_asc",
    "rooms": ["2", "3"],
    "priceMin": 10000000,
    "priceMax": 25000000,
    "notFirstFloor": true,
    "notLastFloor": true,
    "maxResults": 1000,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

---

Входные параметры — Input Parameters

Местоположение (Location)

Параметр	Тип	Описание	По умолчанию
location	string	Город для поиска на русском или английском. City name in English or Russian. Примеры: Moscow / Москва, Saint Petersburg / Санкт-Петербург, Almaty / Алматы	— (обязательный / required)
country	string	Страна для уточнения города. Country code to disambiguate city names (RU, KZ, AE, etc.)	Авто
language	string	Язык результатов. Language: ru, en, kk, uz, ky, ar, cs	ru

Фильтры (Filters)

Параметр	Тип	Описание	По умолчанию
category	string	Категория. sale_residential, sale_commercial, rent_residential, rent_commercial, daily_rent	sale_residential
sort	string	Сортировка. price_asc, price_desc, area_asc, area_desc	По умолчанию
rooms	array	Комнаты. studio, 1, 2, 3, 4, 5 (можно несколько). Не во всех городах	Все
propertyType	array	Тип помещения. flat, house, land, cottage, room, townhouse, share, part_house. Не во всех городах	Все
newBuilding	array	Новостройка/вторичка. secondary, new. Не во всех городах	Все
priceMin	integer	Минимальная цена. Minimum price	—
priceMax	integer	Максимальная цена. Maximum price	—
pricePerMeterMin	number	Цена за м² от. Min price per m²	—
pricePerMeterMax	number	Цена за м² до. Max price per m²	—
areaMin	number	Площадь от (м²). Min area	—
areaMax	number	Площадь до (м²). Max area	—
floorMin	integer	Этаж от. Min floor	—
floorMax	integer	Этаж до. Max floor	—
notFirstFloor	boolean	Не первый этаж. Exclude first floor	false
notLastFloor	boolean	Не последний этаж. Exclude last floor	false
floorsInBuildingMin	integer	Этажей в доме от. Min floors in building	—
floorsInBuildingMax	integer	Этажей в доме до. Max floors in building	—
metroTime	string	До метро. 0,5 (5 мин), 0,10 (10 мин), 0,20 (20 мин). Работает в городах с метро (Москва и др.)	Любое
provider	array	Источник объявлений. cian, domclick. Не во всех городах	Все
maxResults	integer	Макс. объявлений. Max listings to scrape. 0 or empty = unlimited	1000

Система (System)

Параметр	Тип	Описание	По умолчанию
proxyConfiguration	object	Настройка прокси. Proxy configuration	Apify Residential

Residential proxy is used by default, including when proxyConfiguration is omitted, because it is what keeps results reliable. To run without a proxy instead, pass {"useApifyProxy": false}.

---

Категории — Categories

category	Категория	Category
sale_residential	Продажа жилой	Sale — Residential
sale_commercial	Продажа коммерческой	Sale — Commercial
rent_residential	Аренда жилой	Rent — Residential
rent_commercial	Аренда коммерческой	Rent — Commercial
daily_rent	Посуточная аренда	Daily Rent

---

Пример выходных данных — Output Example

Каждое объявление — отдельная строка. 70 полей, готово для CSV. Ниже реальная строка со всеми полями, которые возвращает актор — длинные списки и строки укорочены, ничего не пропущено:

{
  "productId": "70250202177843095",
  "name": "2-комнатная, 57,8 м²",
  "description": "Проект ''Московские кварталы'' — это строящиеся и готовые квартиры во всех столичных округ …",
  "categoryId": "70241201812761646",
  "categoryName": "Продажа жилой недвижимости",
  "productType": "realty_product",
  "categories": [
    {
      "id": "70241201812761646",
      "label": "Продажа жилой недвижимости"
    }
  ],
  "propertyType": "Квартира",
  "rooms": 2,
  "area": 57.8,
  "floor": 14,
  "attributes": [
    {
      "caption": "Тип помещения",
      "value": "Квартира",
      "groupId": "70239201812761147"
    },
    {
      "caption": "Количество комнат",
      "value": "2",
      "groupId": "70239201812761147"
    },
    "… 2 more"
  ],
  "price": 28060360,
  "pricePeriod": null,
  "currency": "RUB",
  "pricePerSqm": 485473.36,
  "priceValue": {
    "value": 28060360,
    "currency": "RUB"
  },
  "countryPriceValue": {
    "value": 28060360,
    "currency": "RUB"
  },
  "countryPricePerMeter": {
    "value": 485473.36,
    "currency": "RUB"
  },
  "currencyUpdatedAt": null,
  "marketPrice": null,
  "ctaLabel": "Перейти к объявлению",
  "listingUrl": "https://www.cian.ru/sale/flat/333729616/?utm_campaign=b2c_nov_mskmo_perf_mix_feed&utm_medi …",
  "isRecent": true,
  "images": [
    "https://images.cdn-cian.ru/images/2960808507-1.jpg",
    "https://images.cdn-cian.ru/images/2960808531-1.jpg",
    "… 7 more"
  ],
  "provider": "ЦИАН",
  "providerBranchId": "70000001033422930",
  "providerOrgId": "70000001033422929",
  "buildingId": "70030076558759704",
  "buildingGroupId": null,
  "address": "Кусковская улица, 12/1",
  "buildingName": null,
  "addressComponents": [
    {
      "street": "Кусковская улица",
      "number": "12/1",
      "streetId": "4504338361747006",
      "type": "street_number"
    }
  ],
  "addressBuildingId": "70030076558759704",
  "landmark": null,
  "postcode": "111398",
  "city": "Москва",
  "district": "Новогиреево",
  "districtArea": null,
  "livingArea": null,
  "region": "Москва",
  "country": "Россия",
  "admDivisions": [
    {
      "type": "country",
      "id": "1",
      "name": "Россия",
      "cityAlias": null,
      "flags": null
    },
    {
      "type": "region",
      "id": "5349042514588558",
      "name": "Москва",
      "cityAlias": null,
      "flags": null
    },
    "… 2 more"
  ],
  "lat": 55.737395,
  "lon": 37.774927,
  "buildingPurpose": "Жилой дом",
  "buildingPurposeCode": 42,
  "floorCount": 17,
  "yearBuilt": 2024,
  "buildingMaterial": "Монолит",
  "floorType": "",
  "gasType": "",
  "elevatorCount": 38,
  "isInEmergencyState": false,
  "heritageName": "",
  "heritageCategory": "",
  "apartmentCount": 1260,
  "entranceCount": 19,
  "hasApartmentsInfo": true,
  "apartmentCountFromEntrances": 1260,
  "hasApartmentRanges": true,
  "realEntrances": [
    {
      "id": "70030077110069403",
      "number": "1",
      "name": "1 подъезд",
      "latitude": 55.738058,
      "longitude": 37.775235,
      "isPrimary": false,
      "isVisibleInUi": true,
      "isVisibleOnMap": true,
      "hasPoi": true,
      "geometry": {
        "points": [
          "POINT(37.775235 55.738058)",
          "POINT(37.775319 55.737932)"
        ],
        "vectors": [
          "LINESTRING(37.775186 55.738143,37.775235 55.738058)",
          "LINESTRING(37.775368 55.737846,37.775319 55.737932)"
        ],
        "normals": [
          "LINESTRING(37.277411 56.605336,37.775235 55.738058)",
          "LINESTRING(38.272919 54.870525,37.775319 55.737932)"
        ]
      },
      "apartmentsFrom": 1,
      "apartmentsTo": 60,
      "apartmentCount": 60,
      "apartmentRanges": [
        {
          "from": 1,
          "to": 24
        },
        {
          "from": 25,
          "to": 60
        }
      ],
      "apartmentsByFloor": [
        {
          "floorFrom": 1,
          "floorTo": 8,
          "floorLabel": null,
          "apartments": [
            {
              "from": 1,
              "to": 24
            }
          ]
        },
        {
          "floorFrom": 9,
          "floorTo": 17,
          "floorLabel": null,
          "apartments": [
            {
              "from": 25,
              "to": 60
            }
          ]
        }
      ]
    },
    {
      "id": "70030077110069401",
      "number": "2",
      "name": "2 подъезд",
      "latitude": 55.737988,
      "longitude": 37.774852,
      "isPrimary": false,
      "isVisibleInUi": true,
      "isVisibleOnMap": true,
      "hasPoi": true,
      "geometry": {
        "points": [
          "POINT(37.774852 55.737988)",
          "POINT(37.774963 55.737867)"
        ],
        "vectors": [
          "LINESTRING(37.774803 55.738073,37.774852 55.737988)",
          "LINESTRING(37.775012 55.737781,37.774963 55.737867)"
        ],
        "normals": [
          "LINESTRING(37.277937 56.605787,37.774852 55.737988)",
          "LINESTRING(38.272785 54.870587,37.774963 55.737867)"
        ]
      },
      "apartmentsFrom": 61,
      "apartmentsTo": 165,
      "apartmentCount": 105,
      "apartmentRanges": [
        {
          "from": 61,
          "to": 144
        },
        {
          "from": 145,
          "to": 165
        }
      ],
      "apartmentsByFloor": [
        {
          "floorFrom": 1,
          "floorTo": 14,
          "floorLabel": null,
          "apartments": [
            {
              "from": 61,
              "to": 144
            }
          ]
        },
        {
          "floorFrom": 15,
          "floorTo": 17,
          "floorLabel": null,
          "apartments": [
            {
              "from": 145,
              "to": 165
            }
          ]
        }
      ]
    },
    "… 17 more"
  ],
  "databaseEntrances": [
    {
      "id": "70030077110069405",
      "number": "",
      "name": "",
      "latitude": 55.738038633309955,
      "longitude": 37.77513012352094,
      "isPrimary": false,
      "isVisibleInUi": false,
      "isVisibleOnMap": false,
      "hasPoi": false,
      "geometry": {
        "points": [
          "POINT(37.775130123520938 55.738038633309955)"
        ],
        "vectors": [
          "LINESTRING(37.775081 55.738124,37.77513 55.738039)"
        ],
        "normals": [
          "LINESTRING(37.277084 56.605189,37.77513 55.738039)"
        ]
      },
      "apartmentsFrom": null,
      "apartmentsTo": null,
      "apartmentCount": null,
      "apartmentRanges": [],
      "apartmentsByFloor": []
    },
    {
      "id": "70030077140682416",
      "number": "",
      "name": "",
      "latitude": 55.737626694710116,
      "longitude": 37.77467081491616,
      "isPrimary": false,
      "isVisibleInUi": false,
      "isVisibleOnMap": false,
      "hasPoi": false,
      "geometry": {
        "points": [
          "POINT(37.774670814916163 55.737626694710116)"
        ],
        "vectors": [
          "LINESTRING(37.774519 55.737599,37.774671 55.737627)"
        ],
        "normals": [
          "LINESTRING(36.790897 55.558213,37.774671 55.737627)"
        ]
      },
      "apartmentsFrom": null,
      "apartmentsTo": null,
      "apartmentCount": null,
      "apartmentRanges": [],
      "apartmentsByFloor": []
    },
    "… 24 more"
  ],
  "listingsInBuilding": 38,
  "minPriceInBuilding": 16290000,
  "minPriceCurrencyInBuilding": "RUB",
  "providersInBuilding": [
    "ЦИАН"
  ],
  "nearestStations": [
    {
      "name": "Перово",
      "line": "D3 Ленинградско-Казанский диаметр",
      "color": "#E15D29",
      "routeLogo": "metro_moscow_D3",
      "distance": 900,
      "routeTypes": [
        "suburban_train",
        "mcd"
      ],
      "id": "4504385606390301"
    }
  ],
  "ads": null,
  "scrapedAt": "2026-09-09T07:31:41.057192+00:00"
}

Описание полей — Field reference

Поле / Field	Что это / Description
productId, name, description	Идентификатор, заголовок и текст объявления. ID, title and listing text
categoryId, categoryName	Первая категория (ID + название). First category id + label
categories	Все категории объявления [{id, label}]. All categories of the listing
productType	Тип карточки. Listing card type
propertyType, rooms, area, floor	Типизированные удобные поля. Typed convenience fields
attributes	Полный список характеристик [{caption, value, groupId}] — ничего не теряется. Full attribute list, nothing dropped
price, pricePeriod, currency, pricePerSqm	Цена, период (сут. / мес.), валюта и цена за м². Price, rental period, currency and price per m²
marketPrice	Оценка рыночного диапазона {lower, current, upper, isWithinMarketRange, url}, если её публикует источник объявления — редко. Provider valuation band, when the listing source publishes one — rare
priceValue, countryPriceValue, countryPricePerMeter	Структурированные цены {value, currency}. Structured price objects
currencyUpdatedAt	Когда обновлялась валюта. When the currency was last updated
ctaLabel	Подпись кнопки перехода к объявлению. Listing call-to-action label
listingUrl, isRecent, images	Ссылка, признак новизны, фотографии. Listing link, freshness flag, photos
provider, providerBranchId, providerOrgId	Источник объявления. Listing source / agency
buildingId, buildingGroupId	ID здания и группы зданий. Building and building-group ids
address, addressComponents, addressBuildingId	Адрес строкой + структурированные компоненты [{street, number, streetId, type}]. Address string + structured components
landmark	Ориентир. Landmark
buildingName	Название жилого комплекса (напр. «ЖК Пехра»). Residential complex name
postcode, city, district, districtArea, livingArea, region, country	Почтовый индекс и административное деление. Postcode and administrative division
admDivisions	Полная административная цепочка с ID [{type, id, name, cityAlias}]. Full administrative chain with ids
lat, lon	Координаты. Coordinates
nearestStations	Ближайшие станции [{name, line, color, routeLogo, distance, routeTypes, id}]. Nearest transit stations with line name, colour and logo
buildingPurpose, floorCount, buildingMaterial, yearBuilt	Тип дома, этажность, материал стен, год постройки. Building type, floors, wall material, year built
floorType, gasType, elevatorCount, isInEmergencyState	Перекрытия, газ, лифты, аварийность. Floor type, gas, lifts, emergency status
apartmentCount, entranceCount	Квартир и подъездов в доме. Apartments and entrances in the building
realEntrances, databaseEntrances	Подъезды с координатами и диапазонами квартир. Entrances with coordinates and apartment ranges
heritageName, heritageCategory	Объект культурного наследия. Listed-monument name and protection level
ads	Рекламная маркировка объявления. Paid-placement label
listingsInBuilding	Сколько объявлений в этом доме всего по выбранной категории. How many listings the building has in this category
minPriceInBuilding, minPriceCurrencyInBuilding	Самое дешёвое предложение в доме. Cheapest asking price in the building
providersInBuilding	Какие сервисы размещают объявления в этом доме. Which services list in this building
scrapedAt	Время извлечения. Scrape timestamp

---

Тарифы — Pricing (Pay Per Event)

Прозрачная тарификация за каждое объявление. Платите только за то, что извлекаете.

Событие

Event	Что тарифицируется	Free	Bronze	Silver	Gold
property_scraped	Каждое извлечённое объявление	$2.99 / 1,000	$2.79 / 1,000	$2.49 / 1,000	$1.99 / 1,000

Калькулятор стоимости

Мониторинг цен — 500 объявлений одного района:

Что	Количество	Стоимость
Объявления	500	$1.50
Итого		$1.50

Анализ рынка — аренда квартир Москвы (~5,000):

Что	Количество	Стоимость
Объявления	5,000	$14.95
Итого		$14.95

---

Использование через API — Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("zen-studio/2gis-property-scraper").call(run_input={
    "location": "Moscow",
    "category": "sale_residential",
    "rooms": ["2", "3"],
    "priceMax": 20000000,
    "maxResults": 500,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} — {item['price']} {item['currency']} — {item['address']}")

Использование через API — JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('zen-studio/2gis-property-scraper').call({
    location: 'Moscow',
    category: 'sale_residential',
    rooms: ['2', '3'],
    priceMax: 20000000,
    maxResults: 500,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.name} — ${item.price} ${item.currency} — ${item.address}`);
});

---

Продвинутые сценарии — Advanced Examples

Аренда в Алматы — Rent in Almaty

{
    "location": "Almaty",
    "country": "KZ",
    "category": "rent_residential",
    "maxResults": 1000
}

Премиальные квартиры Москвы — от 50M

{
    "location": "Moscow",
    "category": "sale_residential",
    "priceMin": 50000000,
    "sort": "price_desc",
    "maxResults": 0
}

Новостройки Петербурга — 1-2 комнаты

{
    "location": "Saint Petersburg",
    "category": "sale_residential",
    "newBuilding": ["new"],
    "rooms": ["1", "2"],
    "notFirstFloor": true,
    "maxResults": 0
}

Небольшие коммерческие помещения

{
    "location": "Novosibirsk",
    "category": "sale_commercial",
    "areaMin": 30,
    "areaMax": 100,
    "sort": "price_asc",
    "maxResults": 500
}

---

Поддерживаемые города — Supported Cities

Note: 2GIS real estate listings are available in Russia, Kazakhstan, and Kyrgyzstan. Other 2GIS regions (UAE, Saudi Arabia, etc.) have maps and places but no property listings.

Россия (155+ городов) — Москва, Санкт-Петербург, Новосибирск, Екатеринбург, Казань, Нижний Новгород, Челябинск, Самара, Ростов-на-Дону, Уфа, Красноярск, Воронеж, Пермь, Волгоград, Краснодар, Тюмень, Иркутск, Омск, Томск, Сочи и другие.

Казахстан — Алматы, Атырау, Семей, Петропавловск. Алматы — полный набор фильтров (12), остальные — базовые.

Кыргызстан — Бишкек и область. Базовые фильтры и сортировка.

Набор доступных фильтров зависит от города. Если фильтр недоступен — парсер предупредит и вернёт результаты без этого критерия.

---

Поддерживаемые языки — Supported Languages

Русский, English, العربية (Arabic), Қазақша (Kazakh), O'zbek (Uzbek), Кыргызча (Kyrgyz), Čeština (Czech).

---

Экспорт данных — Data Export

Экспортируйте результаты в любом формате из платформы Apify:

• JSON — структурированные данные для API-интеграций и баз данных
• CSV — плоские таблицы для Excel, Google Sheets, импорта в CRM
• Excel (.xlsx) — готово для отчётов и визуализации
• XML — для интеграции с legacy-системами

---

Прокси — Proxy Configuration

Резидентные прокси рекомендуются для стабильного извлечения. Конфигурация по умолчанию работает из коробки:

{
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

---

FAQ — Часто задаваемые вопросы

Q: Сколько объявлений можно собрать? A: Установите maxResults в 0 для неограниченного извлечения. Парсер соберёт все доступные объявления в указанном городе. В Москве, например, более 200,000 объявлений о продаже жилья.

Q: Нужен ли аккаунт 2ГИС? A: Нет. Без логина, без cookies, без браузера. Работает сразу.

Q: Откуда берутся объявления? A: 2ГИС агрегирует объявления с нескольких площадок: ЦИАН, ДомКлик и других. Поле provider указывает источник каждого объявления.

Q: Можно ли комбинировать фильтры? A: Да. Все 12 фильтров можно комбинировать. Например: 2-3 комнаты, до 15 млн, не первый этаж, рядом с метро.

Q: Чем отличается от парсера мест (Places Scraper)? A: /zen-studio/2gis-places-scraper-api собирает данные организаций (125+ полей). Property парсер специализируется на объявлениях недвижимости: цена, площадь, комнаты, этаж, ссылка на объявление. Разные API, разные данные.

Q: Нужны отзывы об агентствах недвижимости? A: Используйте /zen-studio/2gis-reviews-scraper — парсер отзывов с 7 фильтрами. Соберите отзывы о риелторах и агентствах в плоском формате для анализа.

Q: Looking for job vacancies in real estate? A: Use /zen-studio/2gis-jobs-scraper — scrapes job listings with 224 categories including real estate agents, property managers, and more.

Q: Как работает фильтр по типу помещения? A: propertyType принимает массив значений: flat (квартира), room (комната), house (дом), townhouse (таунхаус), land (участок) и другие. Можно выбрать несколько типов одновременно.

Q: Does it work outside Russia? A: Realty listings are available in Russia (155+ cities), Kazakhstan (Almaty, Atyrau, Semey, Petropavlovsk), and Kyrgyzstan (Bishkek). Other countries (UAE, Saudi Arabia, etc.) have 2GIS maps and places but no real estate data on the platform.

Q: What does the output include? A: 70 fields per listing: name, property type, rooms, area, floor, full attribute list, price, rental period (per night / per month), price per m², structured price objects, currency, description, all categories, listing URL, images, provider (CIAN, Domclick), paid-placement label, address with structured components, residential complex name, landmark, postcode, city, district, region, country, full administrative chain with ids, GPS coordinates, nearest transport stations, the building's floor count, wall material, year built, building type, lifts, apartment and entrance counts, and scraping timestamp.

Q: Do all filters work in all countries? A: Filter availability depends on the city, not the country. Most Russian cities and Almaty support all 12 filters. Smaller cities may have fewer filters — the scraper will warn you if a filter is unavailable and return results without that criteria. Metro proximity works only in cities with metro data (e.g., Moscow, Saint Petersburg, Novosibirsk).

Q: Can I filter by multiple room counts? A: Yes. The rooms parameter accepts an array: ["1", "2", "3"] will return 1-, 2-, and 3-room apartments. Use "studio" for studios, "5" for 5+ rooms.

Q: Что если в городе нет объявлений? A: Парсер просто завершит работу с нулевым результатом. Никаких ошибок, никаких лишних расходов.

---

Начало работы — Getting Started

1. Создайте аккаунт Apify

Зарегистрируйтесь бесплатно — новые пользователи получают $5 кредитов.

2. Выберите город

Введите название города на русском или английском. Россия, Казахстан, Кыргызстан.

3. Настройте фильтры

Выберите категорию (продажа/аренда), комнаты, диапазон цен, площадь. Начните с небольшого maxResults (50–100) для предпросмотра.

4. Запустите и экспортируйте

Запустите парсер, дождитесь результатов, скачайте в JSON/CSV/Excel. Или используйте API для автоматизации.

---

Disclaimer

Data is collected from publicly available sources and provided "as is" for informational purposes. Users are responsible for compliance with 2GIS' terms of service and applicable regulations in their jurisdiction.

---

Квартиры, дома, коммерческая недвижимость из крупнейшего справочника России, Казахстана и Кыргызстана — в структурированном формате за минуты.