How to Find Listings Using Radius Search
Our API provides a powerful radius search feature that allows you to find listings within a specific distance from any location. This is particularly useful for location-based applications, real estate searches, or any service that needs to find nearby listings.
What You'll Need
To perform a radius search, you need three key pieces of information:
- Latitude - The north-south coordinate of your search center
- Longitude - The east-west coordinate of your search center
- Radius - The search distance in kilometers
Basic Usage
The radius search endpoint follows this format:
https://api.repliers.io/listings?lat={latitude}&long={longitude}&radius={kilometers}
Example Request
Let's say you want to find all listings within 3 kilometers of the CN Tower in Toronto. The CN Tower's coordinates are:
- Latitude: 43.6425662
- Longitude: -79.3896317
Your API call would look like this:
https://api.repliers.io/listings?lat=43.6425662&long=-79.3896317&radius=3
This request will return all active listings within a 3-kilometer radius of the CN Tower.
How to Get Coordinates
If you don't have the latitude and longitude for your desired location, you can obtain them through several methods:
- Google Maps: Right-click on any location and select the coordinates that appear
- Geocoding APIs: Convert addresses to coordinates programmatically
- GPS devices: Most GPS-enabled devices can provide precise coordinates
- Online coordinate tools: Various websites offer address-to-coordinate conversion
- Repliers: Each listing in our API has lat/long values
Parameters Explained
Parameter | Required | Description | Example |
|---|---|---|---|
| Yes | Latitude coordinate (decimal degrees) | 43.6425662 |
| Yes | Longitude coordinate (decimal degrees) | -79.3896317 |
| Yes | Search radius in kilometers | 3 |
Response
The API will return all listings found within your specified radius, along with their details.
Tips for Best Results
Choose appropriate radius values: Start with smaller radii (1-5km) for urban areas and larger ones (5-10km) for rural searches.
Verify coordinates: Double-check your latitude and longitude values to ensure accurate results. Incorrect coordinates will return listings from unintended locations.
Consider geographic features: Remember that the radius creates a circular search area, which may include water bodies or inaccessible terrain depending on your location.
Common Use Cases
- Find properties within specific distance of an address
- Finding properties within a specific distance of a landmark
- Identifying listings around a particular neighborhood or district
What questions does this article answer?
- How do I find listings within a radius of a point using
lat,long, andradius? - What units does the
radiusparameter use and how do I choose a sensible radius? - How can I combine radius search with other filters like price, beds, baths, or property type?
- How do I design “near me” or “within X km” features using this pattern?
Updated on: 05/12/2025
Thank you!
