Get detailed information about a specific property listing. - BayutAPI Documentation

GET /property-details

Get detailed information about a specific property listing.

Description

The property-details endpoint returns comprehensive information about a single property listing, including full descriptions, all photos, floor plans, video tours, 360-degree tours, amenities, and agent contact details.

This endpoint provides significantly more detail than the search results, including the complete image gallery, detailed amenity lists, nearby locations, and property permit information. It is essential for building property detail pages in your application.

Use the externalID from search results to fetch the complete details of any listing.

Parameters

Name	Type	Required	Description	Example
`external_id`	string	Required	The external ID of the property to retrieve details for. Obtained from search-property results.	`7891234`
`langs`	string	Optional	Language code for response. Available: 'en', 'ar', 'ru', 'zh'. Default: 'en'.	`en`

Code Examples

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

querystring = {
    "external_id": "7891234",
    "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/property-details?external_id=7891234&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": "7891234",
    "title": {
      "en": "Spacious 1BR | Sea View | High Floor"
    },
    "purpose": "for-sale",
    "price": 1250000,
    "currency": "AED",
    "rooms": 1,
    "baths": 2,
    "area": 850.5,
    "description": {
      "en": "Stunning 1 bedroom apartment in Marina Gate with panoramic sea views from the 35th floor."
    },
    "photos": [
      {
        "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/photo1.jpg",
        "title": "Living Room"
      }
    ],
    "location": [
      {
        "name": "UAE"
      },
      {
        "name": "Dubai"
      },
      {
        "name": "Dubai Marina"
      },
      {
        "name": "Marina Gate"
      }
    ],
    "geography": {
      "lat": 25.0805,
      "lng": 55.1403
    },
    "agency": {
      "name": "Premium Properties LLC",
      "externalID": "5678"
    },
    "contactName": "John Smith",
    "phoneNumber": "+971501234567",
    "amenities": [
      "Central A/C",
      "Balcony",
      "Built in Wardrobes",
      "Gym",
      "Pool",
      "Parking"
    ],
    "permitNumber": "7654321",
    "completionStatus": "completed",
    "furnishingStatus": "unfurnished",
    "createdAt": 1709251200,
    "updatedAt": 1709337600
  }
}

Use Cases

Build property detail pages with full image galleries
Display complete property information in mobile apps
Extract detailed property data for market analysis
Show agent contact information for lead generation

Related Endpoints

GET /search-property

Search for properties with advanced filters.

GET /agent-details

Get detailed profile information for a specific agent.

GET /agency-details

Get detailed profile information for a specific agency.

Try this endpoint now

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

Get API Key View Pricing