Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Apartment List

1 credit per call3 endpoints23 datapoints

Apartment List API

Apartment List API for US apartment rentals: search by city, floor plans, rent ranges, amenities and listing details as JSON. 1 credit per successful call.

Get a free API keyRun it below
Apartment List
GET/v1/apartment-list/search?location_id=642592&beds[]=2&price_max=1500&sort=price_asc&per_page=20
{
  "success": true,
  "total": 344,
  "total_units": 2282,
  "returned": 19,
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_pages": 18,
    "has_next_page": true
  },
  "applied_filters": {
    "location_id": 642592,
    "beds": [
      2
    ],
    "price_max": 1500,
    "sort": "price_asc"
  },
  "listings": [
    {
      "rental_id": "p116778449",
      "slug": "/tx/austin/harris-branch-senior-housing--1",
      "url": "https://www.apartmentlist.com/tx/austin/harris-branch-senior-housing--1",
      "name": "Harris Branch - Senior Housing",
      "address": "12433 Dessau Rd, Austin, TX 78754",
      "geo": {
        "lat": 30.38903,
        "lon": -97.646608
      },
      "phone": "(570) 432-9975",
      "bed_range": [
        2
      ],
      "price_range": {
        "lowest": 750,
        "highest": 1099,
        "by_bed_count": {
          "2": {
            "min": 750,
            "max": 1099
          }
        }
      },
      "units_available": 5,
      "soonest_available": "2025-12-16",
      "floorplans": [
        {
          "floorplan_id": 10679549,
          "name": "B1",
          "bed": 2,
          "bath": 1,
          "sqft": 969,
          "sqft_max": 969,
          "price": 750,
          "units": [
            "…",
            "…",
            "…"
          ]
        },
        {
          "floorplan_id": 10679550,
          "name": "B2",
          "bed": 2,
          "bath": 1,
          "sqft": 975,
          "sqft_max": 975,
          "price": 1099,
          "units": [
            "…",
            "…"
          ]
        }
      ],
      "photos": [
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/0350f69ff134d8b82363adc5ab8de7b9.jpg",
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/bc2b762b196307971a0ca5150533aaeb.jpg",
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/4a901bac1e99b067d6f48a63af922725.jpg"
      ],
      "community_amenities": [
        {
          "name": "Business center",
          "key": "has_business_center",
          "group": "community_features"
        },
        {
          "name": "Clubhouse",
          "group": "community_features"
        },
        {
          "name": "Community garden",
          "group": "community_features"
        }
      ],
      "unit_amenities": [
        {
          "name": "Air conditioning",
          "key": "has_air_conditioning",
          "group": "unit_features"
        },
        {
          "name": "Carpet",
          "key": "has_carpet",
          "group": "unit_features"
        },
        {
          "name": "Ceiling fan",
          "key": "has_ceiling_fan",
          "group": "unit_features"
        }
      ],
      "amenities_text": "In unit laundry, Hardwood floors, Dishwasher, Pet friendly, New construction, Garage + more",
      "has_rent_special": false,
      "is_featured": false,
      "show_price": true,
      "source_name": "real_page_mits4",
      "is_fee_transparent": false,
      "occupancy_types": [
        "senior"
      ],
      "updated_at": "2026-11-12T13:13:10.230Z"
    },
    {
      "rental_id": "p124742193",
      "slug": "/tx/austin/ovetta-rosedale-affordable-housing",
      "url": "https://www.apartmentlist.com/tx/austin/ovetta-rosedale-affordable-housing",
      "name": "Ovetta Rosedale - Affordable Housing",
      "address": "4208 Medical Parkway, Austin, TX 78756",
      "neighborhood": "Rosedale",
      "geo": {
        "lat": 30.3120131,
        "lon": -97.7429148
      },
      "phone": "(682) 361-0308",
      "bed_range": [
        2
      ],
      "price_range": {
        "lowest": 764,
        "highest": 1369,
        "by_bed_count": {
          "2": {
            "min": 764,
            "max": 1369
          }
        }
      },
      "units_available": 15,
      "soonest_available": "2026-10-07",
      "floorplans": [
        {
          "floorplan_id": 11231476,
          "name": "Two Bedroom, Two Bath",
          "bed": 2,
          "bath": 2,
          "sqft": 853,
          "sqft_max": 853,
          "price": 764,
          "units": [
            "…"
          ]
        },
        {
          "floorplan_id": 11231469,
          "name": "Two Bedroom, Two Bath",
          "bed": 2,
          "bath": 2,
          "sqft": 513,
          "sqft_max": 913,
          "price": 1369,
          "units": [
            "…",
            "…",
            "…"
          ]
        }
      ],
      "photos": [
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/d262c69c2b26f5b3afc4630c458c5a927458323d8182ee95679bab3f874e69f1.jpg",
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/6bea88a9e9ee62521a4670d8ef4612ec253faab6915043325dec03587a1200a3.jpg",
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/f1983cc62b05f10b6cdc45e9a0ff6099917ba1a72266f964c925faaf65e0ebec.jpg"
      ],
      "community_amenities": [
        {
          "name": "Accessible",
          "key": "is_accessible",
          "group": "community_features"
        },
        {
          "name": "Clubhouse",
          "group": "community_features"
        },
        {
          "name": "Internet cafe",
          "group": "community_features"
        }
      ],
      "unit_amenities": [
        {
          "name": "Hardwood floors",
          "key": "has_hardwood_floors",
          "group": "unit_features"
        },
        {
          "name": "Bathtub",
          "key": "has_bathtub",
          "group": "unit_features"
        },
        {
          "name": "W/D hookup",
          "key": "has_laundry_connections",
          "group": "laundry"
        }
      ],
      "amenities_text": "W/D hookup, Hardwood floors, Gym, Playground, Clubhouse, and Conference room",
      "has_rent_special": false,
      "is_featured": false,
      "show_price": true,
      "source_name": "yardi_rentcafe",
      "is_fee_transparent": false,
      "occupancy_types": [
        "affordable"
      ],
      "updated_at": "2026-11-12T10:14:30.058Z"
    },
    {
      "rental_id": "p38388",
      "slug": "/tx/austin/acacia-cliffs",
      "url": "https://www.apartmentlist.com/tx/austin/acacia-cliffs",
      "name": "Acacia Cliffs",
      "address": "7201 Hart Ln, Austin, TX 78731",
      "neighborhood": "Northwest Hills - Far West",
      "geo": {
        "lat": 30.3461,
        "lon": -97.769939
      },
      "phone": "(301) 287-6509",
      "bed_range": [
        2
      ],
      "price_range": {
        "lowest": 770,
        "highest": 989,
        "by_bed_count": {
          "2": {
            "min": 770,
            "max": 989
          }
        }
      },
      "units_available": 31,
      "soonest_available": "2026-10-02",
      "floorplans": [
        {
          "floorplan_id": 7607897,
          "name": "B1",
          "bed": 2,
          "bath": 1,
          "sqft": 890,
          "sqft_max": 890,
          "price": 770,
          "units": [
            "…"
          ]
        },
        {
          "floorplan_id": 7607898,
          "name": "B2",
          "bed": 2,
          "bath": 2,
          "sqft": 950,
          "sqft_max": 950,
          "price": 856,
          "units": [
            "…",
            "…",
            "…"
          ]
        }
      ],
      "photos": [
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/dddd896ff87bf2d1d671967d186f4cc2.jpg",
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/769fc5c8b60a5498c5e62f147aa5fef9.jpg",
        "https://cdn.apartmentlist.com/image/upload/c_fill,dpr_auto,f_auto,g_center,h_415,q_auto,w_640/8d77be8ecfc6e10b7ef5225bf9eaa844.jpg"
      ],
      "community_amenities": [
        {
          "name": "Clubhouse",
          "group": "community_features"
        },
        {
          "name": "Courtyard",
          "group": "community_features"
        },
        {
          "name": "Parking",
          "key": "has_parking",
          "group": "parking"
        }
      ],
      "unit_amenities": [
        {
          "name": "Extra storage",
          "group": "unit_features"
        },
        {
          "name": "Range",
          "group": "unit_features"
        },
        {
          "name": "Air conditioning",
          "key": "has_air_conditioning",
          "group": "unit_features"
        }
      ],
      "amenities_text": "In unit laundry, Patio / balcony, Hardwood floors, Dishwasher, Pet friendly, 24hr maintenance + more",
      "has_rent_special": false,
      "review_summary": {
        "title": "Ideal location with modern living perks.",
        "text": "Discover the serene hill-top country living at Acacia Cliffs Apartments, where modern amenities meet a prime location. Enjoy redesigned kitchens with gas stoves, large closets, and new flooring. Residents love the convenient access to local…",
        "tag": "Hilltop Serenity"
      },
      "is_featured": false,
      "show_price": true,
      "source_name": "real_page_mits4",
      "is_fee_transparent": false,
      "updated_at": "2026-11-12T13:10:41.756Z"
    }
  ],
  "meta": {
    "endpoint_family": "search",
    "attempts": 4,
    "omitted": 1,
    "id_list_cached": false,
    "request_id": "req_df53421017074b109a15d41d473cc52d",
    "credits_charged": 1,
    "credits_remaining": 1895
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#rental_idstringslugstringurlurlnamestringaddressstringgeoobjectphonestringbed_rangenumber[]price_rangeobjectunits_availableintegersoonest_availablestringfloorplansobject[]photosstring[]community_amenitiesobject[]unit_amenitiesobject[]amenities_textstringhas_rent_specialbooleanis_featuredbooleanshow_pricebooleansource_namestringis_fee_transparentbooleanoccupancy_typesstring[]updated_atstring
1p116778449/tx/austin/harris-branch-senior-housing--1https://www.apartmentlist.com/tx/austin/harris-branch-senior-housing--1Harris Branch - Senior Housing12433 Dessau Rd, Austin, TX 78754{2 fields}(570) 432-9975[1 item]{3 fields}52025-12-16[2 items][3 items][3 items][3 items]In unit laundry, Hardwood floors, Dishwasher, Pet friendly, New construction, Garage + morefalsefalsetruereal_page_mits4false[1 item]2026-11-12T13:13:10.230Z
2p124742193/tx/austin/ovetta-rosedale-affordable-housinghttps://www.apartmentlist.com/tx/austin/ovetta-rosedale-affordable-housingOvetta Rosedale - Affordable Housing4208 Medical Parkway, Austin, TX 78756{2 fields}(682) 361-0308[1 item]{3 fields}152026-10-07[2 items][3 items][3 items][3 items]W/D hookup, Hardwood floors, Gym, Playground, Clubhouse, and Conference roomfalsefalsetrueyardi_rentcafefalse[1 item]2026-11-12T10:14:30.058Z
3p38388/tx/austin/acacia-cliffshttps://www.apartmentlist.com/tx/austin/acacia-cliffsAcacia Cliffs7201 Hart Ln, Austin, TX 78731{2 fields}(301) 287-6509[1 item]{3 fields}312026-10-02[2 items][3 items][3 items][3 items]In unit laundry, Patio / balcony, Hardwood floors, Dishwasher, Pet friendly, 24hr maintenance + morefalsefalsetruereal_page_mits4false—2026-11-12T13:10:41.756Z

Recorded from our API · 3 items shown · 23 datapoints per itemGET /v1/apartment-list/search?location_id=642592&beds[]=2&price_max=1500&sort=price_asc&per_page=20

23 datapoints

Identity

  • rental_idstring
  • slugstring
  • namestring
  • source_namestring
  • occupancy_typesstring[]

Contact

  • urlurl
  • phonestring

Location

  • addressstring

Reputation

  • photosstring[]

Price

  • price_rangeobject
  • show_priceboolean
  • is_fee_transparentboolean

Other

  • geoobject
  • bed_rangenumber[]
  • units_availableinteger
  • soonest_availablestring
  • floorplansobject[]
  • community_amenitiesobject[]
  • unit_amenitiesobject[]
  • amenities_textstring
  • has_rent_specialboolean
  • is_featuredboolean
  • updated_atstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/apartment-list/search?location_id=642592&beds[]=2&price_max=1500&sort=price_asc&per_page=20" \
  -H "X-API-Key: $API_KEY"

Apartment List · 3 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/apartment-list/listing
none+2 optional
1 credit
GET/v1/apartment-list/location-autocomplete
q+1 optional
1 credit
GET/v1/apartment-list/search
location_id+8 optional
1 credit

Overview

What you can get

The Apartment List API returns Apartment List rental data for the US as JSON through 3 endpoints.

  • Search: search takes a location_id, with repeatable beds[], baths[] and amenities[], price_min, price_max, sort (default, price_asc, price_desc or best_match), page and per_page.
  • Listings: listing takes a slug or a rental_id.
  • Locations: location-autocomplete takes q, with repeatable types[].

The recorded search (location_id=642592, beds[]=2, price_max=1500, sort=price_asc, per_page=20) for Austin returns listings, each with rental_id, slug, url, name, address, geo, bed_range, price_range (lowest, highest, by_bed_count), units_available, soonest_available, floorplans (bed, bath, sqft, price), community_amenities, unit_amenities, has_rent_special and updated_at. It also returns total (344), total_units (2,282) and pagination with total_pages and has_next_page.

How a call works

Search two-bedroom rentals in Austin: GET /v1/apartment-list/search?location_id=642592&beds[]=2&price_max=1500&sort=price_asc&per_page=20 with your key in the X-API-Key header. Find a city's location_id with location-autocomplete. Each listing's slug or rental_id goes to listing. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartments.comAqarAqarmapArgenpropathomeBatdongsan.com.vn

Use cases

Track asking rents by bedroom count in a US city with `price_range.by_bed_count`

Use the Apartment List API to track asking rents by bedroom count in a US city with `price_range.by_bed_count`

Count available units and move-in dates across a metro

Use the Apartment List API to count available units and move-in dates across a metro

Compare floor plan sizes and prices within one property

Use the Apartment List API to compare floor plan sizes and prices within one property

Find rentals with a given amenity using `amenities[]`

Use the Apartment List API to find rentals with a given amenity using `amenities[]`

FAQ

Questions

Do I need an Apartment List account?

No. You call this Apartment List API with your Perceptlayer key in the `X-API-Key` header, with no Apartment List login.

How much does the Apartment List API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Does it return units or properties?

Both. Each listing is a property with its `floorplans` and `units_available`; the recorded Austin search reports a `total` of 344 and a `total_units` of 2,282.

Should I build an Apartment List scraper instead?

You can, but an Apartment List scraper is code you maintain: page changes break it, requests get blocked, and Apartment List's terms govern how you collect data. The Apartment List API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Apartment List API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs