{
  "openapi": "3.0.1",
  "info": {
    "title": "Reality.iDNES.cz Scraper ($3.80/1K): Real Estate & Monitor",
    "description": "Scrape reality.idnes.cz: flats, houses, land, commercial, rentals and auctions by URL, location, region, district or ID. Price, price per m², GPS, agency, parameters, listing date. Monitoring of new, changed and removed listings. Unofficial.",
    "version": "0.0",
    "x-build-id": "7NghxMXeSKm8LKZ2E"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~idnes-reality-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-idnes-reality-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/tsutseisoftware~idnes-reality-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-idnes-reality-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/tsutseisoftware~idnes-reality-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-idnes-reality-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": "iDNES Reality search or listing URLs",
            "type": "array",
            "description": "Search pages from reality.idnes.cz (set the filters on the website and paste the URL, e.g. https://reality.idnes.cz/s/prodej/byty/praha/?s-qc%5BsubtypeFlat%5D=2k) or listings (…/detail/…/6a883699007ec0e42e0cf59d/). All the website's filters in the URL are kept. The \"Website filters\" below apply to the searches built from the fields of this input; \"Filters\" apply to everything.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "transactionType": {
            "title": "Transaction",
            "enum": [
              "sale",
              "rent",
              "auction"
            ],
            "type": "string",
            "description": "For the search built from the fields below (locations, regions, districts; or the whole country when no URL, location, region, district or ID is given).",
            "default": "sale"
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "For the search built from these fields (default: flats). Each type is its own search on the website.",
            "items": {
              "type": "string",
              "enum": [
                "flat",
                "house",
                "land",
                "commercial",
                "other"
              ],
              "enumTitles": [
                "Flats (Byty)",
                "Houses (Domy)",
                "Land (Pozemky)",
                "Commercial (Komerční)",
                "Garages and other (Garáže a ostatní)"
              ]
            }
          },
          "subtypes": {
            "title": "Subtypes / layouts",
            "type": "array",
            "description": "As on Sreality.cz, so one input works for both: flats 1+kk, 1+1, 2+kk, 2+1, 3+kk, 3+1, 4+kk, 4+1, 5+kk, 5+1, 6 a více, Pokoj, Atypický; houses Rodinný, Chata (chata nebo chalupa), Na klíč, Ostatní; land Bydlení (stavební), Komerční, Pole, Lesy, Zahrady, Louky, Rybníky, Ostatní; commercial Kanceláře, Obchodní prostory, Sklady, Výroba, Ubytování, Restaurace, Činžovní dům, Zemědělský, Ostatní.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Towns, city parts, streets, districts or regions in words (e.g. \"Brno\", \"Praha 6\", \"Smíchov\", \"Říčany\"), looked up like the website's search box. Each location is its own search. Up to 20.",
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "Radius around the location (km)",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Also listings around each location (towns, city parts, streets, districts). The website offers 0.5, 1, 5, 10 and 20 km; other values are rounded up. 0 = only the location itself."
          },
          "regions": {
            "title": "Regions (kraje)",
            "type": "array",
            "description": "Whole regions, searched together.",
            "items": {
              "type": "string",
              "enum": [
                "10",
                "11",
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "13",
                "14",
                "8",
                "9",
                "12"
              ],
              "enumTitles": [
                "Praha",
                "Středočeský",
                "Jihočeský",
                "Plzeňský",
                "Karlovarský",
                "Ústecký",
                "Liberecký",
                "Královéhradecký",
                "Pardubický",
                "Vysočina",
                "Jihomoravský",
                "Olomoucký",
                "Zlínský",
                "Moravskoslezský"
              ]
            }
          },
          "districts": {
            "title": "Districts (okresy)",
            "type": "array",
            "description": "Districts by name, each its own search: e.g. \"Brno-město\", \"Praha-západ\", \"Kladno\".",
            "items": {
              "type": "string"
            }
          },
          "listingIds": {
            "title": "Listing IDs",
            "type": "array",
            "description": "iDNES Reality listing IDs (the 24 characters at the end of a listing URL, e.g. 6a883699007ec0e42e0cf59d). Each listing is read with its details. Up to 2000 per run.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings saved (and charged) in total. 0 = no limit (whole searches, e.g. all 26 000 flats for sale).",
            "default": 100
          },
          "maxItemsPerSearch": {
            "title": "Max listings per search",
            "minimum": 0,
            "type": "integer",
            "description": "Limit for each URL, location and search separately. 0 = no limit."
          },
          "includeDetails": {
            "title": "Add listing details",
            "type": "boolean",
            "description": "Read each listing's page too: GPS, description, all photos, parameters (floor, condition, building type, ownership, furnishing, energy class, balcony, cellar, elevator…), original price before a discount, price note, auction date and deposit, the agency. Charged as listing details and slower: 1 000 listings with details take about 17 minutes, so test a search without details first.",
            "default": false
          },
          "includeAgencyDetails": {
            "title": "Add agency IČO and website",
            "type": "boolean",
            "description": "With \"Add listing details\": also the agency's IČO and website, included in the details price.",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "Description length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters. 0 = full description."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "priceAsc",
              "priceDesc"
            ],
            "type": "string",
            "description": "Order of the results in each search. Empty = as in the URL (newest first by default)."
          },
          "minPrice": {
            "title": "Min price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Website filter for the searches built from this input."
          },
          "maxPrice": {
            "title": "Max price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Website filter. For rentals the monthly rent."
          },
          "minArea": {
            "title": "Min usable area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Website filter."
          },
          "maxArea": {
            "title": "Max usable area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Website filter."
          },
          "minPlotArea": {
            "title": "Min plot area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Website filter (houses and land)."
          },
          "maxPlotArea": {
            "title": "Max plot area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Website filter (houses and land)."
          },
          "maxAgeDays": {
            "title": "Listed or updated in the last … days",
            "minimum": 1,
            "maximum": 31,
            "type": "integer",
            "description": "Website filter \"Aktuálnost\": 1 (a day), 7 (a week) or 31 (a month); other values are rounded up. Empty = any age."
          },
          "conditions": {
            "title": "Building condition",
            "type": "array",
            "description": "Website filter: any of them.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "project",
                "under-construction",
                "good-condition",
                "maintained",
                "bad-condition",
                "after-reconstruction",
                "under-reconstruction",
                "before-reconstruction",
                "for-demolition"
              ],
              "enumTitles": [
                "New build (Novostavba)",
                "Project (Projekt)",
                "Under construction (Ve výstavbě)",
                "Good (Dobrý stav)",
                "Maintained (Udržovaný)",
                "Poor (Špatný stav)",
                "After reconstruction (Po rekonstrukci)",
                "In reconstruction (V rekonstrukci)",
                "Before reconstruction (Před rekonstrukcí)",
                "For demolition (K demolici)"
              ]
            }
          },
          "buildingTypes": {
            "title": "Building type",
            "type": "array",
            "description": "Website filter: any of them.",
            "items": {
              "type": "string",
              "enum": [
                "brick",
                "panel",
                "wood",
                "stone",
                "skeleton",
                "prefab",
                "mixed"
              ],
              "enumTitles": [
                "Brick (Cihlová)",
                "Panel (Panelová)",
                "Wooden (Dřevěná)",
                "Stone (Kamenná)",
                "Skeleton (Skeletová)",
                "Prefab (Montovaná)",
                "Mixed (Smíšená)"
              ]
            }
          },
          "ownership": {
            "title": "Ownership",
            "type": "array",
            "description": "Website filter: any of them.",
            "items": {
              "type": "string",
              "enum": [
                "personal",
                "coop",
                "ltd",
                "share",
                "other"
              ],
              "enumTitles": [
                "Personal (Osobní)",
                "Cooperative (Družstevní)",
                "Company (S.r.o.)",
                "Share (Podílové)",
                "Other (Jiné)"
              ]
            }
          },
          "furnished": {
            "title": "Furnished",
            "type": "array",
            "description": "Website filter (flats, houses, commercial).",
            "items": {
              "type": "string",
              "enum": [
                "yes",
                "partly",
                "no"
              ],
              "enumTitles": [
                "Furnished",
                "Partly furnished",
                "Unfurnished"
              ]
            }
          },
          "houseKinds": {
            "title": "House kind",
            "type": "array",
            "description": "Website filter (houses).",
            "items": {
              "type": "string",
              "enum": [
                "detached",
                "row"
              ],
              "enumTitles": [
                "Detached (Samostatný)",
                "Terraced (Řadový)"
              ]
            }
          },
          "roomCounts": {
            "title": "Rooms (houses)",
            "type": "array",
            "description": "Website filter (houses): number of rooms.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6"
              ],
              "enumTitles": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6 and more"
              ]
            }
          },
          "features": {
            "title": "Must have",
            "type": "array",
            "description": "Website filter. Balcony, loggia and terrace count as one group (any of the chosen ones), garage and parking too; the other features must all be there.",
            "items": {
              "type": "string",
              "enum": [
                "balcony",
                "loggia",
                "terrace",
                "cellar",
                "garage",
                "parking",
                "elevator",
                "barrierFree",
                "garden",
                "swimmingPool",
                "internet",
                "video",
                "openHouse"
              ],
              "enumTitles": [
                "Balcony",
                "Loggia",
                "Terrace",
                "Cellar",
                "Garage",
                "Parking space",
                "Elevator",
                "Barrier-free",
                "Garden",
                "Swimming pool",
                "Internet",
                "Video",
                "Open house (Den otevřených dveří)"
              ]
            }
          },
          "onlyDiscounted": {
            "title": "Only discounted",
            "type": "boolean",
            "description": "Only listings marked as discounted (Zlevněno). A website filter for the searches of this input, a filter for URLs.",
            "default": false
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "any",
              "agency",
              "private"
            ],
            "type": "string",
            "description": "Agencies only or private sellers only (with details, a listing without an agency or broker counts as private).",
            "default": "any"
          },
          "minPricePerSqm": {
            "title": "Min price per m² (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings with at least this price per m²."
          },
          "maxPricePerSqm": {
            "title": "Max price per m² (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings with at most this price per m² (finds bargains)."
          },
          "onlyWithPrice": {
            "title": "Only with a price",
            "type": "boolean",
            "description": "Skip listings with the price on request.",
            "default": false
          },
          "excludeReserved": {
            "title": "Exclude reserved",
            "type": "boolean",
            "description": "Skip listings marked as reserved (Rezervováno).",
            "default": false
          },
          "onlyWithGps": {
            "title": "Only with GPS",
            "type": "boolean",
            "description": "Skip listings without coordinates (needs \"Add listing details\").",
            "default": false
          },
          "onlyWithImages": {
            "title": "Only with photos",
            "type": "boolean",
            "description": "Skip listings without photos.",
            "default": false
          },
          "listedWithinDays": {
            "title": "Created in the last … days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only listings created on the website in this many days (listedAt, known without details). Any number of days, unlike the website filter above."
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Only listings whose title (or description, with details) contains any of these words, e.g. \"sauna\", \"výhled\", \"garáž\".",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Skip listings whose title (or description, with details) contains any of these words, e.g. \"podíl\", \"rezervováno\".",
            "items": {
              "type": "string"
            }
          },
          "agencyNames": {
            "title": "Only these agencies",
            "type": "array",
            "description": "Agency names or parts of them (agencyName in the results), e.g. \"REMAX\", \"Century 21\" (spaces and punctuation are ignored).",
            "items": {
              "type": "string"
            }
          },
          "excludeAgencyNames": {
            "title": "Exclude agencies",
            "type": "array",
            "description": "Agency names or parts of them (agencyName in the results).",
            "items": {
              "type": "string"
            }
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed listings",
            "type": "boolean",
            "description": "Return only listings that are new or whose price or title changed since the previous run with the same monitoring key. Unchanged listings are not saved or charged; every search page read in this mode is $0.0001 (the monitoring-page event). Schedule the actor to get a watchdog.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for each watched search. Empty = \"default\". The value is stored encrypted."
          },
          "onlyPriceChanges": {
            "title": "Monitoring: only price changes",
            "type": "boolean",
            "description": "Of the changed listings, only those whose price changed (new listings are still returned).",
            "default": false
          },
          "minPriceDropPercent": {
            "title": "Monitoring: min price drop (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Only listings whose price dropped at least this much since the previous run."
          },
          "includeRemovedListings": {
            "title": "Monitoring: include removed listings",
            "type": "boolean",
            "description": "Also return listings that left the search since the previous run, each checked on reality.idnes.cz: removedReason \"deleted\" (no longer active on the website) or \"noLongerMatches\" (still active, but no longer in your search; confirmed by the next run before it is reported, so there are no false alarms). Listings that come back are marked \"reappeared\".",
            "default": false
          },
          "fastMode": {
            "title": "Fast mode (small extra charge)",
            "type": "boolean",
            "description": "Faster listing details for a small extra charge per listing, but on this website the gain is usually small; the normal speed suits most runs. Drops back to the normal speed for the rest of the run at the first sign of load; it never changes IP address to get around a limit.",
            "default": false
          },
          "maxRequestsPerMinute": {
            "title": "Max requests per minute (normal speed)",
            "minimum": 1,
            "maximum": 120,
            "type": "integer",
            "description": "Upper limit of the normal speed. The default suits almost every run.",
            "default": 90
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy needed. Turn on Apify Proxy only if the website starts rejecting requests.",
            "default": {
              "useApifyProxy": false
            }
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}