Search RentalsGET/search/byregionid

Apartments /search/byregionid API

Power your real estate application with reliable /search/byregionid data from Apartments. This endpoint is built on infrastructure that processes millions of requests daily with consistent sub-second latency and high availability across all regions. Unlike DIY scraping solutions that degrade over time and require constant maintenance, RealtyAPI provides a stable interface that your team can depend on quarter after quarter. The data is fresh — every request fetches live information from Apartments — and the response format is designed for easy parsing and storage. It is the kind of data infrastructure that lets your engineering team focus on product work instead of plumbing.

What You Can Do With the /search/byregionid Endpoint

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

Endpoint Parameters

Parameter	Type	Required	Description
`geographyId`	NUMBER	Required	Apartments.com region/property `id` (the `id` field returned by [/autocomplete](https://realtyapi.io/dashboard?tab=playground&api=apartments&endpoint=autocomplete)). Examples: - `20752` — Brooklyn, NY (city) - `5302` — Manhattan, NY (city)
`geographyType`	NUMBER	Optional	Type code for the region (the `typeCode` field returned by [/autocomplete](https://realtyapi.io/dashboard?tab=playground&api=apartments&endpoint=autocomplete)). Common values: `3` City · `2` PostalCode · `5` SubMarket · `10` County · `11` Subdivision · `16` PostalCodeGroup · `17` Region. If omitted, we attempt to hydrate it from `displayText` via autocomplete.
`displayText`	STRING	Optional	Optional human-readable name (the `displayText` field from autocomplete, e.g. `Brooklyn, NY`). Used only when `geographyType` and `boundingBox` aren't passed — we look the value up in autocomplete and fill in the missing geo metadata.
`boundingBox`	STRING	Optional	Optional bounding box for the region as `west,south,east,north` (lon,lat). Pass this through verbatim from autocomplete's `box` field for an exact-area search. If omitted, the region's centroid + a small radius is used instead.
`centroid`	STRING	Optional	Optional region centroid as `lat,lon`. Pass this through verbatim from autocomplete's `(lat, lon)` fields. Used as a fallback when `boundingBox` isn't supplied.
`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 geographyId to fetch data. Pass these as query parameters in your request.

JSON Response

Receive structured JSON containing /search/byregionid 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/byregionid endpoint in seconds.

Python

import requests

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

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

params = {
    "geographyId": "20752"
}

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

Why Choose RealtyAPI's /search/byregionid Endpoint

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

Real-Time Data Access

Get the most current /search/byregionid 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/byregionid data through this carefully designed endpoint.

/search/byregionid Endpoint Use Cases

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

Data Analysis

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

Market Monitoring

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

Application Integration

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

Workflow Automation

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

Reporting & Analytics

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

Custom Solutions

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

Frequently Asked Questions

Common questions about the /search/byregionid endpoint.

Is the /search/byregionid endpoint official?

No, RealtyAPI provides an unofficial /search/byregionid 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/byregionid 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/byregionid Endpoint?

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

Common Terms for /search/byregionid Endpoint Access

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