Laravel Integration Guide

1. 1

   Visit the Contact Page

   Go to dynamicweblab.com/contact and fill out the form requesting API access.

2. 2

   Receive Your Token

   You will receive a Bearer token via email within 24 hours.

3. 3

   Store It Securely

   Add your token to your .env file. Never commit API keys to version control.

Create a New Laravel Project

composer create-project laravel/laravel dubai-property-api
cd dubai-property-api

Required Packages

# Guzzle is included with Laravel by default
# If you need to install or update it:
composer require guzzlehttp/guzzle

Register a Guzzle Client in a Service Provider

File: app/Providers/AppServiceProvider.php

<?php

namespace App\Providers;

use GuzzleHttp\Client;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        $this->app->singleton('real-estate-api', function () {
            return new Client([
                'base_uri' => config('services.real_estate_api.base_url'),
                'timeout' => 30,
                'headers' => [
                    'Authorization' => 'Bearer ' . config('services.real_estate_api.key'),
                    'Content-Type'  => 'application/json',
                    'Accept'        => 'application/json',
                ],
            ]);
        });
    }
}

Property transactions from the Dubai Land Department. Filter by type, area, price range, and date.

$response = $this->api->getTransactions([
    'type'      => 'sale',
    'area'      => 'Palm Jumeirah',
    'min_price' => 1000000,
    'limit'     => 20,
]);

$transactions = $response['data'];
$nextCursor   = $response['next_cursor'] ?? null;

All 356 Dubai areas with building counts, stats, and project data.

$areas = $this->api->getAreas();
// Returns: { "areas": [...], "total": 356 }

3,517 projects with stats, buildings, transactions, and price trends.

$projects = $this->api->getProjects([
    'developer' => 'Emaar',
    'limit'     => 10,
]);

Service-Level Error Handling

<?php

namespace App\Services;

use GuzzleHttp\Client;
use GuzzleHttp\Exception\ClientException;
use GuzzleHttp\Exception\ServerException;
use Illuminate\Support\Facades\Log;

class RealEstateApiService
{
    private Client $client;

    public function __construct(Client $client)
    {
        $this->client = $client;
    }

    private function get(string $endpoint, array $params = []): array
    {
        try {
            $response = $this->client->get($endpoint, [
                'query' => array_filter($params, fn ($v) => $v !== null && $v !== ''),
            ]);

            return json_decode($response->getBody()->getContents(), true);
        } catch (ClientException $e) {
            $status = $e->getResponse()->getStatusCode();
            $body   = json_decode($e->getResponse()->getBody()->getContents(), true);

            Log::warning('API Client Error', [
                'endpoint' => $endpoint,
                'status'   => $status,
                'message'  => $body['message'] ?? 'Unknown error',
            ]);

            throw new \RuntimeException(
                $body['message'] ?? 'API request failed',
                $status
            );
        } catch (ServerException $e) {
            Log::error('API Server Error', [
                'endpoint' => $endpoint,
                'status'   => 500,
            ]);

            throw new \RuntimeException('API service unavailable', 503);
        }
    }
}

Rate Limit Tiers

Cache in the Controller

<?php

namespace App\Http\Controllers;

use App\Services\RealEstateApiService;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\Cache;

class RealEstateController extends Controller
{
    public function __construct(
        private RealEstateApiService $api
    ) {}

    public function areas(): JsonResponse
    {
        $data = Cache::remember('api:areas', now()->addHours(24), function () {
            return $this->api->getAreas();
        });

        return response()->json($data);
    }

    public function projects(Request $request): JsonResponse
    {
        $developer = $request->query('developer');
        $cacheKey  = 'api:projects:' . md5($request->getQueryString() ?? 'all');

        $data = Cache::remember($cacheKey, now()->addHours(6), function () use ($request) {
            return $this->api->getProjects($request->only([
                'developer', 'area', 'limit', 'cursor',
            ]));
        });

        return response()->json($data);
    }

    public function developers(): JsonResponse
    {
        $data = Cache::remember('api:developers', now()->addHours(24), function () {
            return $this->api->getDevelopers();
        });

        return response()->json($data);
    }
}

ImportTransactionsJob

File: app/Jobs/ImportTransactionsJob.php

<?php

namespace App\Jobs;

use App\Services\RealEstateApiService;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Log;

class ImportTransactionsJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;

    public function handle(RealEstateApiService $api): void
    {
        $cursor = null;
        $total  = 0;

        do {
            $params = ['limit' => 100];
            if ($cursor) {
                $params['cursor'] = $cursor;
            }

            $data   = $api->getTransactions($params);
            $items  = $data['data'] ?? [];
            $total += count($items);

            foreach ($items as $transaction) {
                // Process each transaction
                // e.g., upsert into local database
                Log::info('Imported transaction', ['id' => $transaction['id']]);
            }

            $cursor = $data['next_cursor'] ?? null;

            // Respect rate limits
            usleep(650000); // 650ms between batches
        } while ($cursor);

        Cache::forget('api:transactions');
        Log::info('Import complete', ['total' => $total]);
    }
}

Controller Rendering a Blade View

<?php

namespace App\Http\Controllers;

use App\Services\RealEstateApiService;
use Illuminate\Http\Request;
use Illuminate\View\View;
use Illuminate\Support\Facades\Cache;

class PropertyPageController extends Controller
{
    public function index(Request $request, RealEstateApiService $api): View
    {
        $transactions = Cache::remember('page:transactions', now()->addHours(1), function () use ($api) {
            return $api->getTransactions(['limit' => 12])['data'] ?? [];
        });

        return view('properties.index', compact('transactions'));
    }

    public function show(string $id, RealEstateApiService $api): View
    {
        $area = Cache::remember("page:area:{$id}", now()->addHours(24), function () use ($api, $id) {
            return $api->getArea($id);
        });

        return view('properties.show', compact('area'));
    }
}

resources/views/properties/index.blade.php

@extends('layouts.app')

@section('title', 'Dubai Property Transactions')

@section('content')
<h1 class="text-3xl font-bold mb-6">Recent Transactions</h1>

<div class="grid grid-cols-1 md:grid-cols-3 gap-6">
    @forelse ($transactions as $transaction)
        <div class="bg-slate-800 rounded-xl p-6 border border-slate-700">
            <h2 class="font-bold text-lg mb-2">
                {{ $transaction['property_name'] ?? 'N/A' }}
            </h2>
            <p class="text-emerald-400 text-xl font-semibold mb-1">
                AED {{ number_format($transaction['price_aed'] ?? 0) }}
            </p>
            <p class="text-slate-400 text-sm">
                {{ $transaction['area_sqft'] ?? 0 }} sqft
                &middot; {{ $transaction['location']['area'] ?? '' }}
            </p>
            <p class="text-slate-500 text-xs mt-2">
                {{ $transaction['transaction_date'] ?? '' }}
            </p>
        </div>
    @empty
        <p class="text-slate-400 col-span-3">No transactions found.</p>
    @endforelse
</div>
@endsection