{
  "openapi": "3.0.1",
  "info": {
    "title": "LandWatch Scraper - Land.com, LandAndFarm Listings & Brokers",
    "description": "Scrape land for sale from LandWatch, LandAndFarm and Land.com (Lands of America): price, acres, price per acre, status incl. sold comps, coordinates, property types, photos, broker name and phone; optional full description, features, price history, parcel/MLS ids. Agent rows. No login.",
    "version": "0.1",
    "x-build-id": "hwW3w14I8gArr1hRV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~landwatch-land-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-landwatch-land-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/scrapersdelight~landwatch-land-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-landwatch-land-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/scrapersdelight~landwatch-land-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-landwatch-land-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": "States, counties, cities or ZIP codes, one per line, e.g. \"Texas\", \"Travis County, TX\", \"Bozeman, MT\", \"78880\". \"United States\" searches the whole country. Empty with no URLs = United States.",
            "items": {
              "type": "string"
            }
          },
          "searchUrls": {
            "title": "🔗 Site URLs",
            "type": "array",
            "description": "LandWatch, LandAndFarm, Land.com or Lands of America search URLs (their filters are kept), listing URLs (…/pid/123, /property/…), and LandWatch Find-an-Agent or profile URLs (agent rows). The filters below do not apply to URLs.",
            "items": {
              "type": "string"
            }
          },
          "site": {
            "title": "🌐 Link listings to",
            "enum": [
              "landwatch",
              "landandfarm",
              "landcom"
            ],
            "type": "string",
            "description": "The three sites show the same listings. This picks which site the url field points to for location searches; every row also carries links to all three.",
            "default": "landwatch"
          },
          "propertyTypes": {
            "title": "🏡 Property types",
            "type": "array",
            "description": "Any of the site's property types. Several = listings of any of them.",
            "items": {
              "type": "string",
              "enum": [
                "undeveloped",
                "homesite",
                "house",
                "farms-ranches",
                "recreational",
                "hunting",
                "timberland",
                "horse",
                "waterfront",
                "lakefront",
                "riverfront",
                "oceanfront",
                "commercial"
              ],
              "enumTitles": [
                "Undeveloped land",
                "Homesite",
                "House",
                "Farms and ranches",
                "Recreational",
                "Hunting",
                "Timberland",
                "Horse property",
                "Waterfront",
                "Lakefront",
                "Riverfront",
                "Oceanfront",
                "Commercial"
              ]
            }
          },
          "minPrice": {
            "title": "💲 Min price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest asking price. 0 = no minimum. Listings without a published price (auctions, price on request) drop out of any price filter."
          },
          "maxPrice": {
            "title": "💲 Max price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest asking price. 0 = no maximum."
          },
          "minAcres": {
            "title": "📐 Min acres",
            "minimum": 0,
            "type": "number",
            "description": "Smallest parcel in acres, e.g. 10. 0 = no minimum. Decimal values are checked exactly on each row."
          },
          "maxAcres": {
            "title": "📐 Max acres",
            "minimum": 0,
            "type": "number",
            "description": "Largest parcel in acres. 0 = no maximum."
          },
          "availability": {
            "title": "📌 Availability",
            "type": "array",
            "description": "Listing status. Empty = the site's default (available + under contract). Sold = closed listings with sold price and date where published (comps).",
            "items": {
              "type": "string",
              "enum": [
                "available",
                "under-contract",
                "off-market",
                "sold"
              ],
              "enumTitles": [
                "Available",
                "Under contract",
                "Off market",
                "Sold"
              ]
            }
          },
          "saleType": {
            "title": "🔨 Sale type",
            "enum": [
              "any",
              "for-sale",
              "auction"
            ],
            "type": "string",
            "description": "For sale, auctions, or both.",
            "default": "any"
          },
          "hasResidence": {
            "title": "🏠 Residence",
            "enum": [
              "any",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Parcels with a house on them, bare land only, or either.",
            "default": "any"
          },
          "minSqft": {
            "title": "Min home sq ft",
            "minimum": 0,
            "type": "integer",
            "description": "Smallest home size in square feet. 0 = no minimum."
          },
          "maxSqft": {
            "title": "Max home sq ft",
            "minimum": 0,
            "type": "integer",
            "description": "Largest home size in square feet. 0 = no maximum."
          },
          "minBeds": {
            "title": "Min bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At least this many bedrooms. 0 = any."
          },
          "maxBeds": {
            "title": "Max bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At most this many bedrooms. 0 = any."
          },
          "minBaths": {
            "title": "Min bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At least this many bathrooms. 0 = any."
          },
          "activity": {
            "title": "🎣 Activity",
            "enum": [
              "any",
              "fishing",
              "boating",
              "horseback-riding",
              "golfing",
              "rving",
              "beach",
              "canoeing-kayaking",
              "camping",
              "off-roading",
              "skiing",
              "aquatic-sporting",
              "conservation",
              "aviation"
            ],
            "type": "string",
            "description": "Land the seller tags for this use.",
            "default": "any"
          },
          "landUse": {
            "title": "🌾 Land use",
            "enum": [
              "any",
              "homestead",
              "hobby-farm",
              "orchard",
              "pasture",
              "vineyard",
              "poultry"
            ],
            "type": "string",
            "description": "Present use as the seller lists it.",
            "default": "any"
          },
          "housingType": {
            "title": "🛖 Housing type",
            "enum": [
              "any",
              "guest-house",
              "mobile-home",
              "barndominium",
              "cottage",
              "tiny-home",
              "log-cabin",
              "lake-house"
            ],
            "type": "string",
            "description": "Kind of dwelling on the land.",
            "default": "any"
          },
          "geography": {
            "title": "⛰️ Geography",
            "enum": [
              "any",
              "mountain",
              "rural",
              "off-grid",
              "riverfront",
              "lakefront",
              "desert",
              "resort",
              "beachfront",
              "island"
            ],
            "type": "string",
            "description": "Setting as the seller lists it.",
            "default": "any"
          },
          "hoa": {
            "title": "HOA",
            "enum": [
              "any",
              "none",
              "mandatory",
              "voluntary"
            ],
            "type": "string",
            "description": "Homeowners' association.",
            "default": "any"
          },
          "ownerFinancing": {
            "title": "Owner financing",
            "type": "boolean",
            "description": "Only listings the seller will finance.",
            "default": false
          },
          "mineralRights": {
            "title": "Mineral rights",
            "type": "boolean",
            "description": "Only listings that include mineral rights.",
            "default": false
          },
          "hasVideo": {
            "title": "Has video",
            "type": "boolean",
            "description": "Only listings with a property video.",
            "default": false
          },
          "hasVirtualTour": {
            "title": "Has virtual tour",
            "type": "boolean",
            "description": "Only listings with a virtual tour.",
            "default": false
          },
          "hasExteriorTour": {
            "title": "Has exterior tour",
            "type": "boolean",
            "description": "Only listings with an exterior (3D) tour.",
            "default": false
          },
          "hasCustomMap": {
            "title": "Has custom map",
            "type": "boolean",
            "description": "Only listings with a seller-drawn property map.",
            "default": false
          },
          "keyword": {
            "title": "🔤 Keyword",
            "type": "string",
            "description": "Words the listing must mention, e.g. \"creek\", \"trout stream\", \"barn\". Empty = no keyword."
          },
          "listedWithin": {
            "title": "🆕 Listed within",
            "enum": [
              "any",
              "1",
              "7",
              "30",
              "60"
            ],
            "type": "string",
            "description": "Only listings first published in this window.",
            "default": "any"
          },
          "priceChangedWithin": {
            "title": "📉 Price changed within",
            "enum": [
              "any",
              "3",
              "7",
              "30",
              "60",
              "90"
            ],
            "type": "string",
            "description": "Only listings whose price changed in this window (see the next field for reductions vs any change).",
            "default": "any"
          },
          "priceChangeType": {
            "title": "Price change type",
            "enum": [
              "reduced",
              "any"
            ],
            "type": "string",
            "description": "With \"Price changed within\": reductions only, or any change.",
            "default": "reduced"
          },
          "sortBy": {
            "title": "↕️ Sort by",
            "enum": [
              "default",
              "newest",
              "recently-changed",
              "price-low-high",
              "price-high-low",
              "acres-low-high",
              "acres-high-low",
              "price-per-acre-low-high",
              "price-per-acre-high-low"
            ],
            "type": "string",
            "description": "Order of results. Searches walked past 500 rows (see Split large searches) come back in acreage order.",
            "default": "default"
          },
          "minPricePerAcre": {
            "title": "Min price per acre (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Lowest price per acre, e.g. 1500. 0 = no minimum. Rows without a price per acre are dropped when set."
          },
          "maxPricePerAcre": {
            "title": "Max price per acre (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Highest price per acre, e.g. 5000. 0 = no maximum."
          },
          "withBrokerPhoneOnly": {
            "title": "Only rows with a phone",
            "type": "boolean",
            "description": "Listings: keep only rows with a broker phone (search rows carry it on ~30%; details add it on most). Agents: only rows with a phone.",
            "default": false
          },
          "includeDetails": {
            "title": "📄 Include details",
            "type": "boolean",
            "description": "Read each listing's page: full description, highlights, amenities/features, price history, documents, video/tour links, parcel and MLS ids, county FIPS, broker phones, website and address. For agent rows: the profile page (social links, awards). Charged as the details event.",
            "default": false
          },
          "includeBoundary": {
            "title": "🗺️ Include parcel boundary",
            "type": "boolean",
            "description": "Add the seller's parcel outline as a GeoJSON polygon when the listing has one (no extra request, no extra charge).",
            "default": false
          },
          "monitorMode": {
            "title": "🔁 Monitor mode",
            "type": "boolean",
            "description": "Deliver only rows that are new or whose price or status changed since earlier runs (changeType NEW / PRICE_CHANGED / STATUS_CHANGED). Pairs with a daily schedule.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Named key-value store that remembers delivered rows. Use one name per tracked search. Empty = \"landwatch-land-monitor\"."
          },
          "includeUnchanged": {
            "title": "Include unchanged rows",
            "type": "boolean",
            "description": "With monitor mode: also deliver (and pay for) rows that did not change, labelled UNCHANGED.",
            "default": false
          },
          "maxResults": {
            "title": "📦 Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Rows to deliver in total across all searches. The site shows 500 per search; with Split large searches on, a search is walked past that (Texas alone has ~80,000). 0 = no limit.",
            "default": 100
          },
          "maxResultsPerSearch": {
            "title": "Max results per search",
            "minimum": 0,
            "type": "integer",
            "description": "Cap for each location or URL. 0 = only the total cap applies."
          },
          "splitLargeSearches": {
            "title": "Split large searches",
            "type": "boolean",
            "description": "Walk past the site's 500-listing window by stepping through acreage (then price) ranges. Results then come in acreage order.",
            "default": true
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (id, url, title, status, price, acres, price per acre, types, location, coordinates, broker) - smaller rows for AI/MCP pipelines.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Detail and profile pages read in parallel.",
            "default": 4
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Leave as is: the actor tries Apify's own connection first and switches to residential (US) or Apify's unblocker by itself when the site refuses it. Your own proxy URLs are used first if you add them.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}