# LandWatch Listing API Documentation

<p><strong>LandWatch Listing API</strong> returns one listing: price, price per acre, acreage, rooms, address and coordinates, description, directions, highlights, parcel and MLS ids, price history, amenities by category, every photo, videos and tours, attachment names, the listing agent and other listings of the agent. Send the <code>id</code> of a search item. A listing that does not exist answers 404 and is not billed.</p>

- **Documentation:** [https://scrappa.co/docs/landwatch-api/landwatch_listing](https://scrappa.co/docs/landwatch-api/landwatch_listing)
- **API group:** LandWatch API
- **Endpoint:** `GET https://scrappa.co/api/landwatch/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | integer | Yes | The id field of a search item. Required. Example: 427300350. |

## Example response

```json
{
    "data": {
        "id": 427300350,
        "mls": {
            "id": "2056792"
        },
        "url": "https://www.landwatch.com/kinney-county-texas-recreational-property-for-sale/pid/427300350",
        "sqft": 192,
        "acres": 20.07,
        "agent": {
            "id": 1067769,
            "bio": "After long and rewarding careers in the oil industry and education, my wife Donna and I moved to Marble Falls, TX in 2015. We were both raised in a rural small town Texas environment and wanted to return to that atmosphere after many years in the big city of Houston.\n\nWe have focused on building a business around brokering Texas Hill Country real estate, recreational ranches, transitional land, working ranches, hunting ranches and small estates.\n\nWe are using the skills gained in the corporate world and education world to provide an efficient and effective service around buying and selling Hill Country properties.\n\nThis business gives us a reason to be heavily involved in the local community and to give back in ways that were difficult in previous career roles.\n\nOver the last seven or eight years we have established a solid track history of sales and a long list of satisfied clients.\n\nWe are here for the long term and look forward to building our team and working with buyers and sellers across Texas.",
            "url": "https://www.landwatch.com/profile/robert-pahmiyer/1067769",
            "logo": {
                "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-3750645230",
                "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-3750645230"
            },
            "name": "Robert Pahmiyer",
            "phones": {
                "mobile": "(555) 010-0100",
                "office": "(555) 010-0100",
                "preferred": "(555) 010-0100"
            },
            "address": {
                "city": "Marble Falls",
                "street": "1225 Sycamore Falls Way",
                "state_code": "TX",
                "postal_code": "78654"
            },
            "company": "Keller Williams Land",
            "website": "www.tdrrealestategroup.com",
            "portrait": {
                "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-6180994187",
                "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-6180994187"
            },
            "member_since": "2017-11-17T11:04:11.363",
            "license_number": "696749",
            "company_address": {
                "city": "Marble Falls",
                "street": "1225 Sycamore Falls Way",
                "state_code": "TX",
                "postal_code": "78654"
            }
        },
        "price": {
            "value": 80000,
            "currency": "USD"
        },
        "title": "Leona Ranch Hunting Tract",
        "photos": [
            {
                "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-6307264672",
                "width": 960,
                "height": 540,
                "caption": "45CC4B86-197F-473F-A114-A79D0215F4B4",
                "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-6307264672"
            },
            {
                "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-6307264674",
                "width": 2048,
                "height": 1536,
                "caption": "326CDF00-0AD2-41BB-B408-7A3B09CFBA1B",
                "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-6307264674"
            }
        ],
        "status": "under_contract",
        "address": {
            "city": "Brackettville",
            "state": "Texas",
            "county": "Kinney County",
            "region": "Edwards Plateau West Texas",
            "street": "000 Private Road 3150, Brackettville, Texas 78832",
            "city_url": "https://www.landwatch.com/texas-land-for-sale/brackettville",
            "county_url": "https://www.landwatch.com/texas-land-for-sale/kinney-county",
            "state_code": "TX",
            "coordinates": {
                "latitude": 29.51065444946289,
                "longitude": -100.34730529785156
            },
            "county_fips": 48271,
            "postal_code": "78832",
            "geocode_accuracy": 5
        },
        "amenities": [
            {
                "group": "Land",
                "values": [
                    "Hunting"
                ],
                "category": "Activities"
            },
            {
                "group": "Land",
                "values": [
                    "Acreage",
                    "Some Trees"
                ],
                "category": "Lot Description"
            },
            {
                "group": "Land",
                "values": [
                    "Hunting/Fishing"
                ],
                "category": "Present Use"
            },
            {
                "group": "Land",
                "values": [
                    "Hunting/Fishing"
                ],
                "category": "Proposed Use"
            },
            {
                "group": "Land",
                "values": [
                    "Dirt"
                ],
                "category": "Street/Utilities"
            }
        ],
        "listed_at": "2026-06-30T00:00:00",
        "parcel_id": "0|2662|28960|1",
        "area_label": "20.07 acres",
        "directions": "Coming from 674 turn E on Leona Ranch Rd. Take the second left turn, property is approx. 1.64 miles on the left.",
        "updated_at": "2026-10-21T14:17:00",
        "attachments": [
            {
                "name": "Notice to Purchaser (2).pdf"
            }
        ],
        "description": "The ranch is located on the southern edge of the Edwards Plateau, known throughout Texas for its abundance of whitetail deer, turkey and more recently free-range exotics. The cabin is 480 SqFt including covered porches. The cabin has a small solar panel system with battery backup, that can run the w",
        "property_id": 27895855,
        "is_irrigated": false,
        "is_residence": true,
        "price_history": [
            {
                "date": "2026-06-30T00:00:00",
                "acres": 20.07,
                "event": "Listed for Sale",
                "price": 80000
            }
        ],
        "other_listings": [
            {
                "id": 412524576,
                "url": "https://www.landwatch.com/kinney-county-texas-farms-and-ranches-for-sale/pid/412524576",
                "beds": 5,
                "sqft": 3200,
                "acres": 101.16,
                "agent": {
                    "id": 1067769,
                    "url": "https://www.landwatch.com/profile/robert-pahmiyer/1067769",
                    "name": "Robert Pahmiyer",
                    "company": "Keller Williams Land"
                },
                "baths": 3,
                "price": {
                    "value": 497000,
                    "currency": "USD"
                },
                "title": "Tract 1 Black Canyon Ranch",
                "photos": [
                    {
                        "url": "https://assets.landwatch.com/resizedimages/1600/1200/l/80/1-3997906626",
                        "thumbnail_url": "https://assets.landwatch.com/resizedimages/360/240/l/80/1-3997906626"
                    }
                ],
                "status": "available",
                "address": {
                    "city": "Brackettville",
                    "state": "Texas",
                    "county": "Kinney County",
                    "street": "Leona Ranch Road",
                    "state_code": "TX",
                    "coordinates": {
                        "latitude": 29.483225,
                        "longitude": -100.37715
                    },
                    "postal_code": "78832"
                },
                "has_house": true,
                "has_video": true,
                "listed_at": "2022-01-17T11:57:55.68",
                "updated_at": "2026-08-18T14:23:20.117",
                "photo_count": 38,
                "property_id": 13118094,
                "price_change": {
                    "amount": -101000,
                    "percent": -16.89,
                    "changed_at": "2026-08-17T15:42:34.2"
                },
                "listing_level": "Signature Partner",
                "price_display": "$497,000",
                "has_custom_map": true,
                "price_per_acre": 4913.01,
                "property_types": [
                    "Farms and Ranches",
                    "Recreational Property",
                    "Hunting Property",
                    "House"
                ],
                "has_virtual_tour": false
            }
        ],
        "price_per_acre": 3986.05,
        "property_types": [
            "Recreational Property",
            "Hunting Property",
            "House"
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The place, listing or agent does not exist. This response is not billable. |
| 503 | 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
