{
  "openapi": "3.0.1",
  "info": {
    "title": "Landwatch.com Scraper | Enterprise Grade",
    "description": "Extract 400k+ US property listings from LandWatch with pricing, property details, broker contacts, full media, listing history and more. Built for enterprise-grade land intelligence, investment screening, lead enrichment, and automated real estate data pipelines.",
    "version": "0.0",
    "x-build-id": "IMMQBoDsM21RqEJtn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fatihtahta~landwatch-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fatihtahta-landwatch-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~landwatch-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fatihtahta-landwatch-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~landwatch-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fatihtahta-landwatch-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": {
          "deal_type": {
            "title": "Choose Deal Type",
            "enum": [
              "for_sale",
              "auction"
            ],
            "type": "string",
            "description": "Select the listing deal type to include in the core scope. Leave empty when you do not want to limit results to a specific deal type."
          },
          "availability": {
            "title": "Choose Availability Statuses",
            "type": "array",
            "description": "Select one or more listing statuses for the core scope. The default captures properties for sale and properties under contract.",
            "items": {
              "type": "string",
              "enum": [
                "buy",
                "under_contract",
                "off_market",
                "sold"
              ],
              "enumTitles": [
                "For Sale | available listings",
                "Under Contract | pending listings",
                "Off Market | inactive listings",
                "Sold | closed listings"
              ]
            },
            "default": [
              "buy",
              "under_contract"
            ]
          },
          "location": {
            "title": "Enter Location",
            "type": "string",
            "description": "Enter a free-text location such as California, Los Angeles County CA, or Ramona CA. Leave empty to collect listings without a location filter."
          },
          "property_type": {
            "title": "Choose Property Type",
            "enum": [
              "commercial",
              "farms_and_ranches",
              "homesite",
              "horse",
              "house",
              "hunting",
              "lakefront",
              "oceanfront",
              "recreational",
              "riverfront",
              "timberland",
              "undeveloped",
              "waterfront"
            ],
            "type": "string",
            "description": "Select a property category when your workflow needs a focused segment such as farms and ranches, waterfront land, hunting land, or undeveloped parcels."
          },
          "price_reduction_period": {
            "title": "Filter by Recent Price Reduction",
            "enum": [
              "3_days",
              "7_days",
              "30_days",
              "60_days",
              "90_days"
            ],
            "type": "string",
            "description": "Only include listings with a price reduction during the selected period. Leave empty to include listings whether or not the price was recently reduced."
          },
          "publication_date": {
            "title": "Filter by Publication Date",
            "enum": [
              "1_day",
              "7_days",
              "30_days",
              "60_days"
            ],
            "type": "string",
            "description": "Only include listings first published during the selected period. Leave empty when listing age should not narrow the dataset."
          },
          "keyword": {
            "title": "Search by Keyword",
            "type": "string",
            "description": "Enter a keyword or phrase to focus the search on listings that match that text. Leave empty for broader discovery."
          },
          "owner_financing": {
            "title": "Require Owner Financing",
            "type": "boolean",
            "description": "Include only listings that offer owner financing.",
            "default": false
          },
          "mineral_rights": {
            "title": "Require Mineral Rights",
            "type": "boolean",
            "description": "Include only listings that mention mineral rights.",
            "default": false
          },
          "virtual_tour": {
            "title": "Require Virtual Tour",
            "type": "boolean",
            "description": "Include only listings that provide a virtual tour.",
            "default": false
          },
          "exterior_tour": {
            "title": "Require Exterior Tour",
            "type": "boolean",
            "description": "Include only listings that provide an exterior tour.",
            "default": false
          },
          "property_video": {
            "title": "Require Property Video",
            "type": "boolean",
            "description": "Include only listings that provide a property video.",
            "default": false
          },
          "custom_map": {
            "title": "Require Custom Map",
            "type": "boolean",
            "description": "Include only listings that provide a custom map.",
            "default": false
          },
          "min_price": {
            "title": "Set Minimum Price",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings priced at or above this amount. Leave empty when there is no minimum price requirement."
          },
          "max_price": {
            "title": "Set Maximum Price",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings priced at or below this amount. Leave empty when there is no maximum price requirement."
          },
          "min_area_parcel": {
            "title": "Set Minimum Parcel Size",
            "minimum": 0,
            "type": "number",
            "description": "Only include listings with parcel area at or above this number of acres. Leave empty when smaller parcels are acceptable."
          },
          "max_area_parcel": {
            "title": "Set Maximum Parcel Size",
            "minimum": 0,
            "type": "number",
            "description": "Only include listings with parcel area at or below this number of acres. Leave empty when larger parcels are acceptable."
          },
          "min_area_building": {
            "title": "Set Minimum Building Size",
            "minimum": 0,
            "type": "number",
            "description": "Only include listings with building area at or above this square footage. Leave empty when there is no minimum building-size requirement."
          },
          "max_area_building": {
            "title": "Set Maximum Building Size",
            "minimum": 0,
            "type": "number",
            "description": "Only include listings with building area at or below this square footage. Leave empty when there is no maximum building-size requirement."
          },
          "min_bedroom": {
            "title": "Set Minimum Bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with at least this many bedrooms. Leave empty when bedroom count should not limit results."
          },
          "max_bedroom": {
            "title": "Set Maximum Bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with no more than this many bedrooms. Leave empty when there is no upper bedroom limit."
          },
          "min_bathroom": {
            "title": "Set Minimum Bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with at least this many bathrooms. Leave empty when bathroom count should not limit results."
          },
          "max_bathroom": {
            "title": "Set Maximum Bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with no more than this many bathrooms. Leave empty when there is no upper bathroom limit."
          },
          "sort_by": {
            "title": "Choose Sort Order",
            "enum": [
              "default",
              "acres_small_to_large",
              "acres_large_to_small",
              "newest",
              "price_low_to_high",
              "price_high_to_low",
              "price_per_acre_low_to_high",
              "price_per_acre_high_to_low",
              "recently_changed"
            ],
            "type": "string",
            "description": "Select the order used for matching listings. The default keeps LandWatch's standard ordering.",
            "default": "default"
          },
          "limit": {
            "title": "Set Maximum Results per Location",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of listings to save for each location. Leave empty to collect all available listings that match your configuration."
          },
          "maximize_coverage": {
            "title": "Maximize Matching Listings",
            "type": "boolean",
            "description": "Keep enabled to collect a broader set of listings that match your filters. Turn off for faster exploratory runs where a smaller visible result set is enough.",
            "default": true
          },
          "enrich_data": {
            "title": "Collect Richer Listing Details",
            "type": "boolean",
            "description": "Enable this for more complete listings. These extra details are useful for analysis, lead qualification, comparable review, and downstream CRM workflows. This may make the run slower because the actor may spend more time collecting details for each result. Turn it off for faster runs when the standard result fields are enough.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}