Search for agencies by their name. - BayutAPI Documentation

GET /agency-search-by-name

Search for agencies by their name.

Description

The agency-search-by-name endpoint allows you to find specific real estate agencies by searching their name. This is useful when users are looking for a particular agency or want to verify an agency's profile.

The endpoint supports partial name matching, making it easy to find agencies even with incomplete search terms. Results include the same profile data as the general agency search.

Use the returned externalID with agency-details, agency-agents, and agency-properties for complete agency information.

Parameters

Name	Type	Required	Description	Example
`query`	string	Required	The agency name to search for. Supports partial matching.	`Premium Properties`
`page`	integer	Optional	Page number for paginated results, starting from 1. Results per page: 80.	`1`
`langs`	string	Optional	Language code: 'en', 'ar', 'ru', 'zh'. Default: 'en'.	`en`

Code Examples

curl --request GET \
  --url 'https://bayut14.p.rapidapi.com/agency-search-by-name?query=Premium%20Properties&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-search-by-name"

querystring = {
    "query": "Premium Properties",
    "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-search-by-name?query=Premium%20Properties&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": {
    "agencies": [
      {
        "externalID": "5678",
        "name": "Premium Properties LLC",
        "logo": {
          "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/agency-logo.jpg"
        },
        "agentsCount": 35,
        "propertiesCount": 890,
        "phone": "+97142345678"
      }
    ],
    "total": 2,
    "page": 1,
    "totalPages": 1,
    "hitsPerPage": 80
  }
}

Use Cases

Find a specific agency by name
Verify agency identity before engagement
Build agency search functionality in applications
Look up agencies mentioned in reviews or listings

Related Endpoints

GET /agency-search

Search for real estate agencies by location.

GET /agency-details

Get detailed profile information for a specific agency.

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