Skip to main content
Piloterr
Back to library

Apartments Search API

Search Apartments.com rentals from a full city or browse URL and retrieve prices, photos, addresses, phone numbers, and pagination via browser rendering.

Active2 credits = 1 requestGET/v2/apartments/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Extract rental listing cards from any Apartments.com search or city browse page. Returns structured results with address, pricing tiers, photos, phone, property type, and pagination metadata.

Apartments.com search pages are JavaScript single-page applications. Listing cards load dynamically after the initial HTML shell. A plain HTTP request returns an empty page skeleton. Piloterr uses website rendering to execute JavaScript, wait for listing cards to render, and extract structured JSON from the live DOM.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/apartments/search?query=https://www.apartments.com/new-york-ny/3

Copy the full URL from apartments.com. Increment the page number in the path for pagination (/new-york-ny/4/).

Supported URL formatsLink to Supported URL formats

Format Example
City search page 1 https://www.apartments.com/new-york-ny/
City search page N https://www.apartments.com/new-york-ny/3

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full Apartments.com city or search URL

Response fieldsLink to Response fields

Field Type Description
results array Rental listing cards
results[].id string Apartments.com listing ID
results[].url string Property detail URL
results[].title string Listing title
results[].address string Full formatted address
results[].street_address string Street line
results[].phone string | null Contact phone
results[].image string | null Main thumbnail URL
results[].image_count integer | null Number of photos
results[].property_type string | null e.g. Apartment for Rent
results[].country_code string | null ISO country code
results[].min_price integer | null Lowest listed price in USD
results[].pricing array Bed/price tiers (beds, price)
results[].has_video boolean Whether a video tour exists
results[].has_virtual_tour boolean Whether a virtual tour exists
pagination.current integer Current page number
pagination.next_url string | null Next page URL
pagination.total_count integer Total matching listings
pagination.has_next_page boolean Whether a next page exists

NotesLink to Notes

  • Targets apartments.com (US rental marketplace).
  • Page number is encoded in the URL path, not a query parameter.
  • pricing may contain multiple bed/price combinations per building.
  • Pass results[].url to Apartments Property for amenities, gallery, description, and square footage.

Main use casesLink to Main use cases

  • Monitor rental inventory and pricing across US cities
  • Build apartment lead lists with phone, address, and min price
  • Feed proptech analytics pipelines with live market data
  • Paginate through Apartments.com search result pages

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included