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

GET /agency-details

Get detailed profile information for a specific agency.

Description

The agency-details endpoint returns comprehensive information about a specific real estate agency, including their full profile, description, contact details, agent roster size, and listing statistics.

This data powers detailed agency profile pages that help users evaluate and compare agencies. The response includes direct contact information and links to the agency's listings.

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

Parameters

Name	Type	Required	Description	Example
`agency_id`	string	Required	The agency ID to retrieve details for. Get from agency-search response.	`5678`

Code Examples

curl --request GET \
  --url 'https://bayut14.p.rapidapi.com/agency-details?agency_id=5678' \
  --header 'x-rapidapi-host: bayut14.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

import requests

url = "https://bayut14.p.rapidapi.com/agency-details"

querystring = {
    "agency_id": "5678"
}

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/agency-details?agency_id=5678';

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": "5678",
    "name": "Premium Properties LLC",
    "logo": {
      "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/agency-logo.jpg"
    },
    "description": "Premium Properties LLC is a leading real estate brokerage in Dubai, specializing in luxury properties across Dubai Marina, Palm Jumeirah, and Downtown Dubai. Established in 2010, we have a team of 35+ experienced agents.",
    "phone": "+97142345678",
    "email": "info@premiumproperties.ae",
    "website": "https://premiumproperties.ae",
    "agentsCount": 35,
    "propertiesCount": 890,
    "propertiesForSale": 520,
    "propertiesForRent": 370,
    "location": {
      "name": "Dubai Marina, Dubai"
    },
    "licenses": [
      {
        "number": "ORN-12345",
        "authority": "RERA"
      }
    ]
  }
}

Use Cases

Display full agency profiles with branding and contact info
Build agency comparison and review platforms
Verify agency licensing and credentials
Show agency statistics for trust-building

Related Endpoints

GET /agency-search

Search for real estate agencies by location.

GET /agency-agents

Get all agents belonging to a specific agency.

GET /agency-properties

Get all property listings managed by a specific agency.

Try this endpoint now

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

Get API Key View Pricing