Search RentalsGET/search/bylocation

Apartments /search/bylocation API

Build powerful real estate tools with RealtyAPI's /search/bylocation endpoint. Get Apartments data programmatically without worrying about rate limits, IP blocks, or constantly breaking selectors. Our engineering team maintains the underlying infrastructure around the clock — monitoring for changes, optimizing request paths, and ensuring data accuracy — so you can treat real estate data as a reliable, always-available resource. The endpoint returns well-structured JSON with consistent field names and data types, making it straightforward to map responses to your application's data models. From solo developers to enterprise teams, thousands of customers trust this endpoint for their production data needs.

What You Can Do With the /search/bylocation Endpoint

Here's what this endpoint provides and how you can use the data it returns.

Endpoint Parameters

Parameter	Type	Required	Description
`location`	STRING	Required	City, ZIP, neighborhood, county, submarket, or address. Resolved through apartments.com's typeahead, then the matching region's bounding box is used as the search area. Examples: - `New York, NY` - `Brooklyn, NY` - `11201` - `Williamsburg, Brooklyn, NY` - `Capitol Hill, Seattle, WA`
`page`	NUMBER	Optional	1-based page number. The response includes a `nextPage` boolean — keep paging until `nextPage = false`.
`resultCount`	NUMBER	Optional	Results per page. - Default: `50` - Min: `1` - Max: `500`
`sortOrder`	ENUM	Optional	Sort order for the result list. Default: `Default` (apartments.com's relevance bucket). - `Default` — apartments.com's default ranking - `Lowest_Rent` — cheapest first - `Highest_Rent` — most expensive first - `Newest` — most recently listed first - `Has_Video` — only listings with a video - `Has_3D_Tour` — only listings with a 3D tour - `Recently_Updated` — listings whose price/availability changed most recently Values: `Default, Lowest_Rent, Newest, Highest_Rent, Has_Video, Has_3D_Tour, Recently_Updated`
`propertyType`	STRING	Optional	Comma-separated property types to include. Leave empty for all types. Allowed values: `Apartment`, `House`, `Condo`, `Townhouse`, `Room` Aliases accepted: `Townhome` → `Townhouse`; `Single_Family` / `SFH` → `House`. Examples: `Apartment`, `Apartment,Condo`, `House,Townhouse`.
`priceRange`	STRING	Optional	Monthly rent range, in dollars. Possible Inputs: - For Minimum Rent: `min:1500` - For Maximum Rent: `max:4000` - For a Range: `min:1500,max:4000`
`bedRange`	STRING	Optional	Bedroom range. Studio = `min:0,max:0`. Possible Inputs: - For Minimum Beds: `min:1` - For Maximum Beds: `max:3` - For an Exact Match: `min:2,max:2` - For a Range: `min:1,max:3`
`bathRange`	STRING	Optional	Bathroom range — integers only on apartments.com. Possible Inputs: - For Minimum Baths: `min:1` - For Maximum Baths: `max:2` - For a Range: `min:1,max:2`
`squareFeetRange`	STRING	Optional	Living area range, in square feet. Possible Inputs: - For Minimum Sqft: `min:600` - For Maximum Sqft: `max:1500` - For a Range: `min:600,max:1500`
`petPolicy`	ENUM	Optional	Pet allowance. - `Dog` — listings that allow dogs - `Cat` — listings that allow cats - `Dog_and_Cat` — listings that allow both Omit to include all listings (pet-free or pet-friendly). Values: `Dog, Cat, Dog_and_Cat`
`amenities`	STRING	Optional	Comma-separated amenity filters. Listings must have all of the selected amenities. Allowed values (38): `smoke_free, washer_dryer, dishwasher, heating, air_conditioning, balcony, fireplace, furnished, gym, pool, tennis_court, roof_terrace, basketball_court, playground, rent_specials, garage_parking, wheelchair_access, parking, high_speed_internet, elevator, washer_dryer_hookup, laundry_facilities, gated, utilities_included, lofts, basement, business_center, clubhouse, concierge, controlled_access, den, doorman, hardwood_floors, office, patio, walk_in_closets, yard, car_charging_station` Aliases accepted: `ac` → `air_conditioning`, `fitness` → `gym`, `internet`/`wifi` → `high_speed_internet`, `garage` → `garage_parking`, `accessible` → `wheelchair_access`, `loft` → `lofts`, `walk_in_closet` → `walk_in_closets`, `ev_charging` → `car_charging_station`. Examples: `pool,gym`, `washer_dryer,dishwasher,parking`.
`specialties`	STRING	Optional	Comma-separated specialty-housing filters. Allowed values: `Senior`, `Military`, `Student`, `Corporate`, `Short_Term`, `Income_Restricted` Examples: `Student`, `Senior,Income_Restricted`, `Short_Term,Corporate`.
`toolFilters`	STRING	Optional	Comma-separated apartments.com deal-finder filters (powered by their internal ranking). Allowed values: `Rent_Special`, `Best_Value`, `Top_Deal`, `Luxury`, `Cheap` - `Rent_Special` — listings actively running rent specials / move-in incentives. - `Best_Value` / `Top_Deal` — apartments.com's value-ranked picks. - `Luxury` — premium/luxury inventory. - `Cheap` — budget-leaning inventory. Examples: `Rent_Special`, `Best_Value,Top_Deal`.
`minRating`	NUMBER	Optional	Minimum resident rating, on a 1–5 star scale (integer). Returns listings with a resident-rating ≥ N stars. Leave empty to include unrated listings. Examples: `3`, `4`.
`availableFrom`	STRING	Optional	Earliest move-in date (`YYYY-MM-DD`). Listings whose earliest available date is on or after this value are returned. Example: `2026-06-01`.
`availableTo`	STRING	Optional	Latest move-in date (`YYYY-MM-DD`). Listings whose earliest available date is on or before this value are returned. Example: `2026-09-01`.
`keywords`	STRING	Optional	Free-text keywords matched against listing descriptions (comma- or space-separated). Examples: `loft brick`, `hardwood,exposed brick`, `pool,doorman`.

Required Parameters

This endpoint requires location to fetch data. Pass these as query parameters in your request.

JSON Response

Receive structured JSON containing /search/bylocation data from Apartments. Parse it directly into your application models.

Real-Time Results

Every request fetches live Apartments data. No stale caches — you always get the most current information available.

Error Handling

Clear HTTP status codes and error messages help you handle edge cases gracefully. See our documentation for the full error reference.

Quick Start Example

Make your first request to the /search/bylocation endpoint in seconds.

Python

import requests

url = "https://apartments.realtyapi.io/search/bylocation"

headers = {
    "x-realtyapi-key": "YOUR_API_KEY"
}

params = {
    "location": "New York, NY"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
print(data)

Why Choose RealtyAPI's /search/bylocation Endpoint

Built for developers who need reliable real estate data without the infrastructure overhead.

Real-Time Data Access

Get the most current /search/bylocation data from Apartments without dealing with rate limits or IP blocks.

Simple Integration

Clear documentation and straightforward REST design make it easy to integrate this endpoint into any tech stack.

High Reliability

Our infrastructure ensures high uptime and consistent performance for your production applications.

Comprehensive Data

Access detailed /search/bylocation data through this carefully designed endpoint.

/search/bylocation Endpoint Use Cases

Real-world applications that leverage the /search/bylocation endpoint for Apartments data.

Data Analysis

Analyze /search/bylocation data from Apartments to gain insights and make data-driven decisions about real estate markets.

Market Monitoring

Monitor Apartments /search/bylocation data to track changes, pricing trends, and market movements in real time.

Application Integration

Integrate /search/bylocation data from Apartments into your web applications, mobile apps, or internal tools.

Workflow Automation

Automate data collection and processing workflows using Apartments /search/bylocation data to improve team efficiency.

Reporting & Analytics

Generate reports and dashboards using Apartments /search/bylocation data for stakeholders, investors, or clients.

Custom Solutions

Build custom real estate solutions that leverage Apartments /search/bylocation data for your specific business needs.

Frequently Asked Questions

Common questions about the /search/bylocation endpoint.

Is the /search/bylocation endpoint official?

No, RealtyAPI provides an unofficial /search/bylocation endpoint that lets you access Apartments data through our platform. We handle the complexities of data collection so you can focus on building your application.

How current is the data?

We provide real-time /search/bylocation data from Apartments. When you make a request, we fetch the latest information available.

Can I use this endpoint in production?

Absolutely. Many businesses rely on RealtyAPI's endpoints for their production applications. Our infrastructure is designed for reliability and performance.

What happens if I exceed my API limit?

On paid plans, you can enable overage billing so your application keeps working. Free plan users can upgrade at any time to increase their quota.

Is there rate limiting?

Rate limits vary by plan. Free tier allows up to 10 requests per second. Paid plans offer higher limits suitable for production workloads.

What programming languages are supported?

RealtyAPI is a standard REST API, so it works with any language that can make HTTP requests: Python, JavaScript, Go, PHP, Ruby, Java, C#, and more.

Ready to Integrate the /search/bylocation Endpoint?

Get started with 250 free API calls. No credit card required.

Common Terms for /search/bylocation Endpoint Access

Apartments /search/bylocation API integration/search/bylocation data APIAccess /search/bylocation data programmaticallyApartments /search/bylocation API for developers/search/bylocation API endpoint/search/bylocation API documentationHow to use Apartments /search/bylocation APIApartments /search/bylocation API wrapper/search/bylocation real estate dataApartments /search/bylocation REST API