--- title: "LandWatch API: JSON data, 6 endpoints, 1 credit per call" description: "LandWatch API for US land, farms, ranches and hunting property for sale, listings, agents and autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/landwatch --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / LandWatch 1 credit per call 6 endpoints 21 datapoints # LandWatch API LandWatch API for US land, farms, ranches and hunting property for sale, listings, agents and autocomplete as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below LandWatch GET /v1/landwatch/search?state=Texas&price\_min=50000&price\_max=99999&acres\_min=11&acres\_max=50 ``` { "success": true, "data": { "applied_filters": { "state": "TX", "price_min": "50000", "price_max": "99999", "acres_min": "11", "acres_max": "50", "sort": "default" }, "pagination": { "page": 1, "per_page": 25, "total": 239, "total_pages": 10, "has_next_page": true, "result_cap": 500, "filtered_out": 0 }, "items": [ { "id": 418605256, "property_id": 19198778, "title": "Soledad Creek Ranch", "description": "Discover gently rolling South Texas land with abundant wildlife, mature mesquite cover, utility availability, and flexible owner financing options.", "status": "available", "price": { "value": 73199, "currency": "USD" }, "price_display": "$73,199", "price_per_acre": 5995, "acres": 12.21, "address": { "city": "Freer", "county": "Duval County", "state": "Texas", "state_code": "TX", "postal_code": "78341", "coordinates": { "latitude": 27.8519, "longitude": -98.637 } }, "property_types": [ "Farms and Ranches", "Recreational Property", "Hunting Property" ], "has_house": false, "has_video": false, "has_virtual_tour": false, "has_custom_map": false, "photo_count": 28, "photos": [ { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5157226976", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5157226976" }, { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5157227031", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5157227031" }, { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5157227032", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5157227032" } ], "url": "https://www.landwatch.com/duval-county-texas-farms-and-ranches-for-sale/pid/418605256", "listed_at": "2024-01-04T18:00:21.247", "updated_at": "2026-10-01T08:39:38.18", "agent": { "id": 48436, "name": "Gene Lehmann", "company": "Triad Land Investments", "phone": "(979) 575-3939", "url": "https://www.landwatch.com/profile/gene-lehmann/48436" } }, { "id": 419811444, "property_id": 20404966, "title": "POWER**EXOTICS**5% DOWN OWNER FINANCING", "description": "POWER runs on the access road to the property FREE RANGING EXOTICS-- Apart from white-tailed deer & axis, hunters might also find opportunities to pursue other game species, such as elk, aoudad, sika deer, fallow, wild hogs, turkey, quail, …", "status": "available", "price": { "value": 89175, "currency": "USD" }, "price_display": "$89,175", "price_per_acre": 4337.31, "price_change": { "amount": -3315, "percent": -3.58, "changed_at": "2025-09-02T09:42:06.117" }, "acres": 20.56, "address": { "city": "Rocksprings", "county": "Edwards County", "state": "Texas", "state_code": "TX", "postal_code": "78880", "coordinates": { "latitude": 29.864645, "longitude": -100.237635 } }, "property_types": [ "Farms and Ranches", "Recreational Property", "Hunting Property" ], "has_house": false, "has_video": true, "has_virtual_tour": false, "has_custom_map": false, "photo_count": 29, "photos": [ { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5242455293", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5242455293" }, { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5242455338", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5242455338" }, { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-5242455299", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-5242455299" } ], "url": "https://www.landwatch.com/edwards-county-texas-farms-and-ranches-for-sale/pid/419811444", "listed_at": "2024-05-22T13:46:24.12", "updated_at": "2026-09-14T12:18:55.883", "listing_level": "Signature Partner", "agent": { "id": 962197, "name": "Alle Osborne", "company": "Osborne TX Ranches, LLC", "url": "https://www.landwatch.com/profile/alle-osborne/962197" } }, { "id": 427847295, "property_id": 28444780, "title": "ELEVEN FARMS", "description": "Call Jessica @806-500-4603 for details or showing of the property. 20-160 acres of land just south of New Home. This is a highly desired area just outside of Lubbock with growing property value and fantastic school district. If you're looki…", "status": "available", "price": { "value": 89999, "currency": "USD" }, "price_display": "$89,999", "price_per_acre": 4499.95, "price_change": { "amount": -10000, "percent": -10, "changed_at": "2026-10-29T11:44:37.82" }, "acres": 20, "address": { "street": "1355 County Road 11", "city": "Tahoka", "county": "Lynn County", "state": "Texas", "state_code": "TX", "postal_code": "79373", "coordinates": { "latitude": 33.31269073486328, "longitude": -101.86701202392578 } }, "property_types": [ "Farms and Ranches" ], "has_house": false, "has_video": false, "has_virtual_tour": false, "has_custom_map": false, "photo_count": 6, "photos": [ { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-6421393143", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-6421393143" }, { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-6421393147", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-6421393147" }, { "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-6421393145", "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-6421393145" } ], "url": "https://www.landwatch.com/lynn-county-texas-farms-and-ranches-for-sale/pid/427847295", "listed_at": "2026-08-13T09:44:35.813", "updated_at": "2026-10-29T11:52:52.717", "listing_level": "Signature Partner", "agent": { "id": 3340386, "name": "Carlos Medina", "company": "Viva Land Group", "url": "https://www.landwatch.com/profile/carlos-medina-/3340386" } } ], "facets": [ { "name": "Region", "options": [ { "label": "Piney Woods South Region", "count": 41 }, { "label": "Northeast Region", "count": 35 }, { "label": "Trans Pecos Region", "count": 33 } ] }, { "name": "County", "options": [ { "label": "Brewster County", "count": 19 }, { "label": "Cass County", "count": 13 }, { "label": "Newton County", "count": 12 } ] }, { "name": "City", "options": [ { "label": "Terlingua", "count": 10 }, { "label": "Rocksprings", "count": 9 }, { "label": "Alpine", "count": 8 } ] } ] }, "meta": { "endpoint_family": "search", "request_id": "req_0b60d546a25b4d14886fd7d5f26e9bef", "credits_charged": 1, "credits_remaining": 1850 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | property\_id integer | title string | description string | status string | price object | price\_display string | price\_per\_acre number | acres number | address object | property\_types string\[\] | has\_house boolean | has\_video boolean | has\_virtual\_tour boolean | has\_custom\_map boolean | photo\_count integer | photos object\[\] | url url | listed\_at string | updated\_at string | agent object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 418605256 | 19198778 | Soledad Creek Ranch | Discover gently rolling South Texas land with abundant wildlife, mature mesquite cover, utility availability, and flexible owner financing options. | available | {2 fields} | $73,199 | 5995 | 12.21 | {6 fields} | \[3 items\] | false | false | false | false | 28 | \[3 items\] | https://www.landwatch.com/duval-county-texas-farms-and-ranches-for-sale/pid/418605256 | 2024-01-04T18:00:21.247 | 2026-10-01T08:39:38.18 | {5 fields} | | 2 | 419811444 | 20404966 | POWER\*\*EXOTICS\*\*5% DOWN OWNER FINANCING | POWER runs on the access road to the property FREE RANGING EXOTICS-- Apart from white-tailed deer & axis, hunters might also find opportunities to pursue other game species, such as elk, aoudad, sika deer, fallow, wild hogs, turkey, quail, … | available | {2 fields} | $89,175 | 4337.31 | 20.56 | {6 fields} | \[3 items\] | false | true | false | false | 29 | \[3 items\] | https://www.landwatch.com/edwards-county-texas-farms-and-ranches-for-sale/pid/419811444 | 2024-05-22T13:46:24.12 | 2026-09-14T12:18:55.883 | {4 fields} | | 3 | 427847295 | 28444780 | ELEVEN FARMS | Call Jessica @806-500-4603 for details or showing of the property. 20-160 acres of land just south of New Home. This is a highly desired area just outside of Lubbock with growing property value and fantastic school district. If you're looki… | available | {2 fields} | $89,999 | 4499.95 | 20 | {7 fields} | \[1 item\] | false | false | false | false | 6 | \[3 items\] | https://www.landwatch.com/lynn-county-texas-farms-and-ranches-for-sale/pid/427847295 | 2026-08-13T09:44:35.813 | 2026-10-29T11:52:52.717 | {4 fields} | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/landwatch/search?state=Texas&price\_min=50000&price\_max=99999&acres\_min=11&acres\_max=50 21 datapoints ### Identity - id integer - property\_id integer - title string - status string - property\_types string\[\] ### Contact - url url - agent object ### Location - address object ### Reputation - photo\_count integer - photos object\[\] ### Price - price object - price\_display string - price\_per\_acre number ### Other - description string - acres number - has\_house boolean - has\_video boolean - has\_virtual\_tour boolean - has\_custom\_map boolean - listed\_at string - updated\_at string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/landwatch/search?state=Texas&price_min=50000&price_max=99999&acres_min=11&acres_max=50" \ -H "X-API-Key: $API_KEY" ``` LandWatch · 6 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/landwatch/agent`](https://perceptlayer.com/apis/landwatch/agent) | `agent_id` +1 optional | 1 credit | | [GET `/v1/landwatch/agent-autocomplete`](https://perceptlayer.com/apis/landwatch/agent-autocomplete) | `q` | 1 credit | | [GET `/v1/landwatch/agents`](https://perceptlayer.com/apis/landwatch/agents) | none +5 optional | 1 credit | | [GET `/v1/landwatch/autocomplete`](https://perceptlayer.com/apis/landwatch/autocomplete) | `q` | 1 credit | | [GET `/v1/landwatch/listing`](https://perceptlayer.com/apis/landwatch/listing) | `listing_id` | 1 credit | | [GET `/v1/landwatch/search`](https://perceptlayer.com/apis/landwatch/search) | none +16 optional | 1 credit | Overview ## About the LandWatch API ## What you can get The LandWatch API returns LandWatch land data as JSON through 6 endpoints. - **Search:** `search` takes a `state`, `county`, `city` or `postal_code`, with `listing_type` (sale), `property_type` (undeveloped-land, recreational-property, hunting-property, farms-ranches, timberland-property, horse-property, homes, waterfront-property, commercial-property, riverfront-property or lakefront-property), `status` (available, under\_contract, sold or auction), `residence` (with or no), `price_min`, `price_max`, `acres_min`, `acres_max`, `beds_min`, `baths_min`, `sort` (default, newest, price\_asc, price\_desc, acres\_asc, acres\_desc or changed) and `page`. - **Listings:** `listing` takes a `listing_id`. - **Agents:** `agents` takes a `name`, `state`, `county` or `city`, with `page`; `agent` takes an `agent_id`, with `page`; `agent-autocomplete` takes `q`. - **Locations:** `autocomplete` takes `q`. The recorded `search` for Texas (50,000 to 99,999, 11 to 50 acres) returns a `total` of 239, with `total_pages`, `has_next_page` and a `result_cap` of 500. Each item carries `id`, `property_id`, `title`, `description`, `status`, `price`, `price_per_acre`, `acres`, `address`, `property_types`, `has_house`, `photo_count`, `url`, `listed_at`, `updated_at` and `agent`. It also returns `facets` for the search. ## How a call works Search a state: `GET /v1/landwatch/search?state=Texas&price_min=50000&price_max=99999&acres_min=11&acres_max=50` with your key in the `X-API-Key` header. Each item's `agent.id` is the `agent_id` that `agent` takes. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track land prices per acre with \`price\_per\_acre\` `` Use the LandWatch API to track land prices per acre with `price_per_acre` `` ### Find farms, ranches, timberland or hunting property by \`property\_type\` `` Use the LandWatch API to find farms, ranches, timberland or hunting property by `property_type` `` ### Pull sold land for comparables with \`status=sold\` `` Use the LandWatch API to pull sold land for comparables with `status=sold` `` ### Watch for listings that changed with \`sort=changed\` `` Use the LandWatch API to watch for listings that changed with `sort=changed` `` FAQ ## Questions **How much does the LandWatch API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a LandWatch account?** No. You call this LandWatch API with your Perceptlayer key in the \`X-API-Key\` header, with no LandWatch login. **Can I find land with or without a house?** Yes. Pass \`residence=with\` or \`residence=no\` to \`search\`; each item returns \`has\_house\`. **Should I build a LandWatch scraper instead?** You can, but a LandWatch scraper is code you maintain: page changes break it, requests get blocked, and LandWatch's terms govern how you collect data. The LandWatch API gives you 6 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the LandWatch API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)