Apartments.com Scraper API

Search US rental listings and pull unit-level inventory — not just a property’s advertised range, but every individual rentable unit with its own rent, beds, baths, square footage and availability date. Authentication and anti-bot bypass are handled automatically.

Key Features

Unit-Level Pricing

Every rentable unit with its own rent, beds, baths, sqft and availability date — not just the property’s advertised range.

Floor Plans

Each floor-plan model with its price range, bed/bath count, square footage and the units belonging to it.

Location Search

40 property cards a page, filterable by bedroom count and price. Pages 1-28.

Property Detail

Name, full address with city/state/ZIP, geo coordinates, phone, amenities, office hours and photo gallery.

No JS Rendering

apartments.com is fully server-rendered, so responses come back in ~2 seconds with no browser in the path.

Anti-Bot Bypass

apartments.com sits behind Akamai Bot Manager. ScrapeBadger clears it automatically — no proxies or CAPTCHAs to manage.

Use rent, not max_term_rent. Each unit carries both. rent is the advertised price the site shows a renter. max_term_rent is apartments.com’s raw data-maxrent attribute, which measures roughly twice the advertised rent and appears to be an upper bound across lease terms. It is exposed unparsed for completeness — do not treat it as the rent.

Coverage

Single market: apartments.com (US, USD, en-US).

Endpoints

Endpoint	Description	Credits
`GET /v1/apartments/search`	Search rentals by location, 40 cards a page	5
`GET /v1/apartments/property`	One property with floor plans and per-unit inventory	5
`GET /v1/apartments/properties/{slug}/{property_id}`	The same detail, addressed by parts	5

Every filter below was verified against live result counts. Measured on kansas-city-mo (700 properties unfiltered):

Filter	Result count
(none)	700
`beds=0` (studios)	145
`beds=1`	374
`beds=2`	490
`max_price=1500`	646
`min_price=1000&max_price=1500`	546
`beds=1&max_price=1500`	320

apartments.com also renders a pet filter, but it returns the unfiltered total, so it is deliberately not exposed — a filter that silently does nothing is worse than no filter.

Quickstart

# Search
curl -H "X-API-Key: YOUR_KEY" \
  "https://scrapebadger.com/v1/apartments/search?location=kansas-city-mo&beds=1"

# Property detail with per-unit pricing
curl -H "X-API-Key: YOUR_KEY" \
  "https://scrapebadger.com/v1/apartments/property?url=https%3A%2F%2Fwww.apartments.com%2Furbane-kansas-city-mo%2Fwcd6e5k%2F"

from scrapebadger import ScrapeBadger

async with ScrapeBadger(api_key="YOUR_KEY") as client:
    page = await client.apartments.search("kansas-city-mo", beds=1, max_price=1500)
    print(f"{page.total_results} rentals")

    prop = await client.apartments.get_property(page.results[0].url)
    for unit in prop.units:
        print(unit.unit_number, unit.rent, unit.beds, unit.sqft, unit.available_text)

import { ScrapeBadger } from "@scrapebadger/sdk";

const client = new ScrapeBadger({ apiKey: "YOUR_KEY" });

const page = await client.apartments.search("kansas-city-mo", { beds: 1, maxPrice: 1500 });
const prop = await client.apartments.getProperty(page.results[0].url!);
for (const unit of prop.units) {
  console.log(unit.unit_number, unit.rent, unit.available_text);
}

scrapebadger apartments search kansas-city-mo --beds 1 --max-price 1500 -o table
scrapebadger apartments units "https://www.apartments.com/urbane-kansas-city-mo/wcd6e5k/" -o table

Finding a location slug

location is the slug apartments.com uses in its own URLs — the segment right after the domain.

Place	Slug
Kansas City, MO	`kansas-city-mo`
New York, NY	`new-york-ny`
Austin, TX	`austin-tx`
A ZIP code	`64108`

Notes on the data

Availability is text, not a date

available_text is verbatim as rendered — "Now", "Sep 3". The site prints no year, so converting it to a timestamp would mean guessing the rollover. It is left as text deliberately.

Some properties list plans without units

A floor plan with units_available: 0 and valid beds/baths/rent/sqft is the site’s own layout for that property, not missing data. Those properties advertise plans rather than individual units.

Search cards are summaries

A search card carries a rent/bed rollup ("1 Bed", "$1,559+"), not per-unit inventory. Pass the card’s url to the property endpoint for units.

Do not use render_js on apartments.com

If you scrape apartments.com through the general Web Scraping API instead of this one, do not pass render_js: true. The whole page is server-rendered, so JS rendering only forces the slow browser path — 100+ seconds per page, which can exceed the CDN timeout and return a 524.

Overview

Search

Properties

Apartments.com Scraper Overview

Apartments.com Scraper API

Key Features

Unit-Level Pricing

Floor Plans

Location Search

Property Detail

No JS Rendering

Anti-Bot Bypass

Coverage

Endpoints

Search Filters

Quickstart

Finding a location slug

Notes on the data

​Apartments.com Scraper API

​Key Features

Unit-Level Pricing

Floor Plans

Location Search

Property Detail

No JS Rendering

Anti-Bot Bypass

​Coverage

​Endpoints

​Search Filters

​Quickstart

​Finding a location slug

​Notes on the data

Apartments.com Scraper API

Key Features

Coverage

Endpoints

Search Filters

Quickstart

Finding a location slug

Notes on the data