# RentCafe City Apartment Price & Amenity Finder (`dataspryva/rentcafe-city-apartment-price-and-amenity-finder`) Actor

Search RentCafe.com apartment listings for a US city by bedroom count, price tier or amenity, returning address, coordinates, pricing by unit type, rating and management company per property.

- **URL**: https://apify.com/dataspryva/rentcafe-city-apartment-price-and-amenity-finder.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

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

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## RentCafe City Apartment Price & Amenity Finder

RentCafe.com lists apartment communities across the US with per-unit-type pricing, full amenity lists, star ratings, phone numbers and management-company contacts. This actor searches a city — or a set of saved RentCafe search URLs — and returns each community as a structured record for rent comparison, market research or a property-management lead list.

### What this actor does

- Searches any US city RentCafe recognises by its URL slug, or accepts full RentCafe city search URLs
- Uses RentCafe's own server-side filters: bedrooms, bathrooms, rent range, minimum rating, pet policy, amenity, property type, rent specials and move-in date
- Orders results with RentCafe's own sort: best match, price low/high, rating high, newest, or 3D-tour listings
- Paginates until your `maxItems` is reached or RentCafe's public result list ends
- Merges the visible result card with RentCafe's schema.org JSON-LD so each record carries both per-unit prices and the full amenity/contact data
- Omits empty fields — a field appears only when RentCafe published real data for that community

### Output per community

- `propertyId`, `name`, `url` — RentCafe's community ID, name and listing URL
- `street`, `city`, `state`, `zip`, `fullAddress`
- `latitude`, `longitude`
- `telephone` — leasing phone number from the listing's structured data
- `rating`, `reviewCount` — star rating and number of reviews
- `bedPricePairs` — array of `{beds, startingPrice}` for every unit type advertised
- `minPrice`, `maxPrice` — lowest and highest starting price across unit types
- `minBeds`, `maxBeds` — smallest and largest advertised bedroom count
- `amenities` — full amenity list from the listing's structured data
- `amenitySummary` — the shorter amenity line shown on the result card
- `priceCurrency`, `availability`
- `badges` — promo tags such as "Rent specials" or "New Units Available"
- `verifiedListing` — `true` when RentCafe marks the listing as verified
- `photoUrl` — full-size listing photo
- `managementCompany` — property management company, when shown
- `locationSlug` — the normalized city slug used for the search
- `filterApplied` — the path filter segment used for this run, if any
- `scrapedAt` — UTC timestamp when the record was collected

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | select | `city` | `City search` builds a search from `location`; `Search URLs` scrapes the RentCafe search URLs in `searchUrls` |
| `location` | string | – | City as it appears on RentCafe, e.g. `austin-tx`, `Austin, TX`, or `new-york-city-ny`; a full RentCafe city search URL also works. Required in city mode |
| `searchUrls` | array | – | RentCafe city search URLs, e.g. `https://www.rentcafe.com/apartments-for-rent/austin-tx/pet-friendly/`. Required in URL mode |
| `beds` | select | Any | Studio, 1, 2, 3 or 4+ bedrooms |
| `bathrooms` | select | Any | 1, 2 or 3+ bathrooms |
| `petPolicy` | select | Any | Pet friendly, cats, dogs, or no pets |
| `amenity` | select | Any | One amenity from RentCafe's 21-option amenity filter (pool, garage, washer/dryer, …) |
| `propertyType` | select | Any | Apartment, condo, home, townhouse, student or affordable |
| `minPrice` / `maxPrice` | integer | – | Monthly rent range, applied by RentCafe and re-checked on each record |
| `minRating` | integer | – | Drop communities rated below this (0–5). 3–5 is also sent to RentCafe's rating filter |
| `rentSpecialsOnly` | boolean | `false` | Only communities currently advertising a rent special |
| `moveInDate` | string | – | Optional `YYYY-MM-DD` move-in date |
| `sort` | select | Best match | Best match, price low/high, rating high, newest or 3D tour |
| `maxItems` | integer | `25` | Maximum communities to return (1–2000) |

#### Example: 2-bedroom, pet-friendly Austin communities with a pool, rated 4+, $1,000–$2,500

```json
{
  "mode": "city",
  "location": "austin-tx",
  "beds": "2",
  "petPolicy": "pet-friendly",
  "amenity": "c24",
  "minPrice": 1000,
  "maxPrice": 2500,
  "minRating": 4,
  "sort": "price-low",
  "maxItems": 40
}
```

#### Example: scrape two saved RentCafe searches

```json
{
  "mode": "urls",
  "searchUrls": [
    "https://www.rentcafe.com/apartments-for-rent/austin-tx/pet-friendly/?Beds=Two",
    "https://www.rentcafe.com/apartments-for-rent/austin-tx/under-1000/"
  ],
  "maxItems": 100
}
```

### Use cases

