Search agencies (Bayut) or brokers (PropertyFinder)

Search real estate agencies/brokerages by name (Bayut only) or by location (both platforms). Bayut agencies and PropertyFinder brokers represent the same concept.

GET
/search-agencies

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

platform*string
  • Data source platform
  • Bayut: searches agencies
  • PropertyFinder: searches brokers (equivalent to Bayut agencies)
Value in"bayut" | "propertyfinder"
query?string
  • Agency/broker name to search for
  • Bayut only. PropertyFinder requires location instead.
Length1 <= length <= 200
location?string
  • Location name (auto-resolved to location_id)
Length1 <= length <= 200
location_id?string
  • Platform-specific location ID from /autocomplete
page?integer
  • Page number
Default1
Range1 <= value

Header Parameters

X-RapidAPI-Host*string
Default"uae-real-estate-api.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/search-agencies?platform=bayut" \  -H "X-RapidAPI-Host: uae-real-estate-api.p.rapidapi.com"
{
  "success": true,
  "platform": "bayut",
  "data": {
    "agencies": [
      null
    ],
    "total": 0,
    "page": 0,
    "totalPages": 0,
    "hitsPerPage": 0
  }
}
{
  "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": "PLATFORM_ERROR"
}

Get properties listed by an agentGET

Get all properties listed by a specific agent. For Bayut, use the ownerID from /agent-details. For PropertyFinder, use the agent id from /search-agents.

Get agency/broker profile detailsGET

Get detailed agency/broker profile. Available for Bayut only — PropertyFinder returns a platform limitation error.