openapi: 3.0.1
info:
  title: Zip Realtors LLP – Real Estate API
  description: |
    API reference for Zip Realtors LLP — Gurgaon's trusted RERA-registered real estate channel partner (HRERA-GGM-2026-45987).
    Find SCO plots, commercial properties, and luxury residential apartments across Dwarka Expressway,
    SPR Road, Sohna Road, and NH-8 in Gurgaon (Gurugram), India.
    500+ verified listings, 2000+ clients, 40+ developer partnerships.
    All services are free for buyers. Phone: +91-8448598915.
  version: "2.0"
  contact:
    name: Zip Realtors LLP
    url: https://ziprealtors.com/contact
    email: info@ziprealtors.com
  license:
    name: MIT
    url: https://ziprealtors.com/about

servers:
  - url: https://ziprealtors.com
    description: Production site

paths:
  /projects:
    get:
      operationId: listProjects
      summary: Browse all properties in Gurgaon
      description: Returns a full listing of verified SCO plots, commercial properties, and residential apartments in Gurgaon. 500+ curated listings across Dwarka Expressway, SPR Road, Sohna Road, and NH-8.
      responses:
        "200":
          description: Full property listing page

  /projects/{slug}:
    get:
      operationId: getProjectDetail
      summary: Get details for a specific property
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
          description: URL-safe project identifier (e.g., "emaar-ebd-75a", "dlf-sco-plots")
      responses:
        "200":
          description: Detailed property page with price, location, RERA, developer info, floor plans, and highlights.

  /developers:
    get:
      operationId: listDevelopers
      summary: Browse all verified real estate developers
      description: Returns a list of all 40+ builders and developers listed on Zip Realtors LLP, including DLF, Emaar, M3M, Godrej, Signature Global, Adani, BPTP, and Elan.
      responses:
        "200":
          description: Developer directory page

  /developers/{slug}:
    get:
      operationId: getDeveloperDetail
      summary: Get a specific developer profile
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Developer profile with all projects, headquarters, and rating.

  /locations/{slug}:
    get:
      operationId: getLocationPage
      summary: Browse properties in a specific Gurgaon corridor
      description: |
        Returns properties in a specific Gurgaon corridor with GEO data, sector information, and market analysis.
        Available slugs: dwarka-expressway, dwarka-expressway---premium-zone,
        spr-road-gurgaon, spr-road-extension, sohna-road, nh-8-corridor
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
            enum:
              - dwarka-expressway
              - dwarka-expressway---premium-zone
              - spr-road-gurgaon
              - spr-road-extension
              - sohna-road
              - nh-8-corridor
      responses:
        "200":
          description: Location hub page with projects and GEO data.

  /blogs:
    get:
      operationId: listBlogs
      summary: Browse real estate insights and market analysis articles
      description: Expert articles on SCO plot investment, Dwarka Expressway property trends, Gurgaon real estate market analysis, and buying guides.
      responses:
        "200":
          description: Blog listing page with all published articles.

  /blogs/{slug}:
    get:
      operationId: getBlogDetail
      summary: Read a specific blog article
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Full blog article with author, date, and related properties.

  /guides:
    get:
      operationId: listGuides
      summary: Browse expert real estate guides
      description: |
        In-depth guides covering SCO plots, Dwarka Expressway investment, RERA compliance,
        and Gurgaon market fundamentals. Written by certified real estate experts.
      responses:
        "200":
          description: Guide listing page.

  /guides/{slug}:
    get:
      operationId: getGuideDetail
      summary: Read a specific expert guide
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
            enum:
              - what-is-sco-plot
              - dwarka-expressway-guide
              - gurgaon-investment-guide
              - rera-explained
      responses:
        "200":
          description: Full expert guide with data, charts, and actionable insights.

  /about:
    get:
      operationId: aboutPage
      summary: About Zip Realtors LLP
      description: Learn about Zip Realtors LLP — Gurgaon's trusted channel partner since 2019, founded by Kapil Bhagat. 500+ properties, 2000+ clients, 40+ developers.
      responses:
        "200":
          description: About page with company history, team info, and credentials.

  /team:
    get:
      operationId: teamPage
      summary: Meet the Zip Realtors team
      description: Expert profiles of the Zip Realtors team led by Kapil Bhagat, senior property consultant with 6+ years of Gurgaon real estate experience.
      responses:
        "200":
          description: Team page with expert profiles and credentials.

  /contact:
    get:
      operationId: contactPage
      summary: Contact Zip Realtors for a free consultation
      description: Book a free site visit or get expert advice on buying property in Gurgaon. Call +91-8448598915 or submit an enquiry.
      responses:
        "200":
          description: Contact form and enquiry page.
