{ "openapi": "3.0.1", "info": { "title": "Cian RU – Property Listings, Search Filters & URLs", "description": "Collect property listings from Cian.ru by search filters or direct URLs. Returns structured rows with listing URL, title, price, address, rooms, area, floors, photos, visible contact fields, coordinates when available, and optional detail-page enrichment.", "version": "0.1", "x-build-id": "A7wSAa7dM0yGscuxC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~cian-ru-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-cian-ru-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/abotapi~cian-ru-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-cian-ru-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/abotapi~cian-ru-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-cian-ru-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": [ "mode", "maxItems" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose search filters or direct listing/search URLs.", "default": "search" }, "urls": { "title": "URLs", "type": "array", "description": "Cian listing URLs or search-result URLs. Used only in URL mode. Encode any filters directly in the URL, because the search filters below are ignored in URL mode.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Search mode only. City, region, district, metro, or address. Known defaults include Moscow and Saint Petersburg." }, "regionId": { "title": "Region ID", "minimum": 0, "type": "integer", "description": "Search mode only. Optional Cian region ID. Moscow is 1, Saint Petersburg is 2. Leave empty to resolve from Location when possible." }, "operationType": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Search mode only. Deal type for search mode.", "default": "sale" }, "category": { "title": "Category", "enum": [ "", "flatSale", "flatRent", "roomSale", "roomRent", "newBuildingFlatSale", "houseSale", "houseRent", "commercialLandSale", "commercialLandRent", "freeAppointmentObjectSale", "freeAppointmentObjectRent", "officeSale", "officeRent", "shoppingAreaSale", "shoppingAreaRent", "warehouseSale", "warehouseRent", "garageSale", "garageRent" ], "type": "string", "description": "Search mode only. Listing category. Choose Any to let operation and property type decide.", "default": "" }, "sort": { "title": "Sort", "enum": [ "default", "priceAscending", "priceForMeter", "priceForMeterDesc", "area", "date", "walkingTime" ], "type": "string", "description": "Search mode only. Sort results when supported by the selected source.", "default": "default" }, "rooms": { "title": "Rooms", "type": "array", "description": "Search mode only. Room counts for flats and rooms.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "Studio", "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms", "6 rooms" ] } }, "includeStudio": { "title": "Include studio", "type": "boolean", "description": "Search mode only. Include studio listings together with selected room counts.", "default": false }, "minPrice": { "title": "Min price (RUB)", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum price in rubles." }, "maxPrice": { "title": "Max price (RUB)", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum price in rubles." }, "minArea": { "title": "Min area", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum total area in square meters." }, "maxArea": { "title": "Max area", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum total area in square meters." }, "minFloor": { "title": "Min floor", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum floor." }, "maxFloor": { "title": "Max floor", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum floor." }, "minFloors": { "title": "Min building floors", "minimum": 0, "type": "integer", "description": "Search mode only. Minimum floors in the building." }, "maxFloors": { "title": "Max building floors", "minimum": 0, "type": "integer", "description": "Search mode only. Maximum floors in the building." }, "advancedFilters": { "title": "Advanced Cian filters", "type": "object", "description": "Search mode only. Raw Cian query objects merged into the search, e.g. {\"repair\":{\"type\":\"terms\",\"value\":[2,3]}}. For power users who know Cian's query field names." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum matching rows to save. Fewer rows can be returned when the selected source and filters match fewer live records.", "default": 20 }, "maxPages": { "title": "Max pages", "minimum": 0, "type": "integer", "description": "No page limit when set to 0. The run stops at Max items.", "default": 0 }, "proxy": { "title": "Proxy", "type": "object", "description": "Proxy configuration. The default works on every plan. Switch groups if you start seeing access checks.", "default": { "useApifyProxy": true } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON. The complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max connector items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum saved records to export to selected MCP connectors.", "default": 50 } } }, "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 } } } } } } } } } }