{ "openapi": "3.0.1", "info": { "title": "Cian.ru Real Estate Scraper", "description": "Scrape cian.ru Russian real estate — flats, rooms, houses, new buildings, for sale or rent. One row per offer: price (RUB), rooms, area, floor, building year/material, full address, photos, and the agent/agency profile WITH phone number. Russian residential proxy included.", "version": "0.1", "x-build-id": "FU1KVc132lLdROSoy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~cian-real-estate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-cian-real-estate-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/memo23~cian-real-estate-scraper/runs": { "post": { "operationId": "runs-sync-memo23-cian-real-estate-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/memo23~cian-real-estate-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-cian-real-estate-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": { "startUrls": { "title": "cian.ru URLs (search or offer)", "type": "array", "description": "Search: https://www.cian.ru/cat.php?deal_type=sale&engine_version=2&offer_type=flat®ion=1 · Offer: https://www.cian.ru/sale/flat/330578186/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "dealType": { "title": "Deal type", "enum": [ "sale", "rent" ], "type": "string", "description": "Whether to scrape offers for sale or for rent. Used only when no URL is pasted above.", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "flat", "room", "house", "newBuilding" ], "type": "string", "description": "What kind of property to search: a secondary-market flat, a room, a house/suburban property, or a new building. Used only when no URL is pasted above.", "default": "flat" }, "region": { "title": "Region", "type": "string", "description": "cian region id, or a preset name: moscow, spb, moscow-oblast, novosibirsk, ekaterinburg, kazan, sochi, krasnodar. Default: moscow.", "default": "moscow" }, "roomsCount": { "title": "Rooms", "type": "array", "description": "Room counts to include (1–6; 6 = studio/5+). Empty = any.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms", "Studio / 5+" ] }, "default": [] }, "minPrice": { "title": "Min price (RUB)", "minimum": 0, "type": "integer", "description": "Lowest price to include, in RUB. Leave empty for no lower bound." }, "maxPrice": { "title": "Max price (RUB)", "minimum": 0, "type": "integer", "description": "Highest price to include, in RUB. Leave empty for no upper bound." }, "maxItems": { "title": "Max offers (total)", "minimum": 1, "type": "integer", "description": "Hard cap on the number of rows for the whole run, across every search. On the free Apify plan this is clamped to 100; any paid plan honours it in full.", "default": 1000 }, "maxItemsPerSearch": { "title": "Max offers per search", "minimum": 1, "type": "integer", "description": "cian returns ~28 offers per page. The total cap above always wins, including the free-plan 100-row clamp.", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many requests to run in parallel. 6 is a good balance; raise carefully.", "default": 6 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 40, "type": "integer", "description": "Each retry rotates to a fresh Russian residential IP.", "default": 12 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Leave this alone. cian.ru only answers Russian residential IPs, and the actor routes every run through its own RU residential pool at no extra cost. This field is an override for your OWN Russian proxies: set Custom proxy URLs, or pick a country or group deliberately. Simply leaving Apify Proxy selected is treated as the default and ignored, because Apify datacenter IPs get cian's security-check page instead of listings.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }