{
  "openapi": "3.0.1",
  "info": {
    "title": "Bezrealitky.cz Scraper",
    "description": "[💰 $0.045 / 1K] Scrape direct-owner (no-agency) property listings from Bezrealitky.cz — prices, area, layout, location, GPS, photos, and seller details. Filter by sale/rent, type, layout, price, and area, or paste search URLs.",
    "version": "1.0",
    "x-build-id": "hFphZlFctsdeV3PJ9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~bezrealitky-ck-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-bezrealitky-ck-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/solidcode~bezrealitky-ck-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-bezrealitky-ck-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/solidcode~bezrealitky-ck-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-bezrealitky-ck-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": "Search URLs",
            "type": "array",
            "description": "Paste one or more Bezrealitky search or listing URLs (e.g. https://www.bezrealitky.cz/vyhledat/prodej-byt). Any filters already in the URL — type, price, layout, location — are applied automatically. When you provide URLs, the search filters below are ignored.",
            "items": {
              "type": "string"
            }
          },
          "transactionType": {
            "title": "Sale or Rent",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Whether to find properties for sale or for rent. Only applies when no Search URLs are provided above.",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property Type",
            "enum": [
              "flat",
              "house",
              "land",
              "commercial",
              "garage",
              "cottage"
            ],
            "type": "string",
            "description": "The kind of property to find. Only applies when no Search URLs are provided.",
            "default": "flat"
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, district, or region to search in (e.g. 'Praha', 'Brno', 'Jihomoravský kraj'). Leave empty to search the whole Czech Republic. Only applies when no Search URLs are provided."
          },
          "dispositions": {
            "title": "Layout (disposition)",
            "uniqueItems": true,
            "type": "array",
            "description": "Czech apartment layouts to include (e.g. 2+kk means two rooms plus a kitchenette). Select one or more, or leave empty for all. Mostly relevant for flats and houses.",
            "items": {
              "type": "string",
              "enum": [
                "1+kk",
                "1+1",
                "2+kk",
                "2+1",
                "3+kk",
                "3+1",
                "4+kk",
                "4+1",
                "5+kk",
                "5+1",
                "6_plus",
                "atypical",
                "room",
                "other"
              ],
              "enumTitles": [
                "1+kk",
                "1+1",
                "2+kk",
                "2+1",
                "3+kk",
                "3+1",
                "4+kk",
                "4+1",
                "5+kk",
                "5+1",
                "6 and more",
                "Atypical",
                "Single room",
                "Other"
              ]
            },
            "default": []
          },
          "priceFrom": {
            "title": "Minimum Price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price to include, in CZK. For rentals this is the monthly rent. Leave empty for no minimum."
          },
          "priceTo": {
            "title": "Maximum Price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price to include, in CZK. For rentals this is the monthly rent. Leave empty for no maximum."
          },
          "areaFrom": {
            "title": "Minimum Area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Smallest floor area to include, in square metres. Leave empty for no minimum."
          },
          "areaTo": {
            "title": "Maximum Area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Largest floor area to include, in square metres. Leave empty for no maximum."
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings to return across all URLs and searches. Set to 0 for no limit. Tip: start with 20–50 to test, then increase.",
            "default": 100
          },
          "includeDetails": {
            "title": "Include Full Listing Details",
            "type": "boolean",
            "description": "Open each listing's detail page for the full description, all photos, energy rating, and seller contact where available. Slower but much richer. When off, only the data visible in search results is returned.",
            "default": true
          },
          "language": {
            "title": "Language",
            "enum": [
              "cs",
              "en",
              "sk"
            ],
            "type": "string",
            "description": "Language for listing text and labels. Bezrealitky offers Czech, English, and Slovak.",
            "default": "cs"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}