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
Need Help?
If you're having trouble with radius searches or need assistance, please contact our support team with your specific use case and we'll be happy to help.
Updated on: 12/06/2025
Thank you!