--- title: "Apartment List API: 3 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/apartment-list --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Apartment List 1 credit per call 3 endpoints 23 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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\_id string | slug string | url url | name string | address string | geo object | phone string | bed\_range number\[\] | price\_range object | units\_available integer | soonest\_available string | floorplans object\[\] | photos string\[\] | community\_amenities object\[\] | unit\_amenities object\[\] | amenities\_text string | has\_rent\_special boolean | is\_featured boolean | show\_price boolean | source\_name string | is\_fee\_transparent boolean | occupancy\_types string\[\] | updated\_at string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | p116778449 | /tx/austin/harris-branch-senior-housing--1 | https://www.apartmentlist.com/tx/austin/harris-branch-senior-housing--1 | Harris Branch - Senior Housing | 12433 Dessau Rd, Austin, TX 78754 | {2 fields} | (570) 432-9975 | \[1 item\] | {3 fields} | 5 | 2025-12-16 | \[2 items\] | \[3 items\] | \[3 items\] | \[3 items\] | In unit laundry, Hardwood floors, Dishwasher, Pet friendly, New construction, Garage + more | false | false | true | real\_page\_mits4 | false | \[1 item\] | 2026-11-12T13:13:10.230Z | | 2 | p124742193 | /tx/austin/ovetta-rosedale-affordable-housing | https://www.apartmentlist.com/tx/austin/ovetta-rosedale-affordable-housing | Ovetta Rosedale - Affordable Housing | 4208 Medical Parkway, Austin, TX 78756 | {2 fields} | (682) 361-0308 | \[1 item\] | {3 fields} | 15 | 2026-10-07 | \[2 items\] | \[3 items\] | \[3 items\] | \[3 items\] | W/D hookup, Hardwood floors, Gym, Playground, Clubhouse, and Conference room | false | false | true | yardi\_rentcafe | false | \[1 item\] | 2026-11-12T10:14:30.058Z | | 3 | p38388 | /tx/austin/acacia-cliffs | https://www.apartmentlist.com/tx/austin/acacia-cliffs | Acacia Cliffs | 7201 Hart Ln, Austin, TX 78731 | {2 fields} | (301) 287-6509 | \[1 item\] | {3 fields} | 31 | 2026-10-02 | \[2 items\] | \[3 items\] | \[3 items\] | \[3 items\] | In unit laundry, Patio / balcony, Hardwood floors, Dishwasher, Pet friendly, 24hr maintenance + more | false | false | true | real\_page\_mits4 | false | — | 2026-11-12T13:10:41.756Z | Recorded from our API · 3 items shown · 23 datapoints per item GET /v1/apartment-list/search?location\_id=642592&beds\[\]=2&price\_max=1500&sort=price\_asc&per\_page=20 23 datapoints ### Identity - rental\_id string - slug string - name string - source\_name string - occupancy\_types string\[\] ### Contact - url url - phone string ### Location - address string ### Reputation - photos string\[\] ### Price - price\_range object - show\_price boolean - is\_fee\_transparent boolean ### Other - geo object - bed\_range number\[\] - units\_available integer - soonest\_available string - floorplans object\[\] - community\_amenities object\[\] - unit\_amenities object\[\] - amenities\_text string - has\_rent\_special boolean - is\_featured boolean - updated\_at string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/apartment-list/listing`](https://perceptlayer.com/apis/apartment-list/listing) | none +2 optional | 1 credit | | [GET `/v1/apartment-list/location-autocomplete`](https://perceptlayer.com/apis/apartment-list/location-autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/apartment-list/search`](https://perceptlayer.com/apis/apartment-list/search) | `location_id` +8 optional | 1 credit | Overview ## About the Apartment List API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)