Search for agents by their name. - BayutAPI Documentation

GET /agent-search-by-name

Search for agents by their name.

Description

The agent-search-by-name endpoint allows you to find specific real estate agents by searching their name. This is useful when users know the agent they want to work with and need to find their profile and listings.

Results include the same profile data as the general agent search, including agency affiliation and listing counts. Use the returned externalID with agent-details and agent-properties for full profile information.

This endpoint supports partial name matching, so users can search with just a first or last name.

Parameters

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

Code Examples

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

querystring = {
    "query": "John Smith",
    "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/agent-search-by-name?query=John%20Smith&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": {
    "agents": [
      {
        "externalID": "4567",
        "name": "John Smith",
        "photo": {
          "url": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/agent-photo.jpg"
        },
        "agency": {
          "name": "Premium Properties LLC",
          "externalID": "5678"
        },
        "propertiesCount": 42,
        "languages": [
          "English",
          "Arabic"
        ]
      }
    ],
    "total": 3,
    "page": 1,
    "totalPages": 1,
    "hitsPerPage": 20
  }
}

Use Cases

Find a specific agent by name for referral tracking
Build agent search-by-name functionality in portals
Verify agent identity before contacting
Look up agents mentioned in reviews or recommendations

Related Endpoints

GET /agent-search

Search for real estate agents by location and specialization.

GET /agent-details

Get detailed profile information for a specific agent.

GET /agent-properties

Get all property listings for a specific agent.

Try this endpoint now

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

Get API Key View Pricing