# Point2homes Scraper (`getdataforme/point2homes-scraper`) Actor

The Point2Homes Scraper is a web crawler that extracts real estate listings from Point2Homes. It gathers key details like price, location, size, bedrooms, bathrooms, and listing status. The scraper handles pagination and dynamic content, providing up-to-date, accurate insights.

- **URL**: https://apify.com/getdataforme/point2homes-scraper.md
- **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community)
- **Categories:** Real estate
- **Stats:** 7 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$35.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Point2Homes Scraper

Search and Extract Unlimited Point2Homes Apartment Listings. Point2Homes Scraper allows you to effortlessly extract apartment data from the Point2Homes platform, including property details, pricing, neighborhood information, and more.

`Note: Please activate Proxy to get the result without blockage.`  
Running without a proxy may lead to blocked data extraction.

### How the Point2Homes Scraper works
- Rent the Point2Homes Scraper and you will get a 2-hour free trial to test the actor and check if it meets your needs.
- Enter the URL of the property listing in the input field. This allows you to extract data from the specific apartment listing you are interested in.
- The output will provide detailed information, including apartment price, square footage, agent details, property description, and other relevant data.

#### Input Format
```json
{
    "proxyConfiguration": {
        "useApifyProxy": true
    },
    "urls": [
        "https://www.point2homes.com/US/Apartment-Buildings/CA/Pasadena/City-Place-1-0.html"
    ]
}
````

#### Point2Homes Scraper Output Result Sample

Once the scraper runs successfully, you will get the following result with the extracted apartment listing details:

```json
[
    {
        "title": [
            "City Place - apartments for rent in Playhouse District, Pasadena | Point2Homes"
        ],
        "property_type": "Apartment",
        "price": "From $2,984 /mo",
        "bedrooms": "1-3 beds",
        "bathrooms": "1-2 baths",
        "square_footage": "681-1,265 sqft",
        "year_built": "2001",
        "street_address": "801 E. Walnut Street",
        "city": "Pasadena",
        "state": "CA",
        "zip_code": "91101",
        "neighborhood": "Playhouse District",
        "image_urls": [
            "https://cdngeneral.point2homes.com/dmslivecafe/2/102601/CityPlace6(3).jpg?width=590&quality=80",
            "https://cdngeneral.point2homes.com/dmslivecafe/2/102601/CityPlace1(3).jpg?width=290&quality=80",
            "https://cdngeneral.point2homes.com/dmslivecafe/2/102601/CityPlace6(2).jpg?width=290&quality=80",
            "https://cdngeneral.point2homes.com/dmslivecafe/2/102601/CityPlace4(4).jpg?width=290&quality=80",
            "https://cdngeneral.point2homes.com/dmslivecafe/2/102601/CityPlace15(3).jpg?width=290&quality=80"
        ],
        "listing_agency_name": "Greystar Real Estate Partners, LLC",
        "listing_agency_phone": "(877) 298-1557",
        "listing_agency_website": "https://www.liveatcityplace.com/?rcstdid=MzA%3d-PnQFQsUfwuo%3d",
        "description": "Our exceptional apartment community offers desirable amenities, including a resort-inspired pool and state-of-the-art fitness center. Within a short distance to the Playhouse District, endless discoveries await at the Pasadena Playhouse, Civic Auditorium and Rose Bowl nearby. Visit City Place Apartments today to indulge yourself in the finest style of luxury living in Pasadena.",
        "property_status": "Active",
        "walkscore": "92",
        "nearby_schools": [
            "Pasadena Montessori School",
            "Yattiyr ISEE Christian School",
            "St. Andrew Elementary School",
            "Lycée International de Los Angeles - Pasadena campus",
            "International School of Los Angeles-Pas",
            "Oak Knoll Montessori School",
            "Waverly School, The",
            "Our School",
            "Lindamood-Bell Learning Processes Pasadena",
            "Lake Avenue Church School",
            "McKinley School",
            "Pasadena Montessori School",
            "Madison Elementary School",
            "Yattiyr ISEE Christian School",
            "St Phillip The Apostle",
            "St. Philip The Apostle",
            "Lindamood-Bell Learning Processes Pasadena",
            "Fusion Academy Pasadena - Downtown",
            "Future Academy Pasadena",
            "Futures Academy",
            "McKinley School",
            "Yattiyr ISEE Christian School",
            "St Phillip The Apostle",
            "St. Philip The Apostle",
            "Lindamood-Bell Learning Processes Pasadena",
            "Fusion Academy Pasadena - Downtown",
            "Future Academy Pasadena",
            "Futures Academy",
            "Rose City High (Continuation) School",
            "The Peace & Justice Academy",
            "Polytechnic School",
            "Polytechnic School"
        ]
    }
]
```

#### Output Fields Explanation:

- `title`: Title of the apartment listing.
- `property_type`: Type of property (e.g., Apartment).
- `price`: Rent price details (e.g., "From $2,984 /mo").
- `bedrooms`: Number of bedrooms in the apartment.
- `bathrooms`: Number of bathrooms in the apartment.
- `square_footage`: Square footage range for the apartment.
- `year_built`: Year the apartment complex was built.
- `street_address`, `city`, `state`, `zip_code`: Address details of the property.
- `neighborhood`: Name of the neighborhood the apartment is located in.
- `image_urls`: Links to images of the property.
- `listing_agency_name`: Name of the agency listing the apartment.
- `listing_agency_phone`: Contact phone number for the agency.
- `listing_agency_website`: Link to the agency's website.
- `description`: Description of the apartment and its features.
- `property_status`: The current status of the property (e.g., Active).
- `walkscore`: Walkability score for the property.
- `nearby_schools`: List of nearby schools in the area.

#### Support

For more custom outputs or bug reports, please contact us at support@getdataforme.com or report an issue. You can easily reach out to us here: [Contact Us](https://getdataforme.com/contact/)

Please remember to include an email subject and specific details about your custom support request.

Thank you!

# Actor input Schema

## `urls` (type: `array`):

A list of URLs of the web pages you want to scrape data from.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "urls": [
    "https://www.point2homes.com/US/Apartment-Buildings/CA/Pasadena/City-Place-1-0.html"
  ],
  "proxyConfiguration": {
    "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 = {
    "urls": [
        "https://www.point2homes.com/US/Apartment-Buildings/CA/Pasadena/City-Place-1-0.html"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/point2homes-scraper").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 = {
    "urls": ["https://www.point2homes.com/US/Apartment-Buildings/CA/Pasadena/City-Place-1-0.html"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/point2homes-scraper").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 '{
  "urls": [
    "https://www.point2homes.com/US/Apartment-Buildings/CA/Pasadena/City-Place-1-0.html"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getdataforme/point2homes-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Point2homes Scraper",
        "description": "The Point2Homes Scraper is a web crawler that extracts real estate listings from Point2Homes. It gathers key details like price, location, size, bedrooms, bathrooms, and listing status. The scraper handles pagination and dynamic content, providing up-to-date, accurate insights.",
        "version": "0.0",
        "x-build-id": "KOdN9CJB3pfOIi6mB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~point2homes-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-point2homes-scraper",
                "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/getdataforme~point2homes-scraper/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-point2homes-scraper",
                "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/getdataforme~point2homes-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-point2homes-scraper",
                "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": [
                    "urls"
                ],
                "properties": {
                    "urls": {
                        "title": "List of URLs of the Point2Homes pages",
                        "type": "array",
                        "description": "A list of URLs of the web pages you want to scrape data from.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
