# GET /search-agents

> Search real estate agents

Source: https://uaepropertyapi.com/documentation/endpoints/search-agents

Search for real estate agents in UAE. Returns structured, simpler response data.

- Base URL: `https://uae-real-estate-property.p.rapidapi.com`
- Category: Agents & Brokers
- Headers: `x-rapidapi-key: <YOUR_RAPIDAPI_KEY>`, `x-rapidapi-host: uae-real-estate-property.p.rapidapi.com`

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `location_id` | string | no | Location ID to filter agents; Example: `50` (Dubai Marina), `41` (Downtown Dubai); Leave empty for all locations |
| `category` | string | no | Filter agents by specialization; `residential_sale`: Agents specializing in residential property sales; `residential_rent`: Agents specializing in residential rentals; `commercial_sale`: Agents specializing in commercial property sales; `commercial_rent`: Agents specializing in commercial rentals; Default: `residential_sale` |
| `sort` | string | no | Sort agents by performance; `most_sales`: Agents with most sales; `most_rentals`: Agents with most rentals; `featured`: Featured/trusted agents; Default: `most_sales` |
| `page` | string | no | Page number for pagination; Default: `1`; Examples: `1`, `2`, `3` |

## Example request

```bash
curl --request GET \
  --url 'https://uae-real-estate-property.p.rapidapi.com/search-agents' \
  --header 'x-rapidapi-host: uae-real-estate-property.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
```

```python
import requests

url = "https://uae-real-estate-property.p.rapidapi.com/search-agents"
querystring = {}
headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "uae-real-estate-property.p.rapidapi.com"
}

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

## Example response (shortened)

```json
{
  "success": true,
  "data": [
    {
      "id": 100245,
      "name": "Sarah Ahmed",
      "image": "https://www.propertyfinder.ae/agent/0/170/200/MODE/d5051e/100245-example.jpg",
      "position": "Property Consultant",
      "nationality": "United Kingdom",
      "total_properties": 165,
      "broker_name": "Example Properties LLC"
    }
  ]
}
```

Related endpoints: