# GET /search-agents-by-name

> Search agents by name

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

Find real estate agents in the UAE by name. Returns up to 20 agents per page with their broker, listing counts by category, languages, top locations, ratings and claimed transactions. Use the returned `id` with `/agent-properties?agent_id=` to fetch an agent's listings.

- 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 |
|---|---|---|---|
| `text` | string | yes | Name of the agent to search; Example: `Anna` |
| `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-by-name?text=Sarah' \
  --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-by-name"
querystring = {"text": "Sarah"}
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": 123456,
      "slug": "sarah-ahmed",
      "name": "Sarah Ahmed",
      "email": "",
      "phone": "+9715XXXXXXXX",
      "whatsappPhone": null,
      "superagent": true,
      "verified": true,
      "totalProperties": 4,
      "propertiesResidentialForRentCount": 2,
      "propertiesResidentialForSaleCount": 2,
      "propertiesCommercialForRentCount": 0,
      "propertiesCommercialForSaleCount": 0,
      "avgWhatsappResponseTime": 81,
      "experienceSince": 2013,
      "image": {
        "links": {
          "agentCard": "https://static.shared.propertyfinder.ae/media/images/agent_image/123456/example.jpg",
          "desktop": "https://static.shared.propertyfinder.ae/media/images/agent_image/123456/example.jpg",
          "mobile": "https://static.shared.propertyfinder.ae/media/images/agent_image/123456/example.jpg"
        }
      },
      "position": "Agent",
      "bio": "Sarah Ahmed is a property consultant specialising in Jumeirah and Dubai Marina...",
      "nationality": {
        "code": "AE",
        "name": "United Arab Emirates"
      },
      "licenseNumber": "",
      "ranking": 68,
      "transactionsCount": 4,
      "averageRating": 5,
      "reviewCount": 3,
      "languages": [
        {
          "id": 1,
          "name": "English"
        },
        {
          "id": 2,
          "name": "Arabic"
        }
      ],
      "topLocations": [
        {
          "id": 66,
          "name": "Jumeirah"
        },
        {
          "id": 50,
          "name": "Dubai Marina"
        }
      ],
      "claimedTransactionsSale": 3,
      "claimedTransactionsRent": 1,
      "claimedTransactionsList": [
        {
          "dealType": "Sale",
          "price": 19200000,
          "date": "2026-10-06",
          "propertyType": "Apartment",
          "bedroom": "4"
        }
      ],
      "broker": {
        "id": 911,
        "slug": "example-properties-llc",
        "name": "Example Properties LLC",
        "location": "Dubai"
      },
      "compliances": [
        {
          "type": "brn",
          "value": "12345"
        }
      ]
    }
  ]
}
```

Related endpoints: https://uaepropertyapi.com/documentation/endpoints/agent-properties.md, https://uaepropertyapi.com/documentation/endpoints/search-agents-detailed.md, https://uaepropertyapi.com/documentation/endpoints/search-brokers.md