# Homepage API Requests - Design Review (Updated) ## ✅ Changes Made ### Restructured Sections: 1. **`benefits`** - Now includes section-level data (title, description, button) + cards array 2. **`services`** - Now includes section-level data (title, description, button) + cards array 3. **`market_insights`** - Added button_link field 4. **`market_report`** - Now pulls from database fields 5. **`property_exposure`** - Now pulls from database fields 6. **`trust_section`** - Now pulls from database fields 7. **`final_cta`** - NEW section added (title, description, image, button) --- ## Homepage Main Endpoint ### Request Details - **Method:** GET - **URL:** `http://127.0.0.1:8000/api/v1/homepage` - **Base URL:** `{{base_url}}/homepage` (where `base_url = http://127.0.0.1:8000/api/v1`) - **Authentication:** None required - **Response Type:** JSON --- ## Updated Response Structure ```json { "hero": { "title": "WHERE EXPERIENCE MEETS DISTINCTION", "description": "Your trusted partner in Abu Dhabi real estate.", "background_image": [ "https://images.unsplash.com/photo-1512917774080-9991f1c4c750?auto=format&fit=crop&w=1600&q=80" ], "stats": [ { "label": "Successful Transaction", "value": "150K" }, { "label": "Trusted Clients", "value": "2,500" }, { "label": "Property Advisors", "value": "100" }, { "label": "Access Buyers", "value": "200" } ], "search": { "location_placeholder": "Location", "transaction_type": ["Buy", "Rent"], "button_text": "Search" } }, "about": { "title": "About Section Title", "description": "About section description", "image": "image_url", "button_text": "Button Text", "button_link": "Button Link" }, "global": { "title": "Global Section Title", "subtitle": "Global Section Subtitle", "cards": [ { "icon": "icon_url_1", "title": "Card 1 Title", "description": "Card 1 Description" }, { "icon": "icon_url_2", "title": "Card 2 Title", "description": "Card 2 Description" }, { "icon": "icon_url_3", "title": "Card 3 Title", "description": "Card 3 Description" }, { "icon": "icon_url_4", "title": "Card 4 Title", "description": "Card 4 Description" } ] }, "statistics": [ { "label": "Successful Transaction", "value": "150K" }, { "label": "Trusted Clients", "value": "2,500" }, { "label": "Property Advisors", "value": "100" }, { "label": "Access Buyers", "value": "200" } ], "trust_section": { "title": "TRUST, BUILT OVER TIME", "image": "https://images.unsplash.com/photo-1551836022-d5d88e9218df?auto=format&fit=crop&w=1200&q=80", "description": "SINCE 2004, GUIDING YOU WITH CONFIDENCE THROUGH EVERY STEP OF YOUR REAL ESTATE JOURNEY IN ABU DHABI.", "extended_description": "For over two decades, we have grown alongside Abu Dhabi's real estate market understanding its cycles, tracking its shifts, and identifying where real opportunities lie." }, "off_plan_properties": [ { "badge": "Exclusive", "price": "From AED 4.0M", "title": "JW Marriott Marqui Building", "address": "58 Hullbrook Road, Billesley, B13 OLA", "developer": "EMAAR", "specs": ["3 Beds", "2 Bathrooms", "5×7 m²"], "image": "https://images.unsplash.com/photo-1512917774080-9991f1c4c750?auto=format&fit=crop&w=1200&q=80" } ], "featured_properties": { "properties": [ { "badge": "Exclusive", "price": "From AED 4.0M", "title": "JW Marriott Marqui Building", "address": "58 Hullbrook Road, Billesley, B13 OLA", "developer": "EMAAR", "specs": ["3 Beds", "2 Bathrooms", "5×7 m²"], "image": "https://images.unsplash.com/photo-1512917774080-9991f1c4c750?auto=format&fit=crop&w=1200&q=80" } ] }, "market_insights": { "title": "YOUR GUIDE REAL ESTATE MARKET", "subtitle": "Abu Dhabi property insights", "description": "Stay ahead with clear, data-driven insights into Abu Dhabi's real estate market...", "button_text": "SUBSCRIBE", "image": "https://images.unsplash.com/photo-1512453979798-5ea266f8880c?auto=format&fit=crop&w=1200&q=80" }, "market_report": { "title": "ABU DHABI RESIDENTIAL MARKET REPORT 2026", "description": "A comprehensive overview of Abu Dhabi's residential market performance...", "image": "https://images.unsplash.com/photo-1448630360428-65456885c650?auto=format&fit=crop&w=1200&q=80" }, "property_exposure": { "title": "YOUR PROPERTY, POSITIONED FOR MAXIMUM EXPOSURE", "image": "https://images.unsplash.com/photo-1460317442991-0ec209397118?auto=format&fit=crop&w=1200&q=80", "description": "When you choose to sell or rent with us, your property goes beyond a simple listing..." }, "benefits": { "title": "EVERY PROPERTY HAS THE RIGHT BUYER, WE KNOW HOW TO REACH THEM", "description": "Our team leverages market expertise and strategic positioning to connect properties with the right buyers.", "button_text": "BOOK YOUR FREE VALUATION", "button_link": "#", "cards": [ { "title": "Market Specialists", "description": "Experienced Abu Dhabi property advisors with deep knowledge of communities, pricing trends, and buyer demand.", "image": "https://images.unsplash.com/photo-1556157382-97eda2d62296?auto=format&fit=crop&w=1200&q=80" }, { "title": "Stronger Exposure", "description": "Your property is promoted across the right channels to reach qualified buyers, tenants, and investors.", "image": "https://images.unsplash.com/photo-1522202176988-66273c2fd55f?auto=format&fit=crop&w=1200&q=80" }, { "title": "Better Results", "description": "From valuation to negotiation, we help you achieve the best possible outcome with confidence.", "image": "https://images.unsplash.com/photo-1520607162513-77705c0f0d4a?auto=format&fit=crop&w=1200&q=80" }, { "title": "Trusted Insights", "description": "Clear market guidance backed by local expertise, real demand signals, and years of experience.", "image": "https://images.unsplash.com/photo-1486406146926-c627a92ad1ab?auto=format&fit=crop&w=1200&q=80" } ] }, "services": { "title": "SERVICES DESIGNED AROUND YOUR PROPERTY JOURNEY", "description": "Comprehensive real estate solutions tailored to your unique needs.", "button_text": "BOOK YOUR FREE VALUATION", "button_link": "#", "cards": [ { "title": "Property Advisory", "description": "Expert guidance to help you navigate Abu Dhabi's real estate market with confidence — whether you're buying, selling, or investing.", "image": "https://images.unsplash.com/photo-1494526585095-c41746248156?auto=format&fit=crop&w=1200&q=80" }, { "title": "Mortgage & Financing", "description": "Access tailored financing solutions through our trusted partners, making your property purchase simple and stress-free.", "image": "https://images.unsplash.com/photo-1554224155-8d04cb21cd6c?auto=format&fit=crop&w=1200&q=80" }, { "title": "Property Management", "description": "We handle the day-to-day management of your property, ensuring it remains well-maintained, profitable, and tenant-ready.", "image": "https://images.unsplash.com/photo-1520607162513-77705c0f0d4a?auto=format&fit=crop&w=1200&q=80" }, { "title": "Marketing & Exposure", "description": "Your property is strategically marketed across the right platforms to reach qualified buyers and tenants locally and internationally.", "image": "https://images.unsplash.com/photo-1460317442991-0ec209397118?auto=format&fit=crop&w=1200&q=80" } ] }, "reviews": [ { "client_name": "Ahmed Al Mansoori", "city": "Abu Dhabi", "rating": 5, "title": "Outstanding Professional Service", "comment": "Lorem ipsum dolor sit amet, consectetur adipiscing elit..." }, { "client_name": "Sarah Thompson", "city": "London", "rating": 5, "title": "Best Real Estate Experience", "comment": "Lorem ipsum dolor sit amet, consectetur adipiscing elit..." } ], "professionally_managed": { "title": "YOUR PROPERTY, PROFESSIONALLY MANAGED", "description": "Whether you own one unit or a full portfolio...", "image": "https://images.unsplash.com/photo-1552664730-d307ca884978?auto=format&fit=crop&w=1200&q=80", "buttons": ["JOIN OUR TEAM", "EXPLORE OPPORTUNITIES"] }, "final_cta": { "title": "SINCE 2004, GUIDING YOU WITH CONFIDENCE THROUGH EVERY STEP OF YOUR REAL ESTATE JOURNEY IN ABU DHABI.", "description": "For over two decades, we have grown alongside Abu Dhabi's real estate market. Let us guide you to success.", "image": "final_cta_image_url", "button_text": "GET STARTED", "button_link": "#" }, "careers": { "section_label": "Careers Section Label", "title": "Careers Title", "images": ["image_url"], "button_text": "Button Text", "button_link": "Button Link" }, "contact": { "title": "Contact Title", "title_highlight": "Highlighted Text", "description": "Contact Description", "form": { "name_placeholder": "Your Name", "email_placeholder": "Your Email", "phone_placeholder": "Your Phone", "interest_placeholder": "Your Interest", "message_placeholder": "Your Message", "button_text": "Send Message" } }, "newsletter": { "title": "Newsletter Title", "description": "Newsletter Description", "image": "newsletter_image_url", "firstname_placeholder": "First Name", "lastname_placeholder": "Last Name", "email_placeholder": "Email Address", "button_text": "Subscribe" }, "insights": { "section_label": "Section Label", "title": "Insights Title", "description": "Insights Description", "report_image": "report_image_url", "button_text": "Button Text", "button_link": "Button Link" }, "testimonials": { "title": "Testimonials Title", "description": "Testimonials Description" }, "partners": [ "Bloom", "Aldar", "SAAS", "Burtville", "Binghatti", "ONE", "Modon", "R." ], "seo": { "meta_title": "Meta Title", "meta_description": "Meta Description", "meta_keywords": "keywords", "og_image": "og_image_url" } } ``` --- ## Test the Endpoint ### Using cURL ```bash curl -X GET "http://127.0.0.1:8000/api/v1/homepage" \ -H "Accept: application/json" ``` ### Using Postman 1. **Method:** GET 2. **URL:** `http://127.0.0.1:8000/api/v1/homepage` 3. **Headers:** - `Accept: application/json` 4. **Click Send** --- ## Data Management ### Edit Homepage Data - Admin Panel: `http://127.0.0.1:8000/admin/homepages` - Update all sections from the Filament admin interface - Changes are cached and will reflect on the API ### Clear Homepage Cache ```bash php artisan tinker >>> \App\Models\Homepage::first()->clearCache() >>> exit ``` --- ## Sections Overview | Section | Type | Purpose | |---------|------|---------| | **Hero** | Hero Banner | Main header with title, description, and search | | **About** | CTA Section | About company with button | | **Global** | Cards Grid | 4-card grid section | | **Statistics** | Counter Stats | Key metrics (transactions, clients, advisors, buyers) | | **Trust Section** | Content Block | Company history since 2004 | | **Off-Plan Properties** | Property Cards | Featured off-plan listings | | **Featured Properties** | Property Showcase | Main featured properties | | **Market Insights** | CTA Section | Newsletter subscription | | **Market Report** | Report Card | Annual market report | | **Property Exposure** | Content Block | Marketing promise section | | **Benefits** | 4-Card Grid | 4 key benefits with descriptions | | **Services** | 4-Card Grid | 4 service offerings | | **Reviews** | Testimonials | Client reviews | | **Professionally Managed** | CTA Section | Property management section | | **Careers** | Banner Section | Careers/Join team section | | **Contact** | Contact Form | Contact section with form | | **Newsletter** | Newsletter Form | Newsletter subscription | | **Insights** | Content Block | Market insights | | **Testimonials** | Section Header | Testimonials heading | | **Partners** | Logo Grid | Partner logos | | **SEO** | Metadata | Meta tags and OG image |