Happy Endpoint

Search real estate agents by filters

Search for real estate agents in Dubai/UAE. Filter by location, category (residential/commercial), purpose (sale/rent), TruBroker status, and agent languages.

GET
/agent-search

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

location_ids?string
  • Comma-separated location external IDs
  • Get IDs from /autocomplete endpoint (externalID field)
purpose?string
  • Transaction type to filter agents by
Default"for-sale"
Value in"for-sale" | "for-rent"
category?string
  • Property category the agent specializes in
Default"residential"
Value in"residential" | "commercial"
page?integer
  • Page number (starts from 1)
  • Results per page: 40
Default1
Range1 <= value
langs?string
  • Language code: en, ar, ru, zh
Default"en"
completion_status?string
  • Filter agents by completion status of their listings
Default"any"
Value in"any" | "completed" | "under-construction"

Header Parameters

X-RapidAPI-Host*string
Default"bayut14.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/agent-search" \  -H "X-RapidAPI-Host: bayut14.p.rapidapi.com"
{
  "success": true,
  "data": null
}
{
  "success": false,
  "message": "Invalid request: Missing required parameter",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "Service temporarily unavailable. Please try again later.",
  "error": "API_ERROR"
}