- **Rent comparison** — pull every community in a city for a bedroom count and compare starting prices side by side
- **Lease shopping** — narrow by rent range, pet policy, pool, garage or fitness center before you start calling
- **Property-management leads** — collect community names, phone numbers and management companies across a city
- **Market research** — track community-level `minPrice`/`maxPrice` and amenity coverage over time
- **Saved-search automation** — paste an existing RentCafe search URL and turn it into a daily dataset

### FAQ

**How do I find the city slug?** The path segment right after `/apartments-for-rent/` on RentCafe.com is the slug (e.g. `rentcafe.com/apartments-for-rent/austin-tx/` → `austin-tx`). You can also type `City, ST` or paste the full search URL.

**Can I combine filters?** Yes. The new filters use RentCafe's own server-side parameters and combine with each other. The old single path-segment filters still work for saved tasks, but the filter fields in the input form are the supported way to stack several conditions.

**Do I need a login or proxy?** No. The listing pages are public and the actor needs no account, API key or proxy setup. It picks the network route it needs automatically.

**Why are there fewer records than the "Rentals Available" number?** RentCafe's public city search paginates *communities* (usually 25 per page), while its rental count includes individual units/floor plans. The actor returns communities and tells you in the status message when the public result list is exhausted.

**Why does a listing URL return 403 to curl?** RentCafe blocks some non-browser requests to property pages. The URLs are valid and open normally in a browser; photos and the dataset fields are unaffected.

**Why do some communities have no price or rating?** RentCafe only shows what each property manager supplied. A community can be listed with "contact for pricing" and no reviews yet; those fields are omitted rather than filled with a guess.

**Is this affiliated with RentCafe?** No. This is an independent actor that reads RentCafe's publicly available listing pages; it is not operated by or affiliated with RentCafe/Yardi.

# Actor input Schema

## `mode` (type: `string`):

`City search` builds a RentCafe search from a city and the filters below. `Search URLs` scrapes one or more existing RentCafe city search URLs and applies any filters you set on top of each URL.

## `location` (type: `string`):

A US city as it appears on RentCafe, e.g. `austin-tx`, `Austin, TX`, or `new-york-city-ny`; spaces and commas are converted to the RentCafe URL slug. A full RentCafe city search URL is also accepted. Required in `City search` mode.

## `searchUrls` (type: `array`):

One or more RentCafe city search URLs, e.g. `https://www.rentcafe.com/apartments-for-rent/austin-tx/pet-friendly/`. Required in `Search URLs` mode. Each URL's own path filter and supported query parameters are honoured; filters below override matching URL parameters.

## `beds` (type: `string`):

RentCafe's own bedroom filter. `Studio` matches studios; `4+` matches four or more bedrooms.

## `bathrooms` (type: `string`):

Minimum bathroom count.

## `petPolicy` (type: `string`):

RentCafe pet-policy filter.

## `amenity` (type: `string`):

One apartment amenity that every returned community must offer, using RentCafe's own amenity filter.

## `propertyType` (type: `string`):

RentCafe property-type filter.

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

Only include communities with a unit at or above this monthly rent. Uses RentCafe's own price filter, and the record is re-checked after parsing.

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

Only include communities with a unit at or below this monthly rent. Uses RentCafe's own price filter, and the record is re-checked after parsing.

## `minRating` (type: `integer`):

Drop communities rated below this. Whole numbers from 3 to 5 are also sent to RentCafe's rating filter; other values are applied to the returned records.

## `rentSpecialsOnly` (type: `boolean`):

Only include communities currently advertising a rent special.

## `moveInDate` (type: `string`):

Optional move-in date in `YYYY-MM-DD` format; RentCafe returns communities with availability around that date.

## `sort` (type: `string`):

Result order applied by RentCafe.

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

Hard cap on emitted communities. RentCafe's public city search paginates its own community results, usually 25 per page; the status message reports when the source ceiling is reached.

## Actor input object example

```json
{
  "mode": "city",
  "location": "austin-tx",
  "beds": "",
  "bathrooms": "",
  "petPolicy": "",
  "amenity": "",
  "propertyType": "",
  "rentSpecialsOnly": false,
  "sort": "",
  "maxItems": 25
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset containing all scraped RentCafe apartment listings.

# 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 = {
    "mode": "city",
    "location": "austin-tx",
    "rentSpecialsOnly": false,
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/rentcafe-city-apartment-price-and-amenity-finder").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 = {
    "mode": "city",
    "location": "austin-tx",
    "rentSpecialsOnly": False,
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/rentcafe-city-apartment-price-and-amenity-finder").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 '{
  "mode": "city",
  "location": "austin-tx",
  "rentSpecialsOnly": false,
  "maxItems": 25
}' |
apify call dataspryva/rentcafe-city-apartment-price-and-amenity-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/rentcafe-city-apartment-price-and-amenity-finder"
        }
    }
}
```

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/XpiLX4GSxGTLKWBRb/builds/FGTHoolTbKU4tvQjP/openapi.json
