Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Apartments Search

Recherchez des locations sur Apartments.com via une URL et obtenez prix, photos, adresses et pagination via rendu navigateur.

Actif2 crédits = 1 requêteGET/v2/apartments/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

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

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus