Happy Endpoint

Get properties listed by an agent

Get all properties listed by a specific real estate agent. Uses the agent's owner ID (not external ID) to fetch their property listings. Get the owner ID from the agent-details response.

GET
/agent-properties

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

owner_id*string
  • Agent owner ID
  • Get from /agent-details response (ownerID field)
  • This is different from externalID — the ownerID links agents to their listings
Length1 <= length
page?integer
  • Page number (starts from 1)
  • Results per page: 25
Default1
Range1 <= value
langs?string
  • Comma-separated language codes: en, ar, ru, zh
Default"en"

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-properties?owner_id=2243594" \  -H "X-RapidAPI-Host: bayut14.p.rapidapi.com"
{
  "success": true,
  "data": {
    "properties": [
      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": "API_ERROR"
}

Get agent detailsGET

Get detailed information about a specific real estate agent by their external ID. Returns agent profile, contact info, badges, stats, and service areas.

Search agencies by locationGET

Search for real estate agencies in Dubai/UAE by location. Returns agencies with active listings in the specified location.