{
  "openapi": "3.0.1",
  "info": {
    "title": "PropertyGuru MY $1💰 Search By URLs and Keywords",
    "description": "From $1/1K. Fast, reliable scraper for propertyguru.com.my. Extract sale and rent listings with 30+ structured fields including price (MYR), built-up area, tenure, nearby transit, agent details, and GPS coordinates.",
    "version": "0.5",
    "x-build-id": "QVM4SgQhslg8GSfyE"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~propertyguru-my-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-propertyguru-my-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/abotapi~propertyguru-my-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-propertyguru-my-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/abotapi~propertyguru-my-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-propertyguru-my-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": {
          "mode": {
            "title": "1. Search mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search mode = build URLs from state/search/filters below. URL mode = paste any propertyguru.com.my search URL already refined in a browser (recommended for complex filters).",
            "default": "search"
          },
          "urls": {
            "title": "Search URLs (URL mode)",
            "type": "array",
            "description": "URLs to scrape. Provide propertyguru.com.my search or listing URLs. Tip: open propertyguru.com.my in your browser, apply filters, then paste the resulting URL here. In URL mode, all the filter fields below are ignored.",
            "items": {
              "type": "string"
            }
          },
          "listing_type": {
            "title": "Listing Type (Search mode)",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Type of listing to search for. Search mode only.",
            "default": "sale"
          },
          "property_type": {
            "title": "Property Type",
            "enum": [
              "condo",
              "landed",
              "commercial",
              "land"
            ],
            "type": "string",
            "description": "Filter by property type. 'condo' covers condominiums and apartments; 'landed' narrows to terrace houses (the most common landed sub-type; for bungalow/semi-D/cluster use a free-text location instead); 'commercial' covers shop/office/factory; 'land' covers residential land plots."
          },
          "state": {
            "title": "State / Federal Territory",
            "enum": [
              "kuala-lumpur",
              "selangor",
              "penang",
              "johor",
              "perak",
              "kedah",
              "pahang",
              "negeri-sembilan",
              "terengganu",
              "kelantan",
              "perlis",
              "melaka",
              "sabah",
              "sarawak",
              "putrajaya",
              "labuan"
            ],
            "type": "string",
            "description": "Malaysian state or federal territory. Pick this OR the free-text location, not both. Use 'Kuala Lumpur' for KL, 'Selangor' for the surrounding state."
          },
          "search": {
            "title": "Free-text Location",
            "type": "string",
            "description": "Free-text location search (e.g. 'Mont Kiara', 'Bangsar', 'Cyberjaya', 'Bukit Bintang', 'Iskandar Puteri'). Use this OR the state dropdown, not both."
          },
          "min_price": {
            "title": "Min Price (MYR)",
            "type": "integer",
            "description": "Minimum price in Malaysian Ringgit"
          },
          "max_price": {
            "title": "Max Price (MYR)",
            "type": "integer",
            "description": "Maximum price in Malaysian Ringgit"
          },
          "bedrooms": {
            "title": "Bedrooms",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Number of bedrooms (0=Studio)"
          },
          "sort": {
            "title": "Sort By",
            "enum": [
              "date",
              "price",
              "psf"
            ],
            "type": "string",
            "description": "Sort results by date (newest), price, or price per sqft",
            "default": "date"
          },
          "sort_order": {
            "title": "Sort Order",
            "enum": [
              "asc",
              "desc"
            ],
            "type": "string",
            "description": "Sort direction",
            "default": "desc"
          },
          "enable_detail_pages": {
            "title": "Fetch Detail Pages",
            "type": "boolean",
            "description": "Fetch each listing's detail page for richer attributes: latitude/longitude, full description, project name, total units, facilities, floor plans, and nearby schools. Recommended. Applies regardless of search mode (Search or URL).",
            "default": true
          },
          "max_properties": {
            "title": "Max Properties",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of properties to scrape (0=unlimited)",
            "default": 10
          },
          "max_pages": {
            "title": "Max Pages",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of search result pages to scrape (20 listings per page)",
            "default": 20
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Residential in Malaysia is required - PropertyGuru is geo-restricted to MY IPs. IP rotation is handled automatically. Free-tier accounts automatically use a more conservative path that disables detail-page enrichment for reliability; paid plans get the full feature set.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "MY"
            }
          },
          "detail_concurrency": {
            "title": "Detail Page Concurrency",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Number of parallel detail-page fetches. Higher values are faster but may trigger rate limiting; 1-3 is recommended.",
            "default": 1
          },
          "session_ttl_seconds": {
            "title": "Session TTL (seconds)",
            "minimum": 120,
            "maximum": 1800,
            "type": "integer",
            "description": "How often the scraper refreshes its connection state. Lower values are more conservative but slightly slower; higher values run faster at slight risk of a mid-run block. The default of 10 minutes comfortably covers typical runs.",
            "default": 600
          },
          "reuse_project_cache": {
            "title": "Reuse Project Cache",
            "type": "boolean",
            "description": "When enabled, the scraper caches project-level fields (project_name, total_units, facilities, nearby_schools, coordinates, developer, tenure) from the first listing in each condo project, and reuses them on subsequent listings in the same project - skipping the detail-page fetch entirely. Dramatically reduces cost on condo-heavy runs at the expense of per-listing fields (description, floor plans, unit number). Disable to fetch every listing's detail page.",
            "default": true
          },
          "dataset_name": {
            "title": "Dataset Name",
            "type": "string",
            "description": "Custom dataset name (leave empty for default)"
          },
          "clear_dataset": {
            "title": "Clear Dataset",
            "type": "boolean",
            "description": "Clear the dataset before scraping",
            "default": 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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}