# Land.com Scraper (`memo23/land-search-cheerio`)

Unlock the full potential of Land.com with this powerful scraper! Efficiently extract detailed property listings, including prices, acreage, media, and descriptions, to save time and make data-driven decisions. Perfect for real estate pros, investors, and researchers!

- **URL**: https://beta-securitybyobscurity.apify.com/memo23/land-search-cheerio.md
- **Developed by:** [Muhamed Didovic](https://beta-securitybyobscurity.apify.com/memo23) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 28 total users, 5 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

$27.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

### Overview

The **Land.com Scraper** is a highly effective tool designed to extract comprehensive property listings from [Land.com](https://www.land.com/). Whether you're a real estate investor, researcher, or developer, this scraper provides detailed data to help you analyze and evaluate land opportunities efficiently.

***

### Features

- **Customizable Input Parameters**:
  - Start scraping from specific URLs.
  - Limit the number of listings to scrape per session.

- **Efficient Data Extraction**:
  - Handles pagination to ensure all listings are captured.
  - Automatically retries failed requests for seamless scraping.

- **Proxy Integration**:
  - Supports proxies to ensure anonymity and reliability.

- **Detailed Data Output**:
  - Extracts property details such as location, price, acreage, description, amenities, and contact information.

***

### How to Use

1. **Set Up**: Ensure you have an Apify account and access to the Apify platform.
2. **Provide Input Data**: Input specific scraping parameters, such as start URLs and maximum items to scrape.
3. **Adjust Scraper Settings**: Configure settings like `maxConcurrency`, `minConcurrency`, and `maxRequestRetries` to optimize performance.
4. **Run the Scraper**: Execute the scraper on the Apify platform.
5. **Download Results**: Export the scraped data in your preferred format (JSON, CSV, Excel).

***

### Input Configuration

To use the scraper, configure the input parameters as follows:

```json
{
    "startUrls": [
        {
            "url": "https://www.land.com/Florida/beachfront-property/"
        }
    ],
    "maxItems": 100,
    "maxConcurrency": 10,
    "minConcurrency": 1,
    "maxRequestRetries": 100,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}
```

#### Input Fields Explanation

- **Start URLs** (`startUrls`): The URLs from which the scraper will begin extracting data.
  - Example: `https://www.land.com/Florida/beachfront-property/`.
- **Max Items** (`maxItems`): Maximum number of listings to scrape per run. Default is `100`.
- **Max Concurrency** (`maxConcurrency`): Maximum number of pages processed simultaneously. Default is `10`.
- **Min Concurrency** (`minConcurrency`): Minimum number of pages processed simultaneously. Default is `1`.
- **Max Request Retries** (`maxRequestRetries`): Number of retries for failed requests. Default is `100`.
- **Proxy Configuration** (`proxy`): Settings for reliable and anonymous scraping. Default uses Apify's Residential Proxy.

***

### Output Structure

The scraper produces a structured JSON output containing detailed information for each property listing. Below is an example of the output with an explanation of the fields:

```json
{
    "accountId": 3979147,
    "acres": 60.34,
    "address": {
        "address1": "438 NE English Ivy Trail",
        "address2": "",
        "city": "Pinetta",
        "state": 12,
        "stateAbbreviation": "FL",
        "stateName": "Florida",
        "zip": "32350"
    },
    "adTargetingPta": "farms",
    "areaLabel": "60.34 acres",
    "attachments": [
        {
            "caption": "Aerial Map",
            "docsPath": "https://files.realstack.com/uploads/.../RcjXEv4lKQ7zBkbc.pdf",
            "documentId": 5342762325,
            "documentTypeId": 20,
            "filename": "RcjXEv4lKQ7zBkbc.pdf",
            "isExternal": true,
            "uploadedAccountFileId": 0,
            "uploadedPropertyFileId": 2566093,
            "url": "https://files.realstack.com/uploads/.../RcjXEv4lKQ7zBkbc.pdf"
        }
    ],
    "auctionAddress": null,
    "auctionCity": null,
    "auctionDate": "01/01/0001, 12:00 AM",
    "auctionId": null,
    "auctionState": "UNDEFINED",
    "auctionTitle": null,
    "auctionUrl": null,
    "baths": 1,
    "beds": 1,
    "breadcrumbSchema": "{\"@context\":\"https://schema.org\",\"@type\":\"BreadcrumbList\"}",
    "canDisplay": false,
    "canonicalUrl": "/property/438-NE-English-Ivy-Trail-Pinetta-Florida-32350/20571851/",
    "city": {
        "id": 21021,
        "countyId": 6194,
        "name": "Pinetta",
        "latitude": 30.5941,
        "longitude": -83.35237
    },
    "county": {
        "id": 6194,
        "fips": 12079,
        "name": "Madison County"
    },
    "description": [
        "Situated on beautiful rolling topography..."
    ],
    "externalLink": "https://www.mossyoakproperties.com/property...",
    "halfBaths": 0,
    "homesqft": 896,
    "imageDocumentIds": [5342842217, 5342842249],
    "imageInfo": [
        {
            "documentId": 5342842217,
            "height": 960,
            "width": 1280,
            "label": "Main Photo"
        }
    ],
    "isDiamond": false,
    "isGold": true,
    "isResidence": true,
    "latitude": 30.576742,
    "listingDate": "2024-06-04",
    "listingId": 20571851,
    "price": 1275000,
    "title": "60 Acre Homestead/Hobby Farm",
    "types": ["Farms", "Residential Property"],
    "state": {
        "stateId": 12,
        "stateAbbreviation": "FL",
        "stateName": "Florida"
    }
}
```

#### Field Descriptions

##### General Information

- **accountId**: Unique identifier for the account managing the listing.
- **acres**: Total size of the property in acres.
- **address**: Property address details.
  - **address1**: Street address.
  - **city**: City of the property.
  - **stateAbbreviation**: State abbreviation.
  - **stateName**: Full state name.
  - **zip**: ZIP code.
- **price**: Property listing price.
- **title**: Title of the listing.
- **types**: Categories of the property (e.g., Farms, Residential Property).

##### Media and Documents

- **attachments**: Related documents and media for the property.
  - **caption**: Description of the attachment.
  - **url**: Link to the attachment.
- **imageInfo**: Array of images related to the property.
  - **label**: Description of the image.
  - **url**: Image URL.

##### Additional Details

- **beds**: Number of bedrooms.
- **baths**: Number of bathrooms.
- **halfBaths**: Number of half bathrooms.
- **latitude/longitude**: Geolocation of the property.
- **listingDate**: Date when the listing was created.

***

### Benefits of the Land.com Scraper

- Automates property data collection, saving hours of manual work.
- Provides detailed, accurate, and structured data for analysis.
- Customizable input options for targeted scraping.
- Reliable performance with proxy integration for anonymity.

***

### Why Choose the Land.com Scraper?

## The Land.com Scraper is an indispensable tool for real estate professionals, developers, and investors. It streamlines property research by delivering high-quality, actionable data directly from Land.com, enabling better decision-making and saving time.

### Explore More Scrapers

If you found the Virtuals.io Scraper useful, check out other powerful scrapers and actors at [memo23's Apify profile](https://apify.com/memo23). We offer a wide range of tools to enhance your web scraping and automation needs.

***

### Support

- For issues or feature requests, please use the [Issues](https://console.apify.com/actors/ftbw0YFo17iTQ2qjv/issues) section of this actor.
- For further assistance, contact the author:
  - Author's website: <https://muhamed-didovic.github.io/>
  - Email: <muhamed.didovic@gmail.com>

***

### Additional Services

- Request customization or a full dataset: <muhamed.didovic@gmail.com>
- Need other platforms scraped? Contact <muhamed.didovic@gmail.com>
- For API services of this scraper, reach out to <muhamed.didovic@gmail.com>

# Actor input Schema

## `startUrls` (type: `array`):

URLs to start with.

## `maxItems` (type: `integer`):

Maximum number of Listings/Items to scrape per crawl. If not defined, all items will be scraped.

## `downloadImages` (type: `boolean`):

Set to true if you want to download images to Apify's Key-Value Store so you can download them to your computer

## `maxImages` (type: `integer`):

Maximum number of images to download per listing.

## `storeName` (type: `string`):

Rule for naming: it can only contain letters 'a' through 'z', the digits '0' through '9', and the hyphen ('-') but only in the middle of the string (e.g. 'my-value-1')
Assign a custom name to the Key-Value Store where your scraped listings will be saved. This ensures:

1. **Persistent Storage**: Enables long-term retention of listings, beyond default storage limits.
2. **Project Management**: Separate datasets by using unique names for different projects or analyses.
3. **Data Reuse**: Easily reference and reuse stored data without overwriting.
   (If left blank, the default storage will be used with standard retention limits.)

## `maxConcurrency` (type: `integer`):

Maximum number of pages that can be processed at the same time.

## `minConcurrency` (type: `integer`):

Minimum number of pages that will be processed at the same time.

## `maxRequestRetries` (type: `integer`):

Number of times the crawler will retry a failed request before giving up.

## `proxy` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.<br><br>For details, see <a href='https://apify.com/apify/web-scraper#proxy-configuration' target='_blank' rel='noopener'>Proxy configuration</a> in README.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.land.com/Florida/beachfront-property/"
    }
  ],
  "maxItems": 100,
  "downloadImages": false,
  "maxImages": 10,
  "maxConcurrency": 10,
  "minConcurrency": 1,
  "maxRequestRetries": 100,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.land.com/Florida/beachfront-property/"
        }
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/land-search-cheerio").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.land.com/Florida/beachfront-property/" }],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("memo23/land-search-cheerio").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.land.com/Florida/beachfront-property/"
    }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call memo23/land-search-cheerio --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=memo23/land-search-cheerio",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Land.com Scraper",
        "description": "Unlock the full potential of Land.com with this powerful scraper! Efficiently extract detailed property listings, including prices, acreage, media, and descriptions, to save time and make data-driven decisions. Perfect for real estate pros, investors, and researchers!",
        "version": "0.0",
        "x-build-id": "dpYBIibBakXZsbut2"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/memo23~land-search-cheerio/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-memo23-land-search-cheerio",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/memo23~land-search-cheerio/runs": {
            "post": {
                "operationId": "runs-sync-memo23-land-search-cheerio",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/memo23~land-search-cheerio/run-sync": {
            "post": {
                "operationId": "run-sync-memo23-land-search-cheerio",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "URLs to start with.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxItems": {
                        "title": "Max Listings/Items to scrape per crawl",
                        "type": "integer",
                        "description": "Maximum number of Listings/Items to scrape per crawl. If not defined, all items will be scraped.",
                        "default": 100
                    },
                    "downloadImages": {
                        "title": "Download images (Images will be stored inside Key-Value Store)",
                        "type": "boolean",
                        "description": "Set to true if you want to download images to Apify's Key-Value Store so you can download them to your computer",
                        "default": false
                    },
                    "maxImages": {
                        "title": "Max images per listing (Only applicable if 'Download images' is enabled)",
                        "type": "integer",
                        "description": "Maximum number of images to download per listing.",
                        "default": 10
                    },
                    "storeName": {
                        "title": "Name your storage for listings (long-term retention)",
                        "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
                        "type": "string",
                        "description": "Rule for naming: it can only contain letters 'a' through 'z', the digits '0' through '9', and the hyphen ('-') but only in the middle of the string (e.g. 'my-value-1')\n Assign a custom name to the Key-Value Store where your scraped listings will be saved. This ensures:\n 1. **Persistent Storage**: Enables long-term retention of listings, beyond default storage limits.\n 3. **Project Management**: Separate datasets by using unique names for different projects or analyses.\n 4. **Data Reuse**: Easily reference and reuse stored data without overwriting.\n (If left blank, the default storage will be used with standard retention limits.)"
                    },
                    "maxConcurrency": {
                        "title": "Max Concurrency",
                        "type": "integer",
                        "description": "Maximum number of pages that can be processed at the same time.",
                        "default": 10
                    },
                    "minConcurrency": {
                        "title": "Min Concurrency",
                        "type": "integer",
                        "description": "Minimum number of pages that will be processed at the same time.",
                        "default": 1
                    },
                    "maxRequestRetries": {
                        "title": "Max Request Retries",
                        "type": "integer",
                        "description": "Number of times the crawler will retry a failed request before giving up.",
                        "default": 100
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.<br><br>For details, see <a href='https://apify.com/apify/web-scraper#proxy-configuration' target='_blank' rel='noopener'>Proxy configuration</a> in README.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
