Bayut

Agency Details API

GET https://api.dataextractorpro.com/agency-details ⚡ 1 Credit

The Agency Details API provides comprehensive information about real estate agencies, including contact details, office locations, and active property listings.

Overview

This API endpoint allows programmatically extracting clean, structured data for Bayut.

Authentication

Include your API key in the request header:

x-api-key: YOUR_API_KEY
Request Parameters
Parameter Type Required Description & Allowed Values Try Parameter
agency_externalId
agency_externalId
text Required
Value for parameter agency_externalId can be obtained from the agency search endpoint.
Code Examples

                                
                                
                                
                            
Error Responses
400 Invalid Parameters
One or more required parameters are missing or invalid.
{
    "status": "error",
    "message": "Parameter 'q' is required"
}
401 Unauthorized
Invalid or missing API key in x-api-key header.
{
    "status": "error",
    "message": "Invalid API key"
}
429 Rate Limit / Quota Exceeded
API key usage quota has been exhausted.
{
    "status": "error",
    "message": "Usage limit reached"
}
500 Internal Server Error
An unexpected server error occurred during extraction.
{
    "status": "error",
    "message": "Internal extraction error"
}