Skip to content
Scrappa Get API key
LandSearch API 1 credit/request

LandSearch Search API Documentation

GET https://scrappa.co/api/landsearch/search

LandSearch Search API returns US land listings for sale, lease and auction. Pick a place with the autocomplete route and pass its slug as location, then filter by format, price, acreage, price per acre, building, bedrooms, bathrooms, building size, tag, type and status. Each item carries the price in USD, acreage, address parts, coordinates, building facts, photo links, image counts and the listing source. A lease item carries lease_period; the price is per period. An auction price is the minimum bid. pagination holds the real total and page count. Every item satisfies the filters you sent. An unknown location answers 422. Failed requests are not billed.

LandSearch Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/landsearch/search
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "items": [
            {
                "id": 5645044,
                "geo": {
                    "latitude": 30.394722,
                    "longitude": -97.8643,
                    "precision": "high"
                },
                "url": "https://www.landsearch.com/properties/6111-n-fm-620-rnch-austin-tx-78732/5645044",
                "price": 1274990,
                "title": "1.85 Acres of Commercial Land for Sale in Austin, Texas",
                "format": "sale",
...

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.

21 optional filters available.

location string Optional

Location slug from the autocomplete route, for example texas, travis-county-tx or austin-tx. Without it the search covers the whole US.

Example value Austin, Texas
format string Optional

sale, lease or auction. Without it all formats are returned.

Example value example
type string Optional

Site category: residential, commercial, agricultural or recreational. The category is computed by the site and is not the same as the listing attribute Type.

Example value example
tag string Optional

One feature tag slug, for example hunting, lakefront, cabin, water-well, fenced or off-grid.

Example value example
status string Optional

pending lists only pending listings.

Example value example
keywords string Optional

Free text such as an MLS id, pool or utilities.

Example value running shoes
structure boolean Optional

true for land with a building, false for vacant land.

Example value true
price_min integer Optional

Minimum price in USD. For a lease the price is per lease period.

Example value 10
price_max integer Optional

Maximum price in USD.

Example value 10
size_min number Optional

Minimum size in acres.

Example value 10
size_max number Optional

Maximum size in acres.

Example value 10
ppa_min integer Optional

Minimum price per acre in USD.

Example value 10
ppa_max integer Optional

Maximum price per acre in USD.

Example value 10
bedrooms_min integer Optional

Minimum bedrooms.

Example value 10
bedrooms_max integer Optional

Maximum bedrooms.

Example value 10
bathrooms_min integer Optional

Minimum bathrooms.

Example value 10
space_min integer Optional

Minimum building size in square feet.

Example value 10
space_max integer Optional

Maximum building size in square feet.

Example value 10
sort string Optional

-promoted, -newest, -price, price, -size, size or -updated. A leading minus means descending.

Example value relevance
page integer Optional

One-based page number. The site reports at most 100 pages per query; a page past the last returns an empty list.

Example value 1
limit integer Optional

Results per page, 1 to 100. Default 50.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "items": [
            {
                "id": 5645044,
                "geo": {
                    "latitude": 30.394722,
                    "longitude": -97.8643,
                    "precision": "high"
                },
                "url": "https://www.landsearch.com/properties/6111-n-fm-620-rnch-austin-tx-78732/5645044",
                "price": 1274990,
                "title": "1.85 Acres of Commercial Land for Sale in Austin, Texas",
                "format": "sale",
                "source": "listhub",
                "status": "active",
                "location": {
                    "state": "Texas",
                    "county": "Travis",
                    "region": null,
                    "address": null,
                    "country": null,
                    "locality": "Austin",
                    "state_code": "TX",
                    "state_slug": "texas",
                    "county_slug": "travis-county-tx",
                    "postal_code": "78732",
                    "locality_slug": "austin-tx"
                },
                "promoted": false,
                "image_url": "https://cdn.landsearch.com/listings/4Xtpr/small/austin-tx-182554942.jpg",
                "listed_at": "2026-10-25T00:00:00Z",
                "structure": {
                    "bedrooms": null,
                    "bathrooms": null,
                    "space_sqft": null,
                    "has_building": true
                },
                "size_acres": 1.849,
                "lease_period": null,
                "total_images": 40,
                "total_videos": 0,
                "image_url_large": "https://cdn.landsearch.com/listings/4Xtpr/large/austin-tx-182554942.jpg"
            },
            {
                "id": 5644664,
                "geo": {
                    "latitude": 30.276938,
                    "longitude": -97.701112,
                    "precision": "high"
                },
                "url": "https://www.landsearch.com/properties/3116-e-12th-st-austin-tx-78702/5644664",
                "price": 265000,
                "title": "0.12 Acres of Residential Land for Sale in Austin, Texas",
                "format": "sale",
                "source": "listhub",
                "status": "active",
                "location": {
                    "state": "Texas",
                    "county": "Travis",
                    "region": null,
                    "address": null,
                    "country": null,
                    "locality": "Austin",
                    "state_code": "TX",
                    "state_slug": "texas",
                    "county_slug": "travis-county-tx",
                    "postal_code": "78702",
                    "locality_slug": "austin-tx"
                },
                "promoted": false,
                "image_url": "https://cdn.landsearch.com/listings/4Xtdw/small/austin-tx-182541321.jpg",
                "listed_at": "2026-10-24T00:00:00Z",
                "structure": {
                    "bedrooms": null,
                    "bathrooms": null,
                    "space_sqft": null,
                    "has_building": false
                },
                "size_acres": 0.115,
                "lease_period": null,
                "total_images": 5,
                "total_videos": 0,
                "image_url_large": "https://cdn.landsearch.com/listings/4Xtdw/large/austin-tx-182541321.jpg"
            },
            {
                "id": 5642783,
                "geo": {
                    "latitude": 30.347471,
                    "longitude": -97.559029,
                    "precision": "high"
                },
                "url": "https://www.landsearch.com/properties/307-w-lane-ave-manor-tx-78653/5642783",
                "price": 125000,
                "title": "0.13 Acres of Land for Sale in Manor, Texas",
                "format": "sale",
                "source": "listhub",
                "status": "active",
                "location": {
                    "state": "Texas",
                    "county": "Travis",
                    "region": null,
                    "address": null,
                    "country": null,
                    "locality": "Manor",
                    "state_code": "TX",
                    "state_slug": "texas",
                    "county_slug": "travis-county-tx",
                    "postal_code": "78653",
                    "locality_slug": "manor-tx"
                },
                "promoted": false,
                "image_url": "https://cdn.landsearch.com/listings/4Xsqk/small/manor-tx-182473924.jpg",
                "listed_at": "2026-10-23T00:00:00Z",
                "structure": {
                    "bedrooms": null,
                    "bathrooms": null,
                    "space_sqft": null,
                    "has_building": false
                },
                "size_acres": 0.132,
                "lease_period": null,
                "total_images": 8,
                "total_videos": 0,
                "image_url_large": "https://cdn.landsearch.com/listings/4Xsqk/large/manor-tx-182473924.jpg"
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 3,
            "total": 300,
            "has_next": true,
            "returned": 3,
            "total_pages": 100
        },
        "applied_filters": {
            "sort": "-newest",
            "location": "travis-county-tx",
            "price_max": 2000000
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "page": [
            "The page field must be at least 1."
        ]
    },
    "message": "The request validation failed"
}
422

Unknown Location

The location slug is unknown. Use the autocomplete route. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "search"
    },
    "error": {
        "code": "VALIDATION_ERROR",
        "message": "The location was not found. Use the autocomplete route to find a valid location slug."
    },
    "success": false
}
503

Upstream Unavailable

LandSearch could not be reached. Retry shortly. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "LandSearch 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.