API Documentation

Introduction

PropertyfinderAPI provides RESTful endpoints for accessing UAE real estate data. All responses are JSON. Whether you are building a property search portal, a market analytics dashboard, or an agent directory, PropertyfinderAPI gives you access to hundreds of thousands of listings, agent profiles, agency data, and more.

Base URL

All API requests should be made to the following base URL:

Authentication

PropertyfinderAPI is hosted on RapidAPI. Every request must include two authentication headers:

• x-rapidapi-key — Your unique API key from RapidAPI.
• x-rapidapi-host — Must be set to propertyfinder14.p.rapidapi.com.

{
  "x-rapidapi-key": "YOUR_API_KEY",
  "x-rapidapi-host": "propertyfinder14.p.rapidapi.com"
}

Rate Limits

Rate limits depend on your RapidAPI subscription plan. The free tier includes a limited number of requests per month, while paid plans offer higher quotas and faster response times. Check your RapidAPI dashboard for your current plan limits and usage. If you exceed your rate limit, the API will return a 429 Too Many Requests response.

Response Format

All responses are returned as JSON. Successful list responses follow this structure with pagination metadata:

{
  "success": true,
  "data": {
    "properties": [...],
    "total": 2340,
    "page": 1,
    "totalPages": 98,
    "hitsPerPage": 24
  }
}

Endpoints

Error Handling

When an error occurs, the API returns a JSON response with a status code, error type, and a human-readable message. Always check the HTTP status code and handle errors gracefully in your application.

// 400 Bad Request
{
  "success": false,
  "message": "Invalid request: Missing required parameter",
  "error": "VALIDATION_ERROR"
}

// 500 Internal Server Error
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}

// 502 Service Unavailable
{
  "success": false,
  "message": "Service temporarily unavailable. Please try again later.",
  "error": "API_ERROR"
}

Quick Reference