Get detailed profile information for a specific agent. - BayutAPI Documentation

GET /agent-details

Get detailed profile information for a specific agent.

Description

The agent-details endpoint returns comprehensive information about a specific real estate agent, including their full profile, agency affiliation, experience, languages spoken, and specializations.

This data is ideal for building detailed agent profile pages that help users decide which agent to contact. The response includes direct contact information and listing statistics.

Use the externalID obtained from agent-search or agent-search-by-name to retrieve full details.

Parameters

Name	Type	Required	Description	Example
`agent_id`	string	Required	The external ID of the agent to retrieve details for. Get from agent-search or agent-search-by-name response.	`4567`
`langs`	string	Optional	Comma-separated language codes: 'en', 'ar', 'ru', 'zh'. Default: 'en'.	`en`

Code Examples

curl --request GET \
  --url 'https://bayut14.p.rapidapi.com/agent-details?agent_id=4567&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-details"

querystring = {
    "agent_id": "4567",
    "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-details?agent_id=4567&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": {
    "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"
      }
    },
    "phone": "+971501234567",
    "email": "john@premiumproperties.ae",
    "propertiesCount": 42,
    "propertiesForSale": 28,
    "propertiesForRent": 14,
    "languages": [
      "English",
      "Arabic",
      "Hindi"
    ],
    "experience": 8,
    "specializations": [
      "Luxury apartments",
      "Waterfront properties"
    ],
    "areasOfExpertise": [
      "Dubai Marina",
      "JBR",
      "Palm Jumeirah"
    ]
  }
}

Use Cases

Display full agent profiles with contact information
Build agent comparison pages
Show agent expertise and specializations
Enable direct contact with agents from your platform

Related Endpoints

GET /agent-search

Search for real estate agents by location and specialization.

GET /agent-search-by-name

Search for agents by their name.

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