Search for real estate agents by location and specialization. - BayutAPI Documentation

GET /agent-search

Search for real estate agents by location and specialization.

Description

The agent-search endpoint lets you discover real estate agents operating in specific UAE locations. Results include agent profiles with their name, photo, agency affiliation, and listing counts.

This endpoint is useful for building agent directories, matching users with local experts, and analyzing agent activity across different areas. Combine with agent-details and agent-properties for comprehensive agent profiles.

Filter by location to find agents who specialize in particular communities or emirates.

Parameters

Name	Type	Required	Description	Example
`location_ids`	string	Optional	Comma-separated location external IDs to filter agents by area. Get IDs from the autocomplete endpoint.	`5003`
`purpose`	string	Optional	Transaction type to filter agents by: 'for-sale' or 'for-rent'. Default: 'for-sale'.	`for-sale`
`category`	string	Optional	Property category the agent specializes in: 'residential' or 'commercial'. Default: 'residential'.	`residential`
`completion_status`	string	Optional	Filter agents by completion status of their listings: 'any' (default), 'completed', 'under-construction'.	`any`
`page`	integer	Optional	Page number for paginated results, starting from 1. Results per page: 40.	`1`
`langs`	string	Optional	Language code: 'en', 'ar', 'ru', 'zh'. Default: 'en'.	`en`

Code Examples

curl --request GET \
  --url 'https://bayut14.p.rapidapi.com/agent-search?location_ids=5003&page=1&langs=en' \
  --header 'x-rapidapi-host: bayut14.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

import requests

url = "https://bayut14.p.rapidapi.com/agent-search"

querystring = {
    "location_ids": "5003",
    "page": "1",
    "langs": "en"
}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "bayut14.p.rapidapi.com"
}

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

const url = 'https://bayut14.p.rapidapi.com/agent-search?location_ids=5003&page=1&langs=en';

const options = {
  method: 'GET',
  headers: {
    'x-rapidapi-key': 'YOUR_API_KEY',
    'x-rapidapi-host': 'bayut14.p.rapidapi.com'
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

Example Response

Response

{
  "success": true,
  "data": {
    "agents": [
      {
        "externalID": "4567",
        "name": "John Smith",
        "photo": {
          "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/agent-photo.jpg"
        },
        "agency": {
          "name": "Premium Properties LLC",
          "externalID": "5678",
          "logo": {
            "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/agency-logo.jpg"
          }
        },
        "propertiesCount": 42,
        "languages": [
          "English",
          "Arabic"
        ],
        "experience": 8
      }
    ],
    "total": 156,
    "page": 1,
    "totalPages": 4,
    "hitsPerPage": 40
  }
}

Use Cases

Build agent directories for specific areas
Match property seekers with local agents
Analyze agent density and competition by area
Create agent comparison tools

Related Endpoints

GET /agent-search-by-name

Search for agents by their name.

GET /agent-details

Get detailed profile information for a specific agent.

GET /agent-properties

Get all property listings for a specific agent.

Try this endpoint now

Subscribe to BayutAPI on RapidAPI and start making requests in minutes.

Get API Key View Pricing