> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.repliers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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 |
| ---- |
| `lat` | Yes | Latitude coordinate (decimal degrees) | 43.6425662 |
| `long` | Yes | Longitude coordinate (decimal degrees) | -79.3896317 |
| `radius` | 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`, and `radius`?  
* What units does the `radius` parameter 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?