# Apartments.com Scraper (`scraptivo/apartments-scraper`) Actor

Scrape rental listings from apartments.com by entering location search queries. Returns property details including name, address, price, bedroom/bathroom counts, images, amenities, and contact information.

- **URL**: https://apify.com/scraptivo/apartments-scraper.md
- **Developed by:** [Scraptivo](https://apify.com/scraptivo) (community)
- **Categories:** Real estate, MCP servers, Integrations
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.97 / 1,000 apartments

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

**Apartments.com Scraper** collects rental listings from [Apartments.com](https://www.apartments.com/) and turns them into structured data for rent-market research, competitor monitoring, and lead generation. Provide a location query such as "New York, NY", run the actor, and export property names, addresses, price ranges, bedroom and bathroom counts, photos, amenities, and contact details to JSON, CSV, or Excel. Pricing starts at $1 per 1,000 listings, with detailed listing data at $3 per 1,000.

### What can you automate with Apartments.com Scraper?

- **Find rentals in any US location** — search by city, state, neighborhood, ZIP, or landmark and get matching listings as structured data.
- **Compare rent prices at scale** — capture price ranges, bed and bath counts, and square footage across thousands of properties.
- **Monitor inventory and availability** — schedule recurring runs to track which properties are listed, priced, or removed over time.
- **Enrich listings with detail data** — enable `includeListingDetails` to pull descriptions, amenity lists, photo galleries, floor plans, and property specs.
- **Feed your own stack** — push results into a CRM, spreadsheet, or analytics pipeline via the API or dataset exports.

### Who is this scraper for?

| Team | Workflow |
|---|---|
| Real-estate investors & analysts | Screen rental markets by price and unit mix before committing. |
| Property managers & landlords | Monitor competitor pricing and inventory positioning. |
| Market researchers | Build rent comps, supply maps, and pricing trends by metro. |
| Lead-generation teams | Collect property management contacts and phone numbers for outreach. |

### What data can you collect from Apartments.com?

| Data group | Example fields | How it helps |
|---|---|---|
| Listing identity | `name`, `id`, `url`, `imageUrl`, `has3DTour` | Identify and open each property. |
| Price & unit mix | `priceText`, `priceMin`, `priceMax`, `bedRangeText`, `bedsMin` | Compare rents and floor-plan options. |
| Location | `address`, `addressFull`, `latitude`, `longitude` | Map properties and filter by area. |
| Contact & management | `phone`, `managementCompany` | Reach leasing offices for outreach. |
| Amenities & source | `amenityHighlights`, `sourceQuery`, `scrapedAt` | Understand features and trace the query. |

With `includeListingDetails` enabled, records also include bathrooms, square footage, property type, year built, full amenity lists, floor plans, and photo galleries.

### How to use Apartments.com Scraper

1. Open the actor in your Apify console.
2. Enter one or more location search queries.
3. Optionally set bed, bath, and price filters or a max item count.
4. Run the actor.
5. Export the dataset to JSON, CSV, or Excel, or read it through the API.

```json
{
  "searchQueries": ["New York, NY", "Austin, TX"],
  "minBeds": 0,
  "maxBeds": 3,
  "minPrice": 1000,
  "maxPrice": 5000,
  "maxItems": 10,
  "includeListingDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

### Example workflow

#### Track rents in a target metro monthly

1. Run your target city queries on the first of each month.
2. Keep listings within your required bed and price range.
3. Compare new prices against the previous month's snapshot.
4. Deduplicate using the stable `id` or `url` field.

### Automate and integrate your results

Schedule runs from the Scheduler tab — monthly is enough for rent comps, weekly suits fast-moving inventory. Attach a webhook to trigger a downstream pipeline on completion, and export to Google Sheets, Make, Zapier, Slack, or a database. For recurring pipelines, call the actor through the Apify API:

```shell
curl -X POST "https://api.apify.com/v2/acts/scraptivo/apartments-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries": ["New York, NY"], "maxItems": 10}'
```

When merging multiple runs, deduplicate on the `id` field to keep one record per property.

### Input reference

| Field | Type | Required | Default | What it controls |
|---|---:|---|---|
| `searchQueries` | array | Yes | — | Location queries resolved via smart search. |
| `maxItems` | integer | No | `0` | Maximum listings to scrape (0 = unlimited). |
| `includeListingDetails` | boolean | No | `false` | Fetch detail pages for richer data (billed separately). |
| `minBeds` | integer | No | — | Minimum bedrooms. |
| `maxBeds` | integer | No | — | Maximum bedrooms. |
| `minBaths` | integer | No | — | Minimum bathrooms. |
| `minPrice` | integer | No | — | Minimum monthly rent (USD). |
| `maxPrice` | integer | No | — | Maximum monthly rent (USD). |
| `proxyConfiguration` | object | No | residential | Proxy settings; Apify residential is required. |

#### When should I enable `includeListingDetails`?

Enable it when you need detail-only fields like bathrooms, square footage, year built, full amenity lists, or floor plans. Detail-page fetches are billed separately at $3 per 1,000, so keep it off for high-volume rent comparisons.

### Output example

```json
{
  "id": "1234567890",
  "url": "https://www.apartments.com/the-grand-apartments/1234567890/",
  "name": "The Grand Apartments",
  "addressFull": "123 Main St, New York, NY 10001",
  "priceText": "$2,400 – $3,200",
  "priceMin": 2400,
  "priceMax": 3200,
  "bedRangeText": "1 Bed, 2 Beds",
  "bedsMin": 1,
  "has3DTour": true,
  "phone": "(212) 555-0134",
  "managementCompany": "Grand Properties",
  "amenityHighlights": ["Gym", "Pool", "Pet Friendly"],
  "imageUrl": "https://images1.apartments.com/units/1234567890/photo.jpg",
  "sourceQuery": "New York, NY",
  "scrapedAt": "2026-08-03T15:00:00.000Z"
}
```

### How much does it cost to scrape Apartments.com?

The actor bills per listing: **$1 per 1,000 listings**, with detail-page enrichment billed separately at **$3 per 1,000 detailed listings**. Apify plan discounts apply automatically — Bronze $0.99 and $2.90, Silver $0.98 and $2.80, Gold $0.97 and $2.70 per 1,000 respectively. A basic run of 1,000 listings costs $1; the same run with details enabled costs $1 plus $3 for the detail fetches. Use `maxItems` to cap output. Compute and residential proxy usage are billed separately by Apify.

### Reliability and responsible use

The actor uses Apify residential proxies (required for apartments.com) and resolves each query through smart search. Detail-only fields are conditional — they appear only when `includeListingDetails` is enabled, and individual fields can be empty when the listing does not publish them. It scrapes publicly visible rental listings only. You are responsible for complying with apartments.com's terms and applicable laws when storing or using the data.

### Frequently asked questions

#### Can I filter by bedrooms or price?

Yes. Set `minBeds`, `maxBeds`, `minBaths`, `minPrice`, and `maxPrice` to narrow results. Leave them unset to include all listings.

#### Can I schedule Apartments.com Scraper to run automatically?

Yes. Use the Scheduler tab for monthly or weekly runs, or trigger scheduled runs through the API with a cron expression.

#### What counts as one result?

Each rental listing written to the dataset is one billable result at $1 per 1,000. Detail-page fetches are a separate $3 per 1,000 when `includeListingDetails` is enabled.

#### Why are some fields empty?

Detail-only fields such as bathrooms, square footage, or year built are only populated when `includeListingDetails` is enabled, and some listings do not publish every field.

#### Do I need a proxy?

Yes. Apify residential proxies are required for apartments.com and are enabled by default.

### Related Scraptivo automations

- **[Zillow Scraper](https://apify.com/scraptivo/zillow-scraper)** — scrape Zillow listings for sale and rent.
- **[Rightmove Scraper](https://apify.com/scraptivo/rightmove-scraper)** — collect UK property listings.
- **[Redfin Scraper](https://apify.com/scraptivo/redfin-scraper)** — pull US real-estate listings from Redfin.
- **[Airbnb Scraper](https://apify.com/scraptivo/airbnb-scraper)** — gather short-term rental listings from Airbnb.

### Support and custom workflows

Need a different field, source, or delivery workflow? Contact Scraptivo at scraptivo@gmail.com. Include the Actor name, a sample location query, required fields, and expected volume so we can assess the request.

# Actor input Schema

## `searchQueries` (type: `array`):

Location search queries for apartments.com (e.g. "New York, NY", "Austin, TX", "near UCLA campus"). Each query is resolved via smart search to find matching rental listings.

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

Maximum number of rental listings to scrape (0 = unlimited)

## `includeListingDetails` (type: `boolean`):

Fetch individual listing detail pages for richer data (price, description, amenities, floor plans, images). Charged as a listing-details event.

## `minBeds` (type: `integer`):

Minimum number of bedrooms

## `maxBeds` (type: `integer`):

Maximum number of bedrooms

## `minBaths` (type: `integer`):

Minimum number of bathrooms

## `minPrice` (type: `integer`):

Minimum monthly rent (USD)

## `maxPrice` (type: `integer`):

Maximum monthly rent (USD)

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

Proxy settings for anti-bot protection. Apify Residential proxy is required for apartments.com.

## Actor input object example

```json
{
  "searchQueries": [
    "New York, NY",
    "Austin, TX"
  ],
  "maxItems": 10,
  "includeListingDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing scraped rental listings from apartments.com

## `kvsRecords` (type: `string`):

Key-value store records produced by the Actor

# 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 = {
    "searchQueries": [
        "New York, NY",
        "Austin, TX"
    ],
    "maxItems": 10,
    "includeListingDetails": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraptivo/apartments-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 = {
    "searchQueries": [
        "New York, NY",
        "Austin, TX",
    ],
    "maxItems": 10,
    "includeListingDetails": False,
}

# Run the Actor and wait for it to finish
run = client.actor("scraptivo/apartments-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "New York, NY",
    "Austin, TX"
  ],
  "maxItems": 10,
  "includeListingDetails": false
}' |
apify call scraptivo/apartments-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraptivo/apartments-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Jns5BtbVwQf4BfnqK/builds/qYi6DUJGcRZzQ4Ery/openapi.json