Apartments.com Rental Listing & Floor Plan Scraper

Search Apartments.com rentals by city, bedroom count, price, property type, pet policy, and amenities, or scrape specific listing URLs directly. Returns rent ranges, per-unit floor plans, walkability scores, amenities, and leasing contact details.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	optional	How to find listings: `search` uses a city or ZIP plus filters; `urls` uses the Apartments.com URLs you paste; `listingKeys` looks up the listing keys you paste.
`searchLocation`	string	optional	US city and state (`New York, NY`) or 5-digit ZIP (`10001`). Used only in search mode.
`bedrooms`	string	optional	Match listings with at least one floor plan of this bedroom count.

Show all input fields

Field	Type	Required	Description
`mode`	string	optional	How to find listings: `search` uses a city or ZIP plus filters; `urls` uses the Apartments.com URLs you paste; `listingKeys` looks up the listing keys you paste.
`searchLocation`	string	optional	US city and state (`New York, NY`) or 5-digit ZIP (`10001`). Used only in search mode.
`bedrooms`	string	optional	Match listings with at least one floor plan of this bedroom count.
`bathrooms`	string	optional	Match listings with a floor plan at or above this bathroom count.
`priceMin`	integer	optional	Lowest monthly rent to include. Leave unset for no minimum.
`priceMax`	integer	optional	Highest monthly rent to include. Leave unset for no maximum.
`sqftMin`	integer	optional	Smallest floor plan to include. Leave unset for no minimum.
`sqftMax`	integer	optional	Largest floor plan to include. Leave unset for no maximum.
`propertyType`	string	optional	Restrict results to one property type.
`petPolicy`	string	optional	Require listings that allow dogs, cats, or both.
`amenities`	array	optional	Only return listings that publish every selected amenity.
`rentSpecials`	boolean	optional	Only return listings advertising a current move-in deal.
`minRating`	string	optional	Only return listings rated at or above this score (1–5).
`moveInDate`	string	optional	Only return listings with a unit available on or before this date (YYYY-MM-DD).
`specialties`	array	optional	Return listings matching at least one selected lifestyle or housing program. Student and senior housing are the most consistently published; other values are applied when the source exposes them.
`keywords`	string	optional	Keep listings whose name, description, amenities, neighborhood or floor-plan names contain this text. Requires scrapeDetails=true.
`sortBy`	string	optional	How to order returned listings.
`startUrls`	array	optional	Apartments.com city-search or property URLs. Used only in `urls` mode. A listing key is also accepted.
`listingKeys`	array	optional	Apartments.com listing keys such as `d3pj6rk`. Used only in `listingKeys` mode.
`maximizeCoverage`	boolean	optional	When the public listing index cannot fill your request, automatically try the site's search page as a last resort. Off by default.
`scrapeDetails`	boolean	optional	Fetch floor plans, available units, fees, pets, parking, schools, office hours, manager, website and photos for each listing. Turn off for faster card-level results.
`maxItems`	integer	optional	Maximum listings to return (1–5,000). Search mode also stops at the maxPages scan depth.
`maxPages`	integer	optional	How many 40-listing discovery pages to scan in search mode (1–20). Raise it when filters are narrow.

Download the published input schema

View complete JSON

{
  "description": "Find Apartments.com rentals by city or ZIP, paste property URLs, or look up listing keys. Filters and extra detail are optional.",
  "properties": {
    "amenities": {
      "default": [],
      "description": "Only return listings that publish every selected amenity.",
      "editor": "select",
      "items": {
        "enum": [
          "smoke-free",
          "washer-dryer",
          "dishwasher",
          "central-heating",
          "air-conditioning",
          "balcony",
          "fireplace",
          "furnished",
          "fitness-center",
          "pool",
          "tennis-court",
          "rooftop-deck",
          "basketball-court",
          "playground",
          "parking",
          "wheelchair-accessible",
          "high-speed-internet",
          "elevator",
          "washer-dryer-hookups",
          "laundry-facilities",
          "utilities-included",
          "lofts",
          "doorman",
          "gated",
          "concierge",
          "clubhouse",
          "controlled-access",
          "business-center",
          "garage",
          "patio",
          "hardwood-floors",
          "den",
          "office",
          "yard",
          "walk-in-closets",
          "basement",
          "ev-charging",
          "storage-units",
          "high-ceilings",
          "dog-park"
        ],
        "enumTitles": [
          "Smoke-free",
          "In-unit washer/dryer",
          "Dishwasher",
          "Central heating",
          "Air conditioning",
          "Balcony",
          "Fireplace",
          "Furnished",
          "Fitness center",
          "Pool",
          "Tennis court",
          "Rooftop deck",
          "Basketball court",
          "Playground",
          "Parking",
          "Wheelchair accessible",
          "High-speed internet",
          "Elevator",
          "Washer/dryer hookups",
          "Laundry facilities",
          "Utilities included",
          "Lofts",
          "Doorman",
          "Gated",
          "Concierge",
          "Clubhouse",
          "Controlled access",
          "Business center",
          "Garage",
          "Patio",
          "Hardwood floors",
          "Den",
          "Office",
          "Yard",
          "Walk-in closets",
          "Basement",
          "EV charging",
          "Storage units",
          "High ceilings",
          "Dog park"
        ],
        "type": "string"
      },
      "prefill": [],
      "title": "Required amenities",
      "type": "array"
    },
    "bathrooms": {
      "default": "any",
      "description": "Match listings with a floor plan at or above this bathroom count.",
      "editor": "select",
      "enum": [
        "any",
        "1plus",
        "2plus",
        "3plus"
      ],
      "enumTitles": [
        "Any",
        "1+ bathrooms",
        "2+ bathrooms",
        "3+ bathrooms"
      ],
      "prefill": "any",
      "title": "Bathrooms",
      "type": "string"
    },
    "bedrooms": {
      "default": "any",
      "description": "Match listings with at least one floor plan of this bedroom count.",
      "editor": "select",
      "enum": [
        "any",
        "studio",
        "1",
        "2",
        "3",
        "4",
        "5plus"
      ],
      "enumTitles": [
        "Any",
        "Studio",
        "1 bedroom",
        "2 bedrooms",
        "3 bedrooms",
        "4 bedrooms",
        "5+ bedrooms"
      ],
      "prefill": "any",
      "title": "Bedrooms",
      "type": "string"
    },
    "keywords": {
      "description": "Keep listings whose name, description, amenities, neighborhood or floor-plan names contain this text. Requires scrapeDetails=true.",
      "editor": "textfield",
      "title": "Keywords",
      "type": "string"
    },
    "listingKeys": {
      "description": "Apartments.com listing keys such as `d3pj6rk`. Used only in `listingKeys` mode.",
      "editor": "stringList",
      "title": "Listing keys",
      "type": "array"
    },
    "maxItems": {
      "default": 50,
      "description": "Maximum listings to return (1–5,000). Search mode also stops at the maxPages scan depth.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 1,
      "title": "Max listings",
      "type": "integer"
    },
    "maxPages": {
      "default": 5,
      "description": "How many 40-listing discovery pages to scan in search mode (1–20). Raise it when filters are narrow.",
      "maximum": 20,
      "minimum": 1,
      "prefill": 1,
      "title": "Max search depth (pages)",
      "type": "integer"
    },
    "maximizeCoverage": {
      "default": false,
      "description": "When the public listing index cannot fill your request, automatically try the site's search page as a last resort. Off by default.",
      "prefill": false,
      "title": "Maximize coverage",
      "type": "boolean"
    },
    "minRating": {
      "default": "any",
      "description": "Only return listings rated at or above this score (1–5).",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "2",
        "3",
        "4",
        "5"
      ],
      "enumTitles": [
        "Any rating",
        "1+ stars",
        "2+ stars",
        "3+ stars",
        "4+ stars",
        "5 stars"
      ],
      "prefill": "any",
      "title": "Minimum rating",
      "type": "string"
    },
    "mode": {
      "default": "search",
      "description": "How to find listings: `search` uses a city or ZIP plus filters; `urls` uses the Apartments.com URLs you paste; `listingKeys` looks up the listing keys you paste.",
      "editor": "select",
      "enum": [
        "search",
        "urls",
        "listingKeys"
      ],
      "enumTitles": [
        "Search by city or ZIP",
        "Scrape pasted URLs",
        "Look up listing keys"
      ],
      "prefill": "search",
      "sectionCaption": "Mode",
      "sectionDescription": "Choose how to discover listings.",
      "title": "Mode",
      "type": "string"
    },
    "moveInDate": {
      "description": "Only return listings with a unit available on or before this date (YYYY-MM-DD).",
      "editor": "textfield",
      "title": "Move-in by date",
      "type": "string"
    },
    "petPolicy": {
      "default": "any",
      "description": "Require listings that allow dogs, cats, or both.",
      "editor": "select",
      "enum": [
        "any",
        "dogs",
        "cats",
        "pets"
      ],
      "enumTitles": [
        "Any",
        "Dogs allowed",
        "Cats allowed",
        "Dogs or cats allowed"
      ],
      "prefill": "any",
      "title": "Pet policy",
      "type": "string"
    },
    "priceMax": {
      "description": "Highest monthly rent to include. Leave unset for no maximum.",
      "maximum": 50000,
      "minimum": 0,
      "title": "Maximum monthly rent ($)",
      "type": "integer"
    },
    "priceMin": {
      "description": "Lowest monthly rent to include. Leave unset for no minimum.",
      "maximum": 50000,
      "minimum": 0,
      "title": "Minimum monthly rent ($)",
      "type": "integer"
    },
    "propertyType": {
      "default": "any",
      "description": "Restrict results to one property type.",
      "editor": "select",
      "enum": [
        "any",
        "apartments",
        "houses",
        "condos",
        "townhomes"
      ],
      "enumTitles": [
        "Any type",
        "Apartments",
        "Houses",
        "Condos",
        "Townhomes"
      ],
      "prefill": "any",
      "title": "Property type",
      "type": "string"
    },
    "rentSpecials": {
      "default": false,
      "description": "Only return listings advertising a current move-in deal.",
      "prefill": false,
      "title": "Rent specials only",
      "type": "boolean"
    },
    "scrapeDetails": {
      "default": true,
      "description": "Fetch floor plans, available units, fees, pets, parking, schools, office hours, manager, website and photos for each listing. Turn off for faster card-level results.",
      "prefill": true,
      "sectionCaption": "Output options",
      "title": "Fetch full details",
      "type": "boolean"
    },
    "searchLocation": {
      "description": "US city and state (`New York, NY`) or 5-digit ZIP (`10001`). Used only in search mode.",
      "editor": "textfield",
      "prefill": "New York, NY",
      "sectionCaption": "Search filters",
      "sectionDescription": "Narrow the search by rent, size, type, pets and amenities. All filters are optional.",
      "title": "Search location",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "description": "How to order returned listings.",
      "editor": "select",
      "enum": [
        "relevance",
        "priceAsc",
        "priceDesc",
        "bedsAsc",
        "bedsDesc",
        "newest"
      ],
      "enumTitles": [
        "Best match",
        "Lowest rent first",
        "Highest rent first",
        "Fewest bedrooms first",
        "Most bedrooms first",
        "Recently updated"
      ],
      "prefill": "relevance",
      "title": "Sort order",
      "type": "string"
    },
    "specialties": {
      "default": [],
      "description": "Return listings matching at least one selected lifestyle or housing program. Student and senior housing are the most consistently published; other values are applied when the source exposes them.",
      "editor": "select",
      "items": {
        "enum": [
          "student",
          "senior",
          "military",
          "corporate",
          "luxury",
          "affordable",
          "cheap"
        ],
        "enumTitles": [
          "Student housing",
          "Senior housing",
          "Military housing",
          "Corporate housing",
          "Luxury",
          "Affordable housing",
          "Cheap"
        ],
        "type": "string"
      },
      "prefill": [],
      "title": "Lifestyle / housing type",
      "type": "array"
    },
    "sqftMax": {
      "description": "Largest floor plan to include. Leave unset for no maximum.",
      "maximum": 20000,
      "minimum": 0,
      "title": "Maximum square feet",
      "type": "integer"
    },
    "sqftMin": {
      "description": "Smallest floor plan to include. Leave unset for no minimum.",
      "maximum": 20000,
      "minimum": 0,
      "title": "Minimum square feet",
      "type": "integer"
    },
    "startUrls": {
      "description": "Apartments.com city-search or property URLs. Used only in `urls` mode. A listing key is also accepted.",
      "editor": "requestListSources",
      "sectionCaption": "Direct sources",
      "sectionDescription": "Paste URLs or listing keys instead of searching.",
      "title": "Start URLs",
      "type": "array"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "Apartments.com Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`listings`	string	optional	Dataset containing the scraped Apartments.com properties.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "One record per Apartments.com property, with rent by bedroom, floor plans, available units, fees, pets, parking, amenities, schools, office hours, manager, website and photos.",
  "properties": {
    "listings": {
      "description": "Dataset containing the scraped Apartments.com properties.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Rental listings",
      "type": "string"
    }
  },
  "title": "Apartments.com Rental Listings, Floor Plans & Fees"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Rental Listings",
      "transformation": {
        "fields": [
          "name",
          "address",
          "city",
          "state",
          "zipCode",
          "priceMin",
          "priceMax",
          "priceCurrency",
          "bedsMin",
          "bedsMax",
          "propertyType",
          "rating",
          "photoCount",
          "propertyManager",
          "url"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Apartments.com Rentals, Floor Plans & Fees Scraper

Apartments.com is where US renters compare managed communities, houses, condos and townhomes. This actor turns those public property pages into structured records: rent by bedroom count, floor plans, individual available units, fees, pet and parking rules, schools, office hours, the leasing manager, the property website and the photo gallery.

Use it to research a move, compare neighborhoods, track rent changes, or feed a rental dataset into a spreadsheet, CRM or analytics pipeline.

What it does

Searches a US city/state or ZIP code with filters for rent, bedrooms, bathrooms, square footage, property type, pets, amenities, rating, move-in date, specials and lifestyle.
Accepts Apartments.com city-search URLs and property URLs in one mixed list.
Looks up listing keys directly when you already have them.
Returns one record per property, with the fields the property actually publishes.
Omits fields a property does not publish instead of sending empty values.
Reports partial failures (stale keys, failed detail requests) in the run status instead of failing the whole run.

Services

Location search — city/state or 5-digit ZIP.
URL mode — paste search-result pages or individual property pages.
Listing-key lookup — one record per key, with invalid keys reported.
Rent by bedroom — the rent range for studios, 1-bed, 2-bed and larger plans.
Floor plans and units — model names, beds, baths, square footage, rent, total monthly price, unit counts, and individual unit numbers with availability dates and apply links.
Monthly and one-time fees — application, admin, deposit, pet, parking, storage, utility and other published fees.
Policies — pet rules, parking options, lease terms, office hours and languages.
Local context — schools, neighborhood, submarket, market and rating.
Contact and media — manager, website, phone and photo gallery.

How it works

Reads your mode and filters.
For search mode, resolves the city or ZIP and scans the site's public listing index for that place, up to the maxPages depth you set.
Reads each candidate property's public details, applies your filters, and keeps the matching listings.
For urls and listingKeys, reads exactly the properties you provide.
When full details are enabled, attaches floor plans, units, fees, policies, schools, office hours, manager, website and photos.
De-duplicates by listing key and URL, removes empty fields, and saves the records.

No account, login, cookie or API key is required.

Input

Field	Type	Default	Description
`mode`	select	`search`	`search`, `urls` or `listingKeys`
`searchLocation`	string	–	US city and state (`New York, NY`) or ZIP (`10001`); used by `search`
`bedrooms`	select	`any`	`any`, `studio`, `1`, `2`, `3`, `4`, `5plus`
`bathrooms`	select	`any`	`any`, `1plus`, `2plus`, `3plus`
`priceMin` / `priceMax`	integer	–	Monthly rent range in USD (0–50,000)
`sqftMin` / `sqftMax`	integer	–	Floor-plan size range (0–20,000)
`propertyType`	select	`any`	`any`, `apartments`, `houses`, `condos`, `townhomes`
`petPolicy`	select	`any`	`any`, `dogs`, `cats`, `pets`
`amenities`	array	`[]`	40 amenities, including pool, in-unit washer/dryer, parking, gym, elevator, dishwasher, air conditioning, balcony, furnished, gated, EV charging and more
`rentSpecials`	boolean	`false`	Only listings advertising a current move-in deal
`minRating`	select	`any`	`any`, `1`–`5`
`moveInDate`	string	–	Keep listings with a unit available on or before this date (`YYYY-MM-DD`)
`specialties`	array	`[]`	`student`, `senior`, `military`, `corporate`, `luxury`, `affordable`, `cheap`
`keywords`	string	–	Match name, description, amenities, neighborhood or floor-plan names (requires `scrapeDetails`)
`sortBy`	select	`relevance`	`relevance`, `priceAsc`, `priceDesc`, `bedsAsc`, `bedsDesc`, `newest`
`startUrls`	array	–	Search or property URLs for `urls`; plain listing keys are accepted too
`listingKeys`	array	–	Listing keys for `listingKeys`
`maximizeCoverage`	boolean	`false`	Try an additional coverage path when the public index cannot fill your request
`scrapeDetails`	boolean	`true`	Attach floor plans, units, fees, policies, schools, hours, manager, website and photos
`maxItems`	integer	`50`	Maximum records to return (1–5,000)
`maxPages`	integer	`5`	Search discovery depth, in 40-listing pages (1–20)

Example: pet-friendly two-bedrooms under $2,500

{
  "mode": "search",
  "searchLocation": "Austin, TX",
  "bedrooms": "2",
  "priceMax": 2500,
  "petPolicy": "dogs",
  "amenities": ["pool", "parking"],
  "maxItems": 50,
  "maxPages": 5,
  "scrapeDetails": true
}

Example: mixed URLs

{
  "mode": "urls",
  "startUrls": [
    "https://www.apartments.com/austin-tx/2-bedrooms-under-2500/",
    "https://www.apartments.com/amli-river-north-chicago-il/1pc7xx7/"
  ],
  "maxItems": 20,
  "scrapeDetails": true
}

Example: known listing keys

{
  "mode": "listingKeys",
  "listingKeys": ["d3pj6rk", "1pc7xx7", "lv3pbsf"],
  "maxItems": 10,
  "scrapeDetails": true
}

Output

Every record is one property. Fields are omitted when the property does not publish them.

Identity and place

listingId, url, name
address, fullAddress, city, state, zipCode, country, county
neighborhood, submarket, marketName, dma
latitude, longitude
propertyType, listingType, listingStatus

Pricing

priceMin, priceMax, priceCurrency
baseRentMin, baseRentMax
totalMonthlyPriceMin, totalMonthlyPriceMax
rentText
rentByBedType — array of {beds, priceMin, priceMax, priceText, baseRentMin, baseRentMax, totalMonthlyPriceMin, totalMonthlyPriceMax, sqftMin, sqftMax, availabilityDate}
rentSpecial — {title, description, expiresAt}
hasRentSpecials

Size and plans

bedsMin, bedsMax, bathsMin, bathsMax, sqftMin, sqftMax
floorPlans — {name, modelKey, beds, baths, sqftMin, sqftMax, rentMin, rentMax, totalMonthlyPriceMin, totalMonthlyPriceMax, unitCount, availableUnits, amenities}
units — the same floor-plan data in the legacy shape, with bedsMin/bedsMax/bathsMin/bathsMax/rentMin/rentMax/sqftMin/sqftMax
availableUnits — {unitKey, unitNumber, modelName, modelKey, beds, baths, sqft, rent, totalMonthlyPriceMin, totalMonthlyPriceMax, deposit, availableDate, availabilityText, leaseTerm, amenities, applyNowUrl}

Building and policies

yearBuilt, unitCount, stories, lotSize, lotSizeUnit
amenities, amenityCategories, uniqueFeatures
petPolicies, parkingOptions
fees — {oneTime[], monthly[], parking[], pets[], other[]}, each fee with name, amountMin, amountMax, amountText or period
leaseTerms, officeHours, languagesSpoken

Contact, reputation and media

phoneNumber, propertyWebsite, propertyManager — {name, companyKey, logoUrl}
rating
schools — {public[], private[]}
photos, coverPhoto, photoCount
availabilityDate, availabilityText
description
lastUpdated, scrapedAt

The original 32 fields remain available. Walk, transit, bike and sound scores (walkScore, transitScore, bikeScore, soundScore) are kept for compatibility but are only filled when a source publishes them.

Usage cost

This actor runs on Apify's platform and is billed by Apify compute usage for the time and memory the run consumes. There are no external API keys, subscriptions or per-record fees. A small run (one city, 10–50 listings, full details) usually finishes in under a minute; large runs scale with the number of listings and detail pages requested. Keep maxItems and maxPages at the smallest values that answer your question.

FAQ

Do I need an Apartments.com account? No. The actor reads publicly visible property information and needs no login, cookie or key.

Why did I get fewer records than maxItems? Search mode also stops at the maxPages discovery depth. A narrow filter may need a higher maxPages; direct urls and listingKeys modes are not limited by search depth. The run status says when a request was cut short.

Why are some fields missing for a property? Apartments.com does not publish every field for every property. Fees, pet rules, parking, office hours, schools, descriptions and photos are conditional. Missing values are omitted, never filled with placeholders.

What is the difference between priceMin and baseRentMin? priceMin/priceMax are the rent range across the property's plans. Base rent and total monthly price are also reported separately because some communities add required monthly fees.

What does availableUnits contain? Individual units the property is advertising, with unit number, rent, square feet, availability date and apply link. Not every property publishes individual units; many only publish floor-plan models.

Does scrapeDetails: false still return useful data? Yes. It returns the property-level record (address, rent ranges, bedrooms, amenities, fees where published and similar fields) but skips the extra media/fee/unit enrichment. It is faster and cheaper.

Are reviews or walk scores included? Reviews and walk/transit/bike/sound scores are not part of the public property data used here. The score fields are kept for backward compatibility but are normally absent.

Can I use ZIP codes? Yes. A 5-digit US ZIP resolves to its city and is searched the same way as City, ST.

Notes

Search filters are applied to the listings returned by the public index, not to a private search API. Combining several narrow filters works best with a higher maxPages.
URLs in urls mode can mix search pages and property pages; URL filters override the corresponding input filters.
Listing keys are case-insensitive and validated before lookup.
Records are de-duplicated by listing key and URL.
scrapedAt is the time the record was produced; lastUpdated is the property's own freshness date when published.

Limitations

US only. Canadian provinces are not covered.
Public index coverage. The site's public listing index is large but not a complete inventory of every unit. Major metros are well covered; very small towns may return few or no results. The run status reports a shortfall when this happens.
Search depth. maxPages is capped at 20 (about 800 candidate listings). Use listingKeys or multiple URL runs when you need deeper coverage.
Conditional fields. Fees, pet rules, parking, office hours, schools and individual units are published by the property, not by every listing.
Reviews, walkability scores, floor-plan images and virtual tours are not exposed in the public property data. The legacy score fields remain reserved but are usually absent.
Photo hosting. Photo URLs point to Apartments.com's image CDN. They load in browsers; some command-line clients may be refused by the CDN.
Coverage fallback. maximizeCoverage adds an optional fallback path, but it can be unavailable or blocked. The actor then returns the direct results and explains the shortfall instead of failing.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build p6YkqUxP9rFhfClUk. Documentation is regenerated from the default published build; private drafts are not included.