LandWatch Agents API finds land agents and brokers by name or by the area they serve (state, county or city), 24 agents per page. Each agent has a profile with public phone numbers, address, logo and listing statistics. A county or city that LandWatch does not know answers 404 and is not billed. Send either name or state.
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.
5 optional filters available.
string
Optional
Agent or company name. Use it instead of state.
example
string
Optional
US state name or 2-letter code. Lists the agents who serve the state.
example
string
Optional
County name within the state. Not together with city.
example
string
Optional
City name within the state. Not together with county. Use the agent-autocomplete route for valid places.
example
integer
Optional
One-based page number, 1 to 100. Default 1. 24 agents per page.
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": 17470,
"bio": "Thomas sells Commercial / Residential Land & Homes in the Permian Basin, South Plains, Concho Basin, Hill Country, as well as West Texas & New Mexico Ranches. His college career included a run at Texas Tech where he received a BA in Communi",
"url": "https://www.landwatch.com/profile/thomas-johnston/17470",
"logo": {
"url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-2703757878",
"thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-2703757878"
},
"name": "Thomas Johnston",
"stats": {
"active_listings": 99,
"active_acres_max": 560,
"active_acres_min": 0.13,
"active_price_max": 13024440,
"active_price_min": 24500
},
"phones": {
"fax": "(555) 010-0100",
"mobile": "(555) 010-0100",
"office": "(555) 010-0100",
"preferred": "(555) 010-0100"
},
"address": {
"city": "Dripping Springs",
"street": "2201 US 290",
"state_code": "TX",
"postal_code": "78620"
},
"company": "The Real Estate Ranch",
"website": "www.therealestateranch.com",
"portrait": {
"url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-3791698862",
"thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-3791698862"
},
"license_number": "0542176",
"company_address": {
"city": "Midland",
"street": "6 Desta Dr.",
"state_code": "TX",
"postal_code": "79705"
}
}
],
"pagination": {
"page": 1,
"total": 141,
"per_page": 24,
"total_pages": 6,
"filtered_out": 0,
"has_next_page": true
}
},
"meta": {
"billable": true,
"endpoint_family": "agents"
},
"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": {
"name": [
"The name field is required when state is not present."
]
},
"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": "agents"
},
"error": {
"code": "NOT_FOUND",
"message": "The area was not found. Use the agent-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": "agents"
},
"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.