{
  "openapi": "3.0.1",
  "info": {
    "title": "Poland Real Estate Transaction Prices (RCN Register)",
    "description": "Real sale prices of flats, houses, buildings and land in Poland from the official price register (RCN): price, deed date, area, price per m², primary/secondary market, address, district and GPS. Any city, county, district or map area. Monitor mode for new deals.",
    "version": "1.0",
    "x-build-id": "SzZ1zq8ahc25YEL6z"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/trev0n~rcn-poland-transaction-prices-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-trev0n-rcn-poland-transaction-prices-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/trev0n~rcn-poland-transaction-prices-scraper/runs": {
      "post": {
        "operationId": "runs-sync-trev0n-rcn-poland-transaction-prices-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/trev0n~rcn-poland-transaction-prices-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-trev0n-rcn-poland-transaction-prices-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": {
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Cities, counties (powiaty), municipalities, Warsaw/Kraków districts or voivodeships — one per line, e.g. <code>Warszawa</code>, <code>Mokotów</code>, <code>Piaseczno</code>, <code>powiat krakowski</code>, <code>mazowieckie</code>. TERYT codes work too (<code>1465</code>, <code>146505_8</code>). Add <code>, voivodeship</code> to tell apart places with the same name (<code>Dąbrowa, opolskie</code>). Leave empty (with no map area) to search all of Poland.",
            "items": {
              "type": "string"
            }
          },
          "latitude": {
            "title": "Centre latitude",
            "type": "string",
            "description": "Search around a point instead of (or within) the locations: latitude in degrees, e.g. <code>52.2297</code>. Use with longitude and radius."
          },
          "longitude": {
            "title": "Centre longitude",
            "type": "string",
            "description": "Longitude of the centre point in degrees, e.g. <code>21.0122</code>."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0.05,
            "maximum": 50,
            "type": "number",
            "description": "Distance from the centre point, up to 50 km. Default 1 km."
          },
          "boundingBox": {
            "title": "Map area (bounding box)",
            "type": "string",
            "description": "A rectangle as <code>south,west,north,east</code> in degrees, e.g. <code>52.15,20.90,52.30,21.10</code>. Combines with locations and the radius."
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "units",
              "buildings",
              "land"
            ],
            "type": "string",
            "description": "<b>Units</b> = flats, garages, offices and shops sold as separate units. <b>Buildings</b> = houses and other buildings sold with their land. <b>Land</b> = parcels (building plots, farmland, forest).",
            "default": "units"
          },
          "unitFunctions": {
            "title": "Unit use (units only)",
            "type": "array",
            "description": "Only these kinds of unit. Empty = all. Pick <b>Residential</b> to leave out garages and parking spaces.",
            "items": {
              "type": "string",
              "enum": [
                "residential",
                "garage",
                "retailServices",
                "office",
                "other"
              ],
              "enumTitles": [
                "Residential (flats)",
                "Garage / parking",
                "Retail & services",
                "Office",
                "Other"
              ]
            }
          },
          "buildingTypes": {
            "title": "Building type (buildings only)",
            "type": "array",
            "description": "Only these kinds of building. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "residential",
                "farmOutbuilding",
                "retailServices",
                "office",
                "industrial",
                "transportCommunication",
                "storageWarehouse",
                "educationSport",
                "healthcare",
                "otherNonResidential"
              ],
              "enumTitles": [
                "Residential",
                "Farm / outbuilding",
                "Retail & services",
                "Office",
                "Industrial",
                "Transport & communication (e.g. garages)",
                "Storage / warehouse",
                "Education & sport",
                "Healthcare",
                "Other non-residential"
              ]
            }
          },
          "landUses": {
            "title": "Land use (land only)",
            "type": "array",
            "description": "Only parcels with this land-register use. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "builtUpUrbanised",
                "agricultural",
                "forest",
                "transport",
                "other"
              ],
              "enumTitles": [
                "Built-up & urbanised",
                "Agricultural",
                "Forest",
                "Transport (roads)",
                "Other"
              ]
            }
          },
          "includeApartmentSaleRows": {
            "title": "Include land/building rows of flat sales",
            "type": "boolean",
            "description": "When a flat is sold, the register also lists the building and the land plot under it (with the flat's price). They are left out of Buildings and Land by default so you see only real house and land deals. Turn on to include them.",
            "default": false
          },
          "market": {
            "title": "Market",
            "enum": [
              "any",
              "primary",
              "secondary"
            ],
            "type": "string",
            "description": "Primary (from a developer) or secondary (resale).",
            "default": "any"
          },
          "transactionTypes": {
            "title": "Transaction type",
            "type": "array",
            "description": "Kind of sale. Default: free-market sales only — discounted council-flat sales (up to 90% off) would distort prices. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "freeMarket",
                "tender",
                "nonTender",
                "discountedSale",
                "enforcementSale",
                "publicPurpose"
              ],
              "enumTitles": [
                "Free market",
                "Public tender",
                "Without tender",
                "Discounted sale (bonifikata)",
                "Bailiff / enforcement sale",
                "Public-purpose sale"
              ]
            },
            "default": [
              "freeMarket"
            ]
          },
          "sellerTypes": {
            "title": "Seller",
            "type": "array",
            "description": "Who sold. Empty = anyone. Developers are companies.",
            "items": {
              "type": "string",
              "enum": [
                "individual",
                "company",
                "localGovernment",
                "stateTreasury"
              ],
              "enumTitles": [
                "Individual",
                "Company",
                "Local government",
                "State Treasury"
              ]
            }
          },
          "buyerTypes": {
            "title": "Buyer",
            "type": "array",
            "description": "Who bought. Empty = anyone.",
            "items": {
              "type": "string",
              "enum": [
                "individual",
                "company",
                "localGovernment",
                "stateTreasury"
              ],
              "enumTitles": [
                "Individual",
                "Company",
                "Local government",
                "State Treasury"
              ]
            }
          },
          "dateFrom": {
            "title": "Deed date from",
            "type": "string",
            "description": "Sales signed on or after this date: <code>2025-01-01</code>, <code>01.01.2025</code> or a window such as <code>6 months</code>, <code>90 days</code>, <code>1 year</code>."
          },
          "dateTo": {
            "title": "Deed date to",
            "type": "string",
            "description": "Sales signed on or before this date (same formats). Empty = up to today."
          },
          "minPrice": {
            "title": "Min price (PLN)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest gross transaction price in złoty."
          },
          "maxPrice": {
            "title": "Max price (PLN)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest gross transaction price in złoty."
          },
          "minArea": {
            "title": "Min area (m²)",
            "minimum": 0,
            "type": "number",
            "description": "Smallest usable area (units, buildings) or parcel area (land) in m²."
          },
          "maxArea": {
            "title": "Max area (m²)",
            "minimum": 0,
            "type": "number",
            "description": "Largest usable area (units, buildings) or parcel area (land) in m²."
          },
          "minPricePerSqm": {
            "title": "Min price per m²",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price per m² in złoty — handy for dropping symbolic and family deals."
          },
          "maxPricePerSqm": {
            "title": "Max price per m²",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price per m² in złoty."
          },
          "onlyWithAddress": {
            "title": "Only records with an address",
            "type": "boolean",
            "description": "Skip records whose county did not publish the street address.",
            "default": false
          },
          "transactionIds": {
            "title": "Transaction IDs",
            "type": "array",
            "description": "Look up specific transactions by their register ID (the <code>transactionId</code> field, a UUID). Other filters still apply.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "newest",
              "oldest",
              "register"
            ],
            "type": "string",
            "description": "<b>Newest</b> deeds first (default), oldest first, or register order.",
            "default": "newest"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many records in total. 0 = no limit (a whole city over several years can be hundreds of thousands).",
            "default": 100
          },
          "maxResultsPerLocation": {
            "title": "Max results per location",
            "minimum": 0,
            "type": "integer",
            "description": "Cap per county / area, so one big city does not use up the whole limit. 0 = no cap.",
            "default": 0
          },
          "includeGeometry": {
            "title": "Include parcel / building outline",
            "type": "boolean",
            "description": "Add the exact shape (GeoJSON, WGS84). Every record always has its centre latitude & longitude.",
            "default": false
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Only the key fields: date, market, price, price per m², area, rooms, floor, address, district, coordinates.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Drop empty fields",
            "type": "boolean",
            "description": "Leave out fields with no value.",
            "default": false
          },
          "incrementalMode": {
            "title": "Monitor mode (only new or changed deals)",
            "type": "boolean",
            "description": "Remember what earlier runs found and output only transactions that are new or corrected since then. Counties add deeds weeks after signing, so use a rolling window such as <code>6 months</code> in Deed date from and schedule it weekly.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name of the monitor memory. Leave empty to derive it from the search; set it to keep one memory while you tweak filters."
          },
          "emitUnchanged": {
            "title": "Also output unchanged deals",
            "type": "boolean",
            "description": "In monitor mode, output every transaction, tagged NEW / UPDATED / UNCHANGED.",
            "default": false
          },
          "emitExpired": {
            "title": "Also output deals that dropped out",
            "type": "boolean",
            "description": "In monitor mode, output transactions found before but not in this run (e.g. they left the rolling date window).",
            "default": false
          },
          "notifyOnlyChanges": {
            "title": "Alert only when something changed",
            "type": "boolean",
            "description": "Skip the alert when the run found nothing new.",
            "default": true
          },
          "notificationLimit": {
            "title": "Deals per alert",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many transactions one alert lists.",
            "default": 10
          },
          "includeRunSummary": {
            "title": "Add run summary to webhook",
            "type": "boolean",
            "description": "Include the counts in the webhook payload.",
            "default": true
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST the new and changed transactions to this URL as JSON."
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Bot token from @BotFather."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Chat or channel to post to."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Post alerts to a Discord channel."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Post alerts to a Slack channel."
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many pages are downloaded side by side.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed — the register is an open public service. Only turn it on if your runs get refused.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}