{ "openapi": "3.0.1", "info": { "title": "LandSearch Scraper", "description": "Scrape LandSearch.com land listings by URL, state, county, city, or ZIP. Filter by price, acreage, price/acre, land use, buildings, utilities, and more. JSON, CSV, Excel.", "version": "1.1", "x-build-id": "5bMkXFlZKpJSFASb6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~landsearch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-landsearch-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/parsebird~landsearch-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-landsearch-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/parsebird~landsearch-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-landsearch-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Full LandSearch.com URLs: a search page (e.g. https://www.landsearch.com/properties/texas) or a single property page. Filters already in the URL are kept and combined with the filters below.", "default": [], "items": { "type": "string" } }, "searchLocations": { "title": "Search locations", "type": "array", "description": "Type a place instead of a URL: a state (Texas), county (Travis County, TX), city (Austin, TX), or ZIP (76082). Each becomes its own search using the filters below.", "default": [], "items": { "type": "string" } }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Limit to one or more property types. Leave empty for all types.", "items": { "type": "string", "enum": [ "residential", "commercial", "agricultural", "recreational" ], "enumTitles": [ "Residential", "Commercial", "Agricultural", "Recreational" ] }, "default": [] }, "listingFormat": { "title": "Listing format", "enum": [ "any", "sales", "leases", "auctions" ], "type": "string", "description": "Sale, lease, or auction listings only.", "default": "any" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Minimum asking price in USD." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Maximum asking price in USD." }, "minAcres": { "title": "Min acres", "minimum": 0, "type": "number", "description": "Minimum parcel size in acres. Decimals accepted (e.g. 0.5)." }, "maxAcres": { "title": "Max acres", "minimum": 0, "type": "number", "description": "Maximum parcel size in acres. Decimals accepted (e.g. 0.5)." }, "minPricePerAcre": { "title": "Min price per acre (USD)", "minimum": 0, "type": "integer", "description": "Minimum price-per-acre — the classic land-value screen." }, "maxPricePerAcre": { "title": "Max price per acre (USD)", "minimum": 0, "type": "integer", "description": "Maximum price-per-acre — the classic land-value screen." }, "keywords": { "title": "Keywords", "type": "string", "description": "Match a word or phrase in the listing description, e.g. cabin, creek frontage, owner will carry." }, "maxDaysOnMarket": { "title": "Max days on market", "enum": [ "", "1", "3", "7", "30", "90", "180" ], "type": "string", "description": "Only show listings posted within this many days.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "featured", "newest", "price_high_low", "price_low_high", "size_large_small", "size_small_large", "recently_updated" ], "type": "string", "description": "Order results are collected in.", "default": "featured" }, "hasHome": { "title": "Has house or building", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Require, or exclude, a building on the parcel.", "default": "any" }, "minBedrooms": { "title": "Min bedrooms", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Minimum bedroom count (only applies to listings with a home).", "default": "" }, "maxBedrooms": { "title": "Max bedrooms", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Maximum bedroom count.", "default": "" }, "minBathrooms": { "title": "Min bathrooms", "enum": [ "", "1", "2", "3", "4" ], "type": "string", "description": "Minimum bathroom count.", "default": "" }, "minHomeSqft": { "title": "Min home sqft", "minimum": 0, "type": "integer", "description": "Minimum building size in square feet." }, "maxHomeSqft": { "title": "Max home sqft", "minimum": 0, "type": "integer", "description": "Maximum building size in square feet." }, "minYearBuilt": { "title": "Min year built", "type": "integer", "description": "Earliest construction year." }, "maxYearBuilt": { "title": "Max year built", "type": "integer", "description": "Latest construction year." }, "terrain": { "title": "Terrain", "type": "array", "description": "Geographic setting, e.g. waterfront or off-grid.", "items": { "type": "string", "enum": [ "rural", "mountain", "waterfront", "lakefront", "riverfront", "beachfront", "island", "desert", "resort", "off-grid" ], "enumTitles": [ "Rural", "Mountain", "Waterfront", "Lakefront", "Riverfront", "Beachfront", "Island", "Desert", "Resort", "Off grid" ] }, "default": [] }, "landUses": { "title": "Land uses", "type": "array", "description": "How the land is used or zoned, e.g. ranch or timberland.", "items": { "type": "string", "enum": [ "ranch", "cattle-ranch", "homestead", "hobby-farm", "organic-farm", "row-crop", "dairy-farm", "chicken-farm", "timberland", "development", "investment", "industrial", "mixed-use", "rv-lot" ], "enumTitles": [ "Ranch", "Cattle ranch", "Homestead", "Hobby farm", "Organic farm", "Row crop", "Dairy farm", "Chicken farm", "Timberland", "Development land", "Investment", "Industrial", "Mixed use", "RV lot" ] }, "default": [] }, "buildings": { "title": "Buildings", "type": "array", "description": "Structures present on the property, e.g. cabin or barn.", "items": { "type": "string", "enum": [ "house", "cabin", "cottage", "farm-house", "a-frame-house", "barndominium", "lodge", "tiny-home", "mobile-home", "barn", "workshop", "bunker" ], "enumTitles": [ "House", "Cabin", "Cottage", "Farm house", "A-frame house", "Barndominium", "Lodge", "Tiny home", "Mobile home", "Barn", "Workshop", "Bunker" ] }, "default": [] }, "utilities": { "title": "Utilities", "type": "array", "description": "Infrastructure already on the property, e.g. water well or solar power.", "items": { "type": "string", "enum": [ "water-well", "septic", "solar-power", "fenced", "irrigated", "airstrip" ], "enumTitles": [ "Water well", "Septic system", "Solar power", "Fenced", "Irrigated", "Airstrip" ] }, "default": [] }, "naturalFeatures": { "title": "Natural features", "type": "array", "description": "Natural landscape features, e.g. creek or wooded.", "items": { "type": "string", "enum": [ "creek", "stream", "pond", "spring", "waterfall", "wetland", "wooded", "pasture", "orchard", "vineyard", "cave", "mineral-rights", "water-rights", "oil" ], "enumTitles": [ "Creek", "Stream", "Pond", "Spring", "Waterfall", "Wetland", "Wooded", "Pasture", "Orchard", "Vineyard", "Cave", "Mineral rights", "Water rights", "Oil" ] }, "default": [] }, "activities": { "title": "Activities", "type": "array", "description": "Recreational uses the land supports, e.g. hunting or fishing.", "items": { "type": "string", "enum": [ "hunting", "fishing", "waterfowl", "equestrian", "camping", "conservation", "borders-public-land", "golf-course-lot" ], "enumTitles": [ "Hunting", "Fishing", "Waterfowl", "Equestrian", "Camping", "Conservation", "Borders public land", "Golf course lot" ] }, "default": [] }, "dealTypes": { "title": "Deal types", "type": "array", "description": "Special deal or listing conditions, e.g. owner financing or FSBO.", "items": { "type": "string", "enum": [ "owner-financing", "by-owner", "rent-to-own", "cheap", "distressed", "vacant", "unrestricted", "new-construction", "historic", "sustainable" ], "enumTitles": [ "Owner financing available", "For sale by owner", "Rent to own", "Cheap land", "Distressed", "Vacant", "Unrestricted (no zoning limits)", "New construction", "Historic", "Sustainable" ] }, "default": [] }, "mustHavePhotos": { "title": "Must have photos", "type": "boolean", "description": "Skip listings with no photos at all.", "default": false }, "listingSource": { "title": "Listing source", "enum": [ "any", "mls", "non_mls" ], "type": "string", "description": "MLS-listed only, or non-MLS (often listed directly by the owner).", "default": "any" }, "excludePending": { "title": "Exclude pending listings", "type": "boolean", "description": "Skip properties that already have an accepted offer.", "default": false }, "excludeHoa": { "title": "Exclude HOA listings", "type": "boolean", "description": "Skip properties belonging to a homeowners association.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Total properties to collect across every URL and location. You get exactly this many when that many match — never a rounded-up batch. 0 collects every match. Each individual search (one URL or one location) can return at most 10,000 properties — a LandSearch platform limit.", "default": 10 }, "includePropertyDetails": { "title": "Include full property details", "type": "boolean", "description": "Also collect street address, full description, every photo, price history, land and building features, elevation, school district, MLS number, and agent contacts. Turn off for a faster overview (title, price, acres, and location only).", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "LandSearch is protected by Cloudflare. Residential proxies are strongly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }