{
  "openapi": "3.0.1",
  "info": {
    "title": "Lamudi Philippines Scraper with Contacts & Features",
    "description": "Collect structured public property listing records from Lamudi Philippines. Start from locations, search pages, or direct listing URLs when supported, then save CleanedWeb records to the default dataset for market research, monitoring, CRM, BI, ETL, and property workflows.",
    "version": "0.1",
    "x-build-id": "ShDl3XQ7K0zHicbcf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fatihtahta~lamudi-ph-property-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fatihtahta-lamudi-ph-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/fatihtahta~lamudi-ph-property-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fatihtahta-lamudi-ph-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/fatihtahta~lamudi-ph-property-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fatihtahta-lamudi-ph-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": {
          "location": {
            "title": "Set a Lamudi Location or Market",
            "type": "string",
            "description": "Enter a city, province, neighborhood, or market supported by Lamudi Philippines, such as Metro Manila, Quezon City, Cebu, or Pampanga. Use one focused market per run when you want cleaner price comparisons, recurring monitoring, or downstream deduplication."
          },
          "deal_type": {
            "title": "Choose Sale or Rental Listings",
            "enum": [
              "buy",
              "rent"
            ],
            "type": "string",
            "description": "Select whether the structured search should collect Lamudi properties listed for sale or for rent. Pair this with location and optional filters when you need comparable market slices for monitoring, CRM enrichment, reporting, or ETL ingestion.",
            "default": "buy"
          },
          "property_type": {
            "title": "Filter by Property Category or Type",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose one or more broad Lamudi property groups or specific property types. Leave empty to include all property types that match the selected location and listing mode.",
            "items": {
              "type": "string",
              "enum": [
                "gt-apartment",
                "room",
                "gt-commercial",
                "building",
                "offices",
                "retail",
                "service-office",
                "warehouse",
                "gt-condo",
                "condotel",
                "loft",
                "penthouse",
                "studio",
                "gt-house",
                "beach-house",
                "single-family-house",
                "townhouse",
                "villas",
                "gt-land",
                "agricutural-lot",
                "beach-lot",
                "commercial-lot",
                "residential-lot"
              ],
              "enumTitles": [
                "Apartment",
                "Room",
                "Commercial Space",
                "Building",
                "Offices",
                "Retail",
                "Serviced Office",
                "Warehouse",
                "Condo",
                "Condotel",
                "Loft",
                "Penthouse",
                "Studio",
                "House and Lot",
                "Beach House",
                "House",
                "Townhouse",
                "Villas",
                "Lot",
                "Agricultural Lot",
                "Beach Lot",
                "Commercial Lot",
                "Residential Lot"
              ]
            }
          },
          "sort_by": {
            "title": "Choose the Lamudi Sort Order",
            "enum": [
              "popularity",
              "newest",
              "price-low",
              "price-high"
            ],
            "type": "string",
            "description": "Choose how Lamudi should order matching listings before collection. Use newest for monitoring recent inventory, or price ordering when reviewing market ranges.",
            "default": "popularity"
          },
          "min_price": {
            "title": "Set a Minimum Asking Price or Rent",
            "minimum": 1,
            "type": "integer",
            "description": "Set the lowest listing price to include, in PHP. Use with a maximum price when you need a clean budget band for monitoring, dashboards, CRM imports, or market analysis."
          },
          "max_price": {
            "title": "Set a Maximum Asking Price or Rent",
            "minimum": 1,
            "type": "integer",
            "description": "Set the highest listing price to include, in PHP. Leave empty if you only need a lower bound or want Lamudi to return all matching prices above the minimum."
          },
          "bed_count": {
            "title": "Filter by Bedroom Counts",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more bedroom counts to include. Leave empty when bedroom count should not narrow the property search, such as broad commercial or land monitoring.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5"
              ],
              "enumTitles": [
                "1",
                "2",
                "3",
                "4",
                "5+"
              ]
            }
          },
          "bathroom_count": {
            "title": "Filter by Bathroom Counts",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more bathroom counts to include. This is most useful for residential searches where room configuration is part of the downstream comparison.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5"
              ],
              "enumTitles": [
                "1",
                "2",
                "3",
                "4",
                "5+"
              ]
            }
          },
          "min_floor_area": {
            "title": "Set a Minimum Floor Area",
            "minimum": 1,
            "type": "integer",
            "description": "Set the smallest floor area to include, in square meters. Use area filters for more consistent comparison sets in ETL, reporting, or property-review workflows."
          },
          "max_floor_area": {
            "title": "Set a Maximum Floor Area",
            "minimum": 1,
            "type": "integer",
            "description": "Set the largest floor area to include, in square meters. Pair this with minimum floor area when you need a precise size band."
          },
          "min_land_area": {
            "title": "Set a Minimum Land or Plot Area",
            "minimum": 1,
            "type": "integer",
            "description": "Set the smallest land or plot area to include, in square meters. This is useful for lots, warehouses, commercial properties, and land-focused monitoring."
          },
          "max_land_area": {
            "title": "Set a Maximum Land or Plot Area",
            "minimum": 1,
            "type": "integer",
            "description": "Set the largest land or plot area to include, in square meters. Leave empty when larger lots should remain eligible."
          },
          "foreclosed_property": {
            "title": "Choose How to Handle Foreclosed Properties",
            "enum": [
              "included",
              "excluded",
              "yes"
            ],
            "type": "string",
            "description": "Choose whether foreclosed Lamudi listings should be included with normal listings, excluded from the search, or collected exclusively. Use this when foreclosure status matters for sourcing, risk review, or investment-screening workflows.",
            "default": "included"
          },
          "amenities": {
            "title": "Require Specific Amenities or Property Features",
            "uniqueItems": true,
            "type": "array",
            "description": "Select Lamudi amenities or features that matching listings should include. Leave empty for broader discovery; add amenities when your downstream workflow needs a targeted property profile.",
            "items": {
              "type": "string",
              "enum": [
                "security",
                "guardhouse",
                "cctv",
                "concierge",
                "security-door",
                "alarm",
                "24-hour-security",
                "roof-garden",
                "swimming_pool",
                "gym",
                "sauna",
                "jacuzzi",
                "tennis-court",
                "children-s-area",
                "multiuse-room",
                "deck",
                "balcony",
                "garden",
                "grill",
                "green-area",
                "courtyard",
                "garage",
                "internet",
                "wi-fi",
                "video-cable",
                "air-conditioning",
                "heating",
                "fireplace",
                "natural-gas",
                "intercom",
                "water-tank",
                "water",
                "electricity",
                "built-in-wardrobe",
                "library",
                "panoramic-view",
                "lift",
                "disabled-access",
                "furnished",
                "equipped-kitchen",
                "integral-kitchen",
                "ensuite",
                "cleaning-room",
                "cellar",
                "storage-room",
                "office"
              ],
              "enumTitles": [
                "Security",
                "Guardhouse",
                "CCTV",
                "Concierge",
                "Security door",
                "Alarm",
                "24 hours security",
                "Roof garden",
                "Swimming pool",
                "Gym",
                "Sauna",
                "Jacuzzi",
                "Tennis court",
                "Playground",
                "Multipurpose room",
                "Terrace",
                "Balcony",
                "Garden",
                "Grill",
                "Green area",
                "Yard",
                "Garage",
                "Internet",
                "WiFi",
                "Video cable",
                "Air conditioning",
                "Heating",
                "Fireplace",
                "Natural gas",
                "Intercom",
                "Water tank",
                "Water",
                "Electricity",
                "Built-in wardrobe",
                "Library",
                "Panoramic view",
                "Lift",
                "Access for people with disabilities",
                "Furnished",
                "Equipped kitchen",
                "Integral kitchen",
                "Service room",
                "Laundry room",
                "Cellar",
                "Storage room",
                "Office room"
              ]
            }
          },
          "publication_date": {
            "title": "Filter by Listing Freshness",
            "enum": [
              "1",
              "7",
              "30"
            ],
            "type": "string",
            "description": "Choose a recent publication window when you want newly listed properties for monitoring, alerting, lead review, or recurring inventory refreshes. Leave empty when older matching listings should remain eligible."
          },
          "url": {
            "title": "Add Direct Lamudi URLs",
            "type": "array",
            "description": "Paste one Lamudi search, category, filtered results, listing, or supported source URL per line. Use this when the target scope is already defined in Lamudi or when you want to refresh known property pages directly.",
            "items": {
              "type": "string"
            }
          },
          "enrich_data": {
            "title": "Collect Richer Property Listing Details",
            "type": "boolean",
            "description": "Keep this enabled when CRM enrichment, BI reporting, market review, search indexing, or AI-agent workflows need richer listing records. Turn it off for faster validation runs when the standard search-result fields are enough.",
            "default": true
          },
          "limit": {
            "title": "Set the Maximum Number of Listings to Save",
            "minimum": 1,
            "type": "integer",
            "description": "Choose the maximum number of Lamudi property records to save for this run. Start with a small limit to validate the output shape, then increase it for recurring monitoring, bounded exports, or downstream analysis."
          },
          "mcpConnectors": {
            "title": "MCP Delivery Connectors",
            "uniqueItems": true,
            "type": "array",
            "description": "Choose user-authorized MCP connectors for optional post-run delivery of a concise listing summary with dataset, run-summary, and map links when Apify storage links are available. Leave empty to only save listings to the Apify dataset and key-value store.",
            "default": []
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}