APIs / Apartment List / Search
Apartment List: Search
Search from Apartment List as JSON. 1 credit per successful call.
GET /v1/apartment-list/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
location_id | integer | Required | Any |
beds[] | list of integer | Optional | Any |
baths[] | list of integer | Optional | Any |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
amenities[] | list of string | Optional | has_air_conditioning, has_balcony, has_bathtub, has_bbq, has_business_center, has_carport, has_carpet, has_ceiling_fan, has_dishwasher, has_doorman, has_elevator, has_fireplace, has_furnished_option, has_garage, has_garbage_disposal, has_granite_counter, has_gym, has_hardwood_floors, has_heat, has_hot_tub, has_ice_maker, has_in_unit_laundry, has_laundry_connections, has_on_site_laundry, has_parking, has_pickleball, has_pool, has_stainless_steel, has_walk_in_closet, is_accessible, is_cat_friendly, is_dog_friendly, is_pet_friendly, is_airbnb_friendly |
sort | string | Optional | default, price_asc, price_desc, best_match |
page | integer | Optional | Any |
per_page | integer | Optional | Any |
Example request
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.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.