LandWatch Search API returns up to 25 US land and rural property listings per page for sale, under contract, sold or at auction. Search a state, a county, a city or a postal code and filter by property type, price, acreage, bedrooms, bathrooms and residence. Each item carries the price in USD, price per acre, acreage, address, coordinates, property types, photos, price change and the listing agent. Every item satisfies the filters you sent; items that break a filter are never returned and are counted in pagination.filtered_out. beds_min and baths_min mean N or more. The site shows only the first 500 results of a query, so pages above 20 are rejected with a validation error. LandWatch lists property for sale only: rent and lease are not available. A page past the last returns an empty list. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
15 optional filters available.
string
Optional
US state name or 2-letter code, for example Texas or TX. Required unless postal_code is sent. Use the autocomplete route to find the values of a place.
example
string
Optional
County name within the state, for example Harris or Harris County. Not together with city.
example
string
Optional
City name within the state, for example Houston. Not together with county.
example
string
Optional
A 5-digit postal code, for example 79830. Use it instead of state.
example
string
Optional
One of undeveloped-land, recreational-property, hunting-property, farms-ranches, timberland-property, horse-property, homes, waterfront-property, commercial-property, riverfront-property, lakefront-property.
example
string
Optional
available, under_contract, sold or auction. Without it the search returns available and under contract listings. Sold items carry the sale price and date.
example
string
Optional
with for property that has a residence, no for property without one.
example
integer
Optional
Minimum price in USD, inclusive.
10
integer
Optional
Maximum price in USD, inclusive.
10
integer
Optional
Minimum acreage as a whole number, inclusive.
10
integer
Optional
Maximum acreage as a whole number, inclusive.
10
integer
Optional
Bedrooms: N or more. Beds 3 returns property with 3 or more bedrooms.
10
integer
Optional
Bathrooms: N or more.
10
string
Optional
default, newest, price_asc, price_desc, acres_asc, acres_desc or changed (recently changed).
relevance
integer
Optional
One-based page number, 1 to 20. The site shows the first 500 results of a query (25 per page). Split large areas by county, city, price or acres.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": 423072907,
"url": "https://www.landwatch.com/brewster-county-texas-farms-and-ranches-for-sale/pid/423072907",
"acres": 11.18,
"agent": {
"id": 3600242,
"url": "https://www.landwatch.com/profile/richmond-frasier/3600242",
"name": "Richmond Frasier",
"company": "Legacy Broker Group"
},
"price": {
"value": 68000,
"currency": "USD"
},
"title": "Low Pasture-Great For Horses",
"photos": [
{
"url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5544383413",
"thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5544383413"
}
],
"status": "available",
"address": {
"city": "Alpine",
"state": "Texas",
"county": "Brewster County",
"street": "Tract 15R Sierra la Rana",
"state_code": "TX",
"coordinates": {
"latitude": 30.357198,
"longitude": -103.614547
},
"postal_code": "79830"
},
"has_house": false,
"has_video": true,
"listed_at": "2025-05-28T14:58:27.13",
"updated_at": "2026-10-21T12:06:41.45",
"photo_count": 8,
"property_id": 23668411,
"price_change": {
"amount": 1000,
"percent": 1.49,
"changed_at": "2026-10-21T12:06:41.34"
},
"listing_level": "Signature Partner",
"price_display": "$68,000",
"has_custom_map": true,
"price_per_acre": 6082.29,
"property_types": [
"Farms and Ranches",
"Horse Property"
],
"has_virtual_tour": false
}
],
"facets": [
{
"name": "Region",
"options": [
{
"count": 40,
"label": "Piney Woods South Region"
},
{
"count": 37,
"label": "Trans Pecos Region"
},
{
"count": 35,
"label": "Northeast Region"
}
]
}
],
"pagination": {
"page": 2,
"total": 249,
"per_page": 25,
"result_cap": 500,
"total_pages": 10,
"filtered_out": 0,
"has_next_page": true
},
"applied_filters": {
"sort": "default",
"state": "TX",
"acres_max": 50,
"acres_min": 11,
"price_max": 99999,
"price_min": 50000
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"listing_type": [
"LandWatch lists property for sale only. Rent and lease are not available."
]
},
"message": "The request validation failed"
}Not Found
The place, listing or agent does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "NOT_FOUND",
"message": "The location was not found. Use the autocomplete route to find a valid place."
},
"success": false
}Upstream Unavailable
LandWatch could not be reached, or it answered with data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "LandWatch could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.