API Reference · v1.0

Documentation

Build the next generation of PropTech with the most accurate Dubai real estate data feed. RESTful, predictable, fast.

Introduction

Our platform provides a RESTful architecture for querying refined off-plan project data. We bridge the gap between complex developer databases and your high-performance frontend applications by merging data from top platforms like GenieMap and ReellyAI into a single, unified structure.

Looking to explore endpoints interactively? Open the live Swagger UI — every endpoint, parameter, and response schema, try it directly from your browser with your API key.

Authentication

Secure access is handled via headers. Every request must include your API key:

Headers

X-API-Key: "sk_live_YOUR_KEY"

GETapi.dubaipropertyleads.ae/v1/projects

List Projects

Returns a paginated list of all off-plan projects currently in the database. Supports filtering by source, name, and district.

Parameter

Type

Description

limitint (default 50)Items per page.

sourcestringFilter by data source (e.g. 'geniemap', 'reelly').

qstringFuzzy search query on project name.

Response — GET /v1/projects?limit=1

{
  "total": 2793,
  "page": 1,
  "limit": 1,
  "max_pages": 2793,
  "items": [
    {
      "id": "7309",
      "name": "BEYOND BY OMNIYAT \"Passo Bella\" NEW LAUNCH",
      "description": null,
      "status": null,
      "location": {
        "lat": 25.114980825088,
        "lng": 55.109826819256,
        "district_id": 49
      },
      "cover_image": null,
      "images": [],
      "brochure_url": null,
      "floor_plans": [],
      "price": null,
      "payment_plan": null,
      "completion_date": null,
      "amenities": [],
      "developer": {
        "developer_id": "988",
        "name": "Beyond by Omniyat",
        "logo": {
          "url": "https://api.dubaipropertyleads.ae/v1/proxy/image?token=...",
          "conversions": null
        },
        "overview": "Beyond by Omniyat is one of the innovative developers in Dubai..."
      },
      "created_at": "2026-01-09T15:02:12.883679Z",
      "updated_at": "2026-01-09T20:28:13.776081Z"
    }
  ]
}

GETapi.dubaipropertyleads.ae/v1/projects/{id}

Project Details

Returns a Unified Project Object regardless of the data source. Includes floor plans, rewritten proxy image URLs, pricing, and developer details.

Response — GET /v1/projects/7309

{
  "id": "7309",
  "name": "BEYOND BY OMNIYAT \"Passo Bella\" NEW LAUNCH",
  "description": "An exclusive residential development on Palm Jumeirah offering a limited collection of luxury residences, penthouses, and beachfront mansions...",
  "status": null,
  "location": {
    "lat": 25.114980825088,
    "lng": 55.109826819256,
    "district_id": 49
  },
  "cover_image": null,
  "images": [],
  "brochure_url": null,
  "floor_plans": [],
  "price": null,
  "payment_plan": null,
  "completion_date": null,
  "amenities": [],
  "developer": {
    "developer_id": "988",
    "name": "Beyond by Omniyat",
    "logo": {
      "url": "https://api.dubaipropertyleads.ae/v1/proxy/image?token=...",
      "conversions": null
    },
    "overview": "Beyond by Omniyat is one of the innovative developers in Dubai..."
  },
  "created_at": "2026-01-09T15:02:16.209297Z",
  "updated_at": "2026-01-09T20:28:15.118396Z",
  "configurations": [],
  "features": [],
  "metrics": null,
  "service_charge": null,
  "handover_year": null
}

GETapi.dubaipropertyleads.ae/v1/developers

List Developers

Fetch a paginated list of all real estate developers. Data is cleaned and deduplicated from multiple sources.

Example request

curl "https://api.dubaipropertyleads.ae/v1/developers?q=emaar&limit=10"

Response — GET /v1/developers?limit=1

{
  "total": 1106,
  "page": 1,
  "limit": 1,
  "max_pages": 1106,
  "items": [
    {
      "developer_id": "50186",
      "name": "Credo Investments",
      "logo": {
        "url": "https://api.dubaipropertyleads.ae/v1/proxy/image?token=...",
        "conversions": null
      },
      "overview": "Credo Investments FZE one of the Dubai's leading luxury and premium developers, develops innovative and creative living homes for the luxury lifestyle...",
      "payload": {
        "name": "Credo Investments",
        "email": "info@credouae.com",
        "phone": null,
        "status": "active",
        "offices": [
          {
            "id": 824,
            "city": null,
            "name": null,
            "email": null,
            "address": "First Floor, Le Solarium Building, Dubai Silicon Oasis, Dubai, UAE",
            "country": null,
            "is_main": false,
            "developer": 186,
            "working_hours": [
              { "days": "Monday - Friday", "time_range": "9 AM - 7 PM" },
              { "days": "Saturday - Sunday", "time_range": "Day off" }
            ]
          }
        ],
        "website": "https://www.credouae.com/",
        "social_links": []
      },
      "created_at": "2025-12-24T06:17:14.186149Z",
      "updated_at": "2026-05-26T14:53:35.997110Z"
    }
  ]
}

GETapi.dubaipropertyleads.ae/v1/districts

List Districts

Retrieve standard area and district mappings used across all project locations.

Response — GET /v1/districts?limit=1

{
  "total": 368,
  "limit": 1,
  "offset": 0,
  "items": [
    {
      "id": 304,
      "name": "Al Nasserya",
      "description": "",
      "metrics": {
        "avgPricePerSquare": null,
        "avgPricePerSquareFor1BR": null,
        "avgPricePerSquareFor2BR": null,
        "avgPricePerSquareForStudio": null
      }
    }
  ]
}

Ready to build?

Try every endpoint live, right now.

Open the playground, paste your API key, and start hitting real data. No internal reviews, no waiting.

Launch Playground Open Swagger UI