Get property transaction history for market analysis. - BayutAPI Documentation

GET /transactions

Get property transaction history for market analysis.

Description

The transactions endpoint provides historical property transaction data (sales and rentals) for Dubai and the UAE. This data comes from official DLD (Dubai Land Department) records and is essential for market analysis, pricing trends, and investment research.

Filter transactions by purpose, property type, location, completion status, time period, bedrooms, price range, and area. Results include transaction details such as price, area, location, and date.

Use this endpoint to build market analytics dashboards, pricing trend tools, and investment analysis platforms.

Parameters

Name	Type	Required	Description	Example
`purpose`	string	Required	Transaction type: 'for-sale' for sale transactions or 'for-rent' for rental transactions.	`for-sale`
`page`	integer	Optional	Page number for paginated results, starting from 1. Results per page: 20.	`1`
`category_ids`	string	Optional	Comma-separated category names or external IDs. Names: 'residential', 'commercial', 'apartments', 'villas', 'townhouses'. IDs: '1' (residential), '2' (commercial), '4' (apartments).	`residential`
`location_ids`	string	Optional	Comma-separated location external IDs from the autocomplete endpoint.	`5003`
`completion_status`	string	Optional	Filter by completion status: 'any' (default), 'completed', 'under-construction'.	`any`
`time_period`	string	Optional	Time period for transaction data: '1m', '3m', '6m', '12m' (default), '24m'.	`12m`
`beds`	string	Optional	Comma-separated bedrooms filter. Use '0' for studio.	`0,1,2,3`
`price_min`	integer	Optional	Minimum price in AED.	`200000`
`price_max`	integer	Optional	Maximum price in AED.	`5000000`
`area_min`	number	Optional	Minimum area in square feet.	`800`
`area_max`	number	Optional	Maximum area in square feet.	`5000`
`sort_by`	string	Optional	Sort order: 'date_desc' (default), 'date_asc', 'price_desc', 'price_asc', 'area_desc', 'area_asc'.	`date_desc`

Code Examples

curl --request GET \
  --url 'https://bayut14.p.rapidapi.com/transactions?purpose=for-sale&location_ids=5003&time_period=12m&page=1' \
  --header 'x-rapidapi-host: bayut14.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

import requests

url = "https://bayut14.p.rapidapi.com/transactions"

querystring = {
    "purpose": "for-sale",
    "location_ids": "5003",
    "time_period": "12m",
    "page": "1"
}

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/transactions?purpose=for-sale&location_ids=5003&time_period=12m&page=1';

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": {
    "hits": [
      {
        "transactionId": "TX-12345",
        "purpose": "for-sale",
        "price": 1500000,
        "area": 1200,
        "location": "Dubai Marina",
        "category": "apartments",
        "rooms": 2,
        "completionStatus": "completed",
        "date": "2025-12-15"
      }
    ],
    "nbHits": 4500,
    "page": 1,
    "nbPages": 225
  }
}

Use Cases

Build market analytics dashboards with historical data
Analyze pricing trends across UAE communities
Compare transaction volumes by property type
Track investment performance with historical sales data

Related Endpoints

GET /search-property

Search for properties with advanced filters.

GET /autocomplete

Get location suggestions based on a search query.

Try this endpoint now

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

Get API Key View Pricing