{
  "openapi": "3.0.1",
  "info": {
    "title": "Singapore URA Private Property Transactions & Rentals Scraper",
    "description": "Scrape official Singapore URA private residential sale transactions (price, area, $psf, floor, district, tenure, sale type, contract date) and rental contracts (rent, bedrooms, lease month). Filter by project, district, type, price and date. Export to JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "0PTgoi0LiBIxzSKxI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapers_lat~singapore-ura-property-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapers_lat-singapore-ura-property-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/scrapers_lat~singapore-ura-property-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapers_lat-singapore-ura-property-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/scrapers_lat~singapore-ura-property-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapers_lat-singapore-ura-property-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": {
          "dataType": {
            "title": "Dataset",
            "enum": [
              "transactions",
              "rentals"
            ],
            "type": "string",
            "description": "Which URA private residential dataset to pull: unit-level sale transactions (last 5 years) or rental contracts (by quarter).",
            "default": "transactions"
          },
          "uraAccessKey": {
            "title": "URA Access Key",
            "type": "string",
            "description": "Your free URA Data Service AccessKey. Register at ura.gov.sg (Digital Services > URA Data Service); URA emails you an AccessKey once approved. The actor exchanges it for a daily token automatically. Required."
          },
          "maxRecords": {
            "title": "Max Property Records To Scrape",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of transaction or rental records to return across the run."
          },
          "batches": {
            "title": "Transaction batches (1-4)",
            "type": "array",
            "description": "Sale transactions only. URA splits its 5-year transaction dataset into 4 batches. Leave empty to pull all four; or list specific batches like 1, 2.",
            "items": {
              "type": "string"
            }
          },
          "refPeriods": {
            "title": "Rental quarters (yyqq)",
            "type": "array",
            "description": "Rental contracts only. Quarters to pull in yyqq format, for example 24q2, 24q1. Leave empty to pull the most recent quarters automatically.",
            "items": {
              "type": "string"
            }
          },
          "quartersBack": {
            "title": "Number of recent rental quarters",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Rental contracts only. When no specific quarters are listed, how many recent quarters to pull."
          },
          "projectNames": {
            "title": "Project names",
            "type": "array",
            "description": "Keep only records whose project name contains any of these (case-insensitive partial match), for example 'The Sail', 'Reflections'.",
            "items": {
              "type": "string"
            }
          },
          "streetKeyword": {
            "title": "Street keyword",
            "type": "string",
            "description": "Keep only records whose street contains this text, for example 'Orchard'."
          },
          "districts": {
            "title": "Postal districts",
            "type": "array",
            "description": "Filter by URA postal district, for example 09, 10, 15 (or D09). Leave empty for all districts.",
            "items": {
              "type": "string"
            }
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Filter by property type, for example Condominium, Apartment, Terrace, Detached, Semi-detached, Executive Condominium (sales); or Non-landed Properties, Landed Properties (rentals). Partial match.",
            "items": {
              "type": "string"
            }
          },
          "marketSegments": {
            "title": "Market segments",
            "type": "array",
            "description": "Sale transactions only. Filter by market segment: CCR (Core Central Region), RCR (Rest of Central Region), OCR (Outside Central Region).",
            "items": {
              "type": "string"
            }
          },
          "saleTypes": {
            "title": "Sale types",
            "type": "array",
            "description": "Sale transactions only. Filter by sale type: newSale, subSale or resale.",
            "items": {
              "type": "string"
            }
          },
          "tenure": {
            "title": "Tenure",
            "enum": [
              "any",
              "freehold",
              "leasehold"
            ],
            "type": "string",
            "description": "Sale transactions only. Filter by tenure.",
            "default": "any"
          },
          "minPrice": {
            "title": "Min transaction price (SGD)",
            "minimum": 0,
            "type": "integer",
            "description": "Sale transactions only. Keep only transactions at or above this total price."
          },
          "maxPrice": {
            "title": "Max transaction price (SGD)",
            "minimum": 0,
            "type": "integer",
            "description": "Sale transactions only. Keep only transactions at or below this total price."
          },
          "minRent": {
            "title": "Min monthly rent (SGD)",
            "minimum": 0,
            "type": "integer",
            "description": "Rental contracts only. Keep only contracts at or above this monthly rent."
          },
          "maxRent": {
            "title": "Max monthly rent (SGD)",
            "minimum": 0,
            "type": "integer",
            "description": "Rental contracts only. Keep only contracts at or below this monthly rent."
          },
          "minAreaSqft": {
            "title": "Min area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only records with floor area at or above this many square feet."
          },
          "maxAreaSqft": {
            "title": "Max area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only records with floor area at or below this many square feet."
          },
          "bedrooms": {
            "title": "Bedrooms",
            "type": "array",
            "description": "Rental contracts only. Filter by number of bedrooms, for example 1, 2, 3.",
            "items": {
              "type": "string"
            }
          },
          "fromMonth": {
            "title": "From month (YYYY-MM)",
            "type": "string",
            "description": "Keep only records whose contract/lease month is at or after this month, for example 2024-01."
          },
          "toMonth": {
            "title": "To month (YYYY-MM)",
            "type": "string",
            "description": "Keep only records whose contract/lease month is at or before this month, for example 2024-12."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}