{
  "openapi": "3.0.1",
  "info": {
    "title": "Cian Scraper | Real Estate Listings and Phones",
    "description": "Cian scraper (Циан, Парсер Циан) for Russian real estate listings: flats, rentals, new builds, houses and offices. Search by city or paste any cian.ru URL to get price, price history, views, seller phones, metro and coordinates. 100 listings in 23 seconds, 51 fields each, ready as CSV or JSON.",
    "version": "1.0",
    "x-build-id": "DQqzqo2mm2Gtet3UC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~cian-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-cian-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/silentflow~cian-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-cian-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/silentflow~cian-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-cian-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": {
          "location": {
            "title": "📍 Cities or regions",
            "type": "array",
            "description": "One or more cities or regions of Russia, each searched on its own with its own cap: <code>Москва</code>, <code>Санкт-Петербург</code>, <code>Казань</code>, <code>Московская область</code>. English names of the big cities work too (<code>Moscow</code>, <code>Saint Petersburg</code>, <code>Kazan</code>), and so does a Cian region id (<code>4777</code>). Leave it empty when you paste search URLs below.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Cian search or listing URLs",
            "type": "array",
            "description": "Paste any cian.ru address copied from your browser:<ul><li><b>A results page</b>, with every filter you set on the site applied as is (district, metro, map area, price, rooms, floor, renovation, owner only, publication date, amenities): <code>https://www.cian.ru/cat.php?deal_type=sale&offer_type=flat&region=1&room2=1</code></li><li><b>A listing</b>, or just its id, to get that listing in full whatever the cap: <code>https://www.cian.ru/sale/flat/336217162/</code></li></ul>Many URLs are read in one run.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "operationType": {
            "title": "🤝 Sale or rent",
            "enum": [
              "sale",
              "rent",
              "dailyRent"
            ],
            "type": "string",
            "description": "Flats for sale, for long-term rent, or for daily rent. A property type picked below decides on its own.",
            "default": "sale"
          },
          "category": {
            "title": "🏠 Property type",
            "enum": [
              "flatSale",
              "newBuildingFlatSale",
              "flatRent",
              "dailyFlatRent",
              "roomSale",
              "roomRent",
              "houseSale",
              "houseRent",
              "townhouseSale",
              "landSale",
              "officeSale",
              "officeRent",
              "shoppingAreaSale",
              "shoppingAreaRent",
              "warehouseSale",
              "warehouseRent",
              "freeAppointmentObjectSale",
              "freeAppointmentObjectRent",
              "garageSale",
              "garageRent",
              "businessSale"
            ],
            "type": "string",
            "description": "What to search. Leave empty for flats, following <b>Sale or rent</b>."
          },
          "rooms": {
            "title": "🛏️ Rooms",
            "type": "array",
            "description": "Room counts to keep, any combination. Leave empty for all.",
            "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 and more"
              ]
            }
          },
          "minPrice": {
            "title": "💸 Min price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price in roubles: the sale price, or the monthly (daily) rent."
          },
          "maxPrice": {
            "title": "💰 Max price (RUB)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price in roubles: <code>15000000</code> keeps flats up to 15 million ₽."
          },
          "minArea": {
            "title": "📐 Min area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Smallest total area in square metres."
          },
          "maxArea": {
            "title": "📐 Max area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Largest total area in square metres."
          },
          "sort": {
            "title": "↕️ Sort by",
            "enum": [
              "default",
              "creationDateDesc",
              "creationDateAsc",
              "priceAscending",
              "priceDescending",
              "priceForMeter",
              "area",
              "walkingTime"
            ],
            "type": "string",
            "description": "The order listings are read in. <b>Newest first</b> with a small cap is the way to watch fresh listings every day.",
            "default": "default"
          },
          "maxItems": {
            "title": "🔢 Max listings per search",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each city and each search URL after this many listings. Cian shows about 1,500 listings for one search; past that, the search is read price range by price range, so a whole city can be collected. Listing URLs always give their row, whatever this cap. The cost grows with the number of listings.",
            "default": 100
          },
          "includeDetails": {
            "title": "📋 Full listing details",
            "type": "boolean",
            "description": "Read each listing's page for its <b>price history</b>, <b>views</b> (total and today), the seller's number of listings and <b>every characteristic</b> (ceiling height, bathroom, view, renovation, building series, heating...). Turn off for the fastest bulk runs: rows keep price, phones, address, metro and photos.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}