{ "openapi": "3.0.1", "info": { "title": "LandSearch Scraper", "description": "[💰 $0.7 / 1K] Extract US land, farm, ranch, hunting land and rural property listings from LandSearch. Filter by state, county, city or ZIP, acreage, price, land features and home details. Get prices, GPS, photos, price history and agent contacts.", "version": "1.0", "x-build-id": "C5eGD0Txtp9kFFINA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~landsearch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~landsearch-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~landsearch-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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": "Paste LandSearch URLs directly — either a search page (e.g. https://www.landsearch.com/properties/texas) or a single property page (e.g. https://www.landsearch.com/properties/1886-jay-bird-ln-springtown-tx-76082/4041412). Any filters already in the URL are kept — if one of them is misspelled or unsupported it is skipped and named in the log, so watch for that when you hand-edit an address. The filter settings below do NOT apply to these URLs — everything comes from the URL itself.", "items": { "type": "string" } }, "searchLocations": { "title": "Search Locations", "type": "array", "description": "Search by typing a place instead of building a URL. Works with a state ('Texas'), a county ('Travis County, TX'), a city ('Austin, TX') or a ZIP code ('76082'). Each location becomes its own search using the filters below.", "items": { "type": "string" } }, "propertyTypes": { "title": "Property Types", "uniqueItems": true, "type": "array", "description": "Only show these kinds of land. Leave empty for all types. Selecting several widens the search.", "items": { "type": "string", "enum": [ "residential", "commercial", "agricultural", "recreational" ], "enumTitles": [ "Residential land", "Commercial land", "Farmland / agricultural", "Recreational land" ] } }, "listingFormat": { "title": "Listing Type", "enum": [ "any", "sales", "leases", "auctions" ], "type": "string", "description": "Include everything, or narrow to properties for sale, for lease, or going to auction." }, "minPrice": { "title": "Minimum Price (USD)", "minimum": 0, "type": "integer", "description": "Only show properties priced at or above this amount. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price (USD)", "minimum": 0, "type": "integer", "description": "Only show properties priced at or below this amount. Leave empty for no maximum." }, "minAcres": { "title": "Minimum Acres", "minimum": 0, "type": "number", "description": "Only show properties of at least this many acres. Decimals are fine (e.g. 0.5). Leave empty for no minimum." }, "maxAcres": { "title": "Maximum Acres", "minimum": 0, "type": "number", "description": "Only show properties up to this many acres. Leave empty for no maximum." }, "minPricePerAcre": { "title": "Minimum Price Per Acre (USD)", "minimum": 0, "type": "integer", "description": "Only show properties at or above this price per acre. Useful for filtering out low-value remote parcels." }, "maxPricePerAcre": { "title": "Maximum Price Per Acre (USD)", "minimum": 0, "type": "integer", "description": "Only show properties at or below this price per acre. This is the classic land-value filter for finding bargains." }, "keywords": { "title": "Keywords", "type": "string", "description": "Only show listings whose description mentions this word or phrase, for example 'cabin', 'creek frontage' or 'owner will carry'." }, "maxDaysOnMarket": { "title": "Listed Within", "enum": [ "1", "3", "7", "30", "90", "180" ], "type": "string", "description": "Only show properties first listed within this many days. Great for spotting fresh inventory before it moves. Leave empty to include listings of any age." }, "sortBy": { "title": "Sort Results By", "enum": [ "featured", "newest", "price_high_low", "price_low_high", "size_large_small", "size_small_large", "recently_updated" ], "type": "string", "description": "Order of the results. When you collect fewer properties than your search matches, this decides which ones you get — sort by price or by newest to put the listings you care about at the top." }, "hasHome": { "title": "Has a House", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Whether the land must include a building or residence." }, "minBedrooms": { "title": "Minimum Bedrooms", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Only show properties with a home of at least this many bedrooms. Leave empty for any number of bedrooms." }, "maxBedrooms": { "title": "Maximum Bedrooms", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Only show properties with a home of at most this many bedrooms. Leave empty for any number of bedrooms." }, "minBathrooms": { "title": "Minimum Bathrooms", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Only show properties with a home of at least this many bathrooms. Leave empty for any number of bathrooms." }, "minHomeSqft": { "title": "Minimum Home Size (sq ft)", "minimum": 0, "type": "integer", "description": "Only show properties whose building is at least this many square feet." }, "maxHomeSqft": { "title": "Maximum Home Size (sq ft)", "minimum": 0, "type": "integer", "description": "Only show properties whose building is at most this many square feet." }, "minYearBuilt": { "title": "Built After Year", "minimum": 1600, "type": "integer", "description": "Only show properties whose building was built in or after this year." }, "maxYearBuilt": { "title": "Built Before Year", "minimum": 1600, "type": "integer", "description": "Only show properties whose building was built in or before this year." }, "terrain": { "title": "Terrain & Setting", "uniqueItems": true, "type": "array", "description": "Only show properties in these kinds of settings. Picking several narrows the search further, so start with one.", "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" ] } }, "landUses": { "title": "Current Land Use", "uniqueItems": true, "type": "array", "description": "Only show properties currently used this way.", "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" ] } }, "buildings": { "title": "Buildings on the Land", "uniqueItems": true, "type": "array", "description": "Only show properties with one of these kinds of building on them.", "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" ] } }, "utilities": { "title": "Utilities & Improvements", "uniqueItems": true, "type": "array", "description": "Only show properties that already have these in place — a big deal for build-ready land.", "items": { "type": "string", "enum": [ "water-well", "septic", "solar-power", "fenced", "irrigated", "airstrip" ], "enumTitles": [ "Water well", "Septic system", "Solar power", "Fenced", "Irrigated", "Airstrip" ] } }, "naturalFeatures": { "title": "Natural Features", "uniqueItems": true, "type": "array", "description": "Only show properties with these natural features. 'Mineral rights' and 'Oil' matter most to investors.", "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" ] } }, "activities": { "title": "Recreational Activities", "uniqueItems": true, "type": "array", "description": "Only show properties suited to these activities.", "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" ] } }, "dealTypes": { "title": "Deal Type", "uniqueItems": true, "type": "array", "description": "Only show properties matching these deal characteristics. 'Owner financing' and 'For sale by owner' are the classic off-market investor filters.", "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" ] } }, "mustHavePhotos": { "title": "Only Listings With Photos", "type": "boolean", "description": "Skip listings that have no photos at all." }, "listingSource": { "title": "Listing Source", "enum": [ "any", "mls", "non_mls" ], "type": "string", "description": "Whether the listing comes from an MLS (agent-listed) or not. Non-MLS listings are often sold directly by the owner." }, "excludePending": { "title": "Hide Pending Sales", "type": "boolean", "description": "Skip properties that already have an accepted offer." }, "excludeHoa": { "title": "Hide Properties With an HOA", "type": "boolean", "description": "Skip properties belonging to a homeowners association." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of properties to collect across every URL and location. You get exactly this many when that many match — never more, never a rounded-up batch. Set to 0 to collect every property that matches your search (up to 500,000 in a single run, which is more than LandSearch lists nationwide). Tip: start with 10-50 to check the output, then increase." }, "includePropertyDetails": { "title": "Include Full Property Details", "type": "boolean", "description": "Also collect the street address, full description, every photo, price history, land and building features, elevation, school district, MLS number, and the listing agent's name and phone number. Turn this off for a fast overview — but note the street address, description, photo gallery, agent contacts and price history are only available with it on." } } }, "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 } } } } } } } } } }