Bayut Egypt API (1.0)

Download OpenAPI specification:Download

Bayut Egypt API is a property finder API that allows you to search for real estate properties in the Egypt by scraping data from Bayut's Website (https://bayut.eg).

You can gather data related to properties, agencies, agents, amenities, etc…

Locations Search

Search for locations (city, community, sub-community, etc.) by name.

query Parameters
query
required
string
Example: query=cai

Text to search for in location names.

page
integer
Example: page=0

Page number for paginated results (0-based).

langs
string
Example: langs=ar

Language code for translated fields (e.g., “ar”).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "query": "cai",
  • "page": 0
}

Properties Search

Search properties on Bayut Egypt using filters like location, price, and features.

query Parameters
page
integer
Example: page=0

Page number for results (0-based). Use to paginate results.

langs
string
Example: langs=ar

Language code for text fields (e.g. "ar" for Arabic). Affects title/keywords when available.

Request Body schema: application/json
purpose
string

Purpose of search (e.g., for-sale, for-rent).

category
string

Property category/subtype (e.g., apartments, villas).

locations_ids
Array of integers

List of location IDs to search within.

index
string

Index or sorting preset (e.g., popular, newest).

is_completed
boolean

Filter to only show completed properties when true.

agent_id
string

Filter results to a specific agent by ID.

agency_id
string

Filter results to a specific agency by ID.

rooms
Array of integers

List of acceptable bedroom counts (e.g., [1,2,3]).

baths
Array of integers

List of acceptable bathroom counts.

price_min
integer

Minimum price filter.

price_max
integer

Maximum price filter.

has_video
boolean

If true, only include listings with video.

has_360_tour
boolean

If true, only include listings with 360 tours.

has_floorplan
boolean

If true, only include listings with floorplans.

area_min
integer

Minimum built-up area (in same unit as listing).

area_max
integer

Maximum built-up area.

Responses

Request samples

Content type
application/json
{
  • "purpose": "for-sale",
  • "category": "apartments",
  • "locations_ids": [
    ],
  • "index": "popular",
  • "is_completed": false,
  • "agent_id": "00000000-477d-801f-8000-024213371337",
  • "agency_id": "5000974",
  • "rooms": [
    ],
  • "baths": [
    ],
  • "price_min": 5000000,
  • "price_max": 30000000,
  • "has_video": false,
  • "has_360_tour": false,
  • "has_floorplan": false,
  • "area_min": 70,
  • "area_max": 230
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "page": 0
}

Property Info

Get full details of a single property by its ID.

path Parameters
property_id
required
string
Example: 502820032

Unique ID of the property you want to fetch.

query Parameters
langs
string
Example: langs=ar

Language code for translated fields (e.g., "ar").

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "price": 6000000,
  • "media": {},
  • "location": {
    },
  • "score": 75,
  • "contact_methods": [
    ],
  • "legal": {
    },
  • "city_level_score": 1,
  • "type": {
    },
  • "indy_score": 860,
  • "agent": {
    },
  • "payment": {
    },
  • "description": "Apartment for sale in Taj City Compound...",
  • "id": 502820008,
  • "area": {
    },
  • "purpose": "for-sale",
  • "title": "Apartment for sale in Taj City direct on Suez Road( 50% discount)",
  • "verification": {
    },
  • "reference_number": "5000974-SfhNWs",
  • "details": {
    },
  • "location_purpose_tier": 0,
  • "amenities": [
    ],
  • "agency": {},
  • "description_ar": "<strong>شقة للبيع في كمبوند تاج سيتي – التجمع الأول</strong> ...",
  • "title_ar": "شقتك امام مطارالقاهرة مباشرة...",
  • "floorplans": [
    ]
}

Agencies by Name

Search for real estate agencies by name.

query Parameters
query
required
string
Example: query=el

Agency name or partial name to search for.

page
string
Example: page=0

Page number for paginated results (0-based).

lang
string
Example: lang=ar

Language code for translated fields (e.g., "ar").

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "query": "el",
  • "page": 0
}

Agency Info

Get full details about a specific real estate agency by its ID.

path Parameters
agency_id
required
string
Example: 5001379

Unique ID of the agency.

query Parameters
langs
string
Example: langs=ar

Language code for translated fields (e.g., "ar").

Responses

Response samples

Content type
application/json
{
  • "is_featured": false,
  • "description_ar": "El Arabia Real Estate",
  • "name_ar": "El Arabia Real Estate",
  • "product_score": 2,
  • "description": "El Arabia Real Estate",
  • "base_location": "",
  • "base_location_ar": "",
  • "stats": {
    },
  • "contact_methods": [
    ],
  • "short_number": 0,
  • "id": 16258,
  • "base_locations": [
    ],
  • "licenses": [
    ],
  • "agents_count": 2,
  • "phone_numbers": {
    },
  • "slug": "el-arabia-real-estate-16258",
  • "product": "premium",
  • "name": "El Arabia Real Estate"
}

Agents by Name

Search for real estate agents by their name.

query Parameters
query
required
string
Example: query=elsayed

Name or partial name of the agent to search for.

page
string
Example: page=0

Page number for paginated results (0-based).

langs
string
Example: langs=ar

Language code for translated fields (e.g., "ar").

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 21,
  • "query": "elsayed",
  • "page": 0
}

Amenities Search

Returns a list of amenities that match the search query.

query Parameters
query
required
string
Example: query=air

Search term for filtering amenities

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 2,
  • "query": "air"
}