Get all property listings managed by a specific agency. - BayutAPI Documentation

GET /agency-properties

Get all property listings managed by a specific agency.

Description

The agency-properties endpoint returns all active property listings managed by a specific agency. This allows you to showcase an agency's complete inventory and portfolio.

Results follow the same structure as the search-property endpoint, with full property details including pricing, images, and location data. The endpoint supports pagination for agencies with large portfolios.

Use this to build agency portfolio pages, analyze agency market share, or create agency-specific property feeds.

Parameters

Name	Type	Required	Description	Example
`agency_external_id`	string	Required	The agency external ID whose properties to retrieve. Get from agency-search or agency-search-by-name response (externalID field).	`5678`
`page`	integer	Optional	Page number for paginated results, starting from 1. Results per page: 25.	`1`
`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/agency-properties?agency_external_id=5678&page=1&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/agency-properties"

querystring = {
    "agency_external_id": "5678",
    "page": "1",
    "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/agency-properties?agency_external_id=5678&page=1&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": {
    "properties": [
      {
        "externalID": "7891234",
        "title": {
          "en": "Spacious 1BR | Sea View | High Floor"
        },
        "purpose": "for-sale",
        "price": 1250000,
        "currency": "AED",
        "rooms": 1,
        "baths": 2,
        "area": 850.5,
        "coverPhoto": {
          "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/example.jpg"
        },
        "location": [
          {
            "name": "UAE"
          },
          {
            "name": "Dubai"
          },
          {
            "name": "Dubai Marina"
          }
        ],
        "contactName": "John Smith"
      }
    ],
    "total": 520,
    "page": 1,
    "totalPages": 21,
    "hitsPerPage": 25
  }
}

Use Cases

Build agency portfolio pages showing all listings
Analyze agency market share by area and property type
Create agency-branded property feeds
Track agency inventory changes over time

Related Endpoints

GET /agency-details

Get detailed profile information for a specific agency.

GET /agency-agents

Get all agents belonging to a specific agency.

GET /search-property

Search for properties with advanced filters.

Try this endpoint now

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

Get API Key View Pricing