> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /midland/properties

> Get one Midland Realty Hong Kong residential listing by its reference number (or listing URL). Returns the full listing page: asking price or rent with previous price and per-area figures, HOS pricing, gross and saleable area with the efficiency ratio, room breakdown (bedrooms, master bedrooms, guest and sitting rooms, bathrooms, covered carparks), floor band, flat and orientation, typed photos, agent video, static maps, unit features, estate facilities, walkable amenities and MTR stations, the eight-level geography, the neighbourhood profile with air quality and market stats, the estate profile (developer, vendor, occupation dates, block and storey breakdown, school nets, listing counts and price ranges, site plans, videos, other phases), the building, the monthly price and rent index for the phase, recent nearby sale and rental deals, nearby branches, the listing agents with EAA licence numbers, and mortgage assumptions.

**Price:** 1 credit

**⚠️ Common errors:** 412: No listing with this reference number (it may have been withdrawn).



## OpenAPI

````yaml /openapi/real-estate.json post /api/midland/properties
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/midland/properties:
    post:
      tags:
        - /midland
      summary: /midland/properties
      description: >-
        Get one Midland Realty Hong Kong residential listing by its reference
        number (or listing URL). Returns the full listing page: asking price or
        rent with previous price and per-area figures, HOS pricing, gross and
        saleable area with the efficiency ratio, room breakdown (bedrooms,
        master bedrooms, guest and sitting rooms, bathrooms, covered carparks),
        floor band, flat and orientation, typed photos, agent video, static
        maps, unit features, estate facilities, walkable amenities and MTR
        stations, the eight-level geography, the neighbourhood profile with air
        quality and market stats, the estate profile (developer, vendor,
        occupation dates, block and storey breakdown, school nets, listing
        counts and price ranges, site plans, videos, other phases), the
        building, the monthly price and rent index for the phase, recent nearby
        sale and rental deals, nearby branches, the listing agents with EAA
        licence numbers, and mortgage assumptions.


        **Price:** 1 credit


        **⚠️ Common errors:** 412: No listing with this reference number (it may
        have been withdrawn).
      operationId: __api_midland_properties_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MidlandPropertiesPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MidlandProperty'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    MidlandPropertiesPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        lang:
          $ref: '#/components/schemas/MidlandLang'
          default: zh-hk
        unit:
          $ref: '#/components/schemas/MidlandUnit'
          default: feet
        currency:
          $ref: '#/components/schemas/MidlandCurrency'
          default: HKD
        serial_no:
          type: string
      type: object
      required:
        - serial_no
    MidlandProperty:
      properties:
        '@type':
          type: string
          default: MidlandProperty
        serial_no:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        url_zh_cn:
          anyOf:
            - type: string
            - type: 'null'
        url_en:
          anyOf:
            - type: string
            - type: 'null'
        transaction_types:
          items:
            type: string
          type: array
          default: []
        tags:
          items:
            type: string
          type: array
          default: []
        sale_tags:
          items:
            type: string
          type: array
          default: []
        rent_tags:
          items:
            type: string
          type: array
          default: []
        unit_type:
          anyOf:
            - type: string
            - type: 'null'
        is_hos:
          anyOf:
            - type: boolean
            - type: 'null'
        is_sole_agent:
          anyOf:
            - type: boolean
            - type: 'null'
        is_tenancy:
          anyOf:
            - type: boolean
            - type: 'null'
        is_hot_new:
          anyOf:
            - type: boolean
            - type: 'null'
        has_valuation:
          anyOf:
            - type: boolean
            - type: 'null'
        is_deluxe_sale:
          anyOf:
            - type: boolean
            - type: 'null'
        is_deluxe_rent:
          anyOf:
            - type: boolean
            - type: 'null'
        deluxe_star:
          anyOf:
            - type: string
            - type: 'null'
        deluxe_star_rate:
          anyOf:
            - type: integer
            - type: 'null'
        lifestyle_themes:
          items:
            $ref: '#/components/schemas/MidlandRef'
          type: array
          default: []
        price:
          anyOf:
            - type: number
            - type: 'null'
        previous_price:
          anyOf:
            - type: number
            - type: 'null'
        price_hkd:
          anyOf:
            - type: number
            - type: 'null'
        price_per_area:
          anyOf:
            - type: number
            - type: 'null'
        price_per_net_area:
          anyOf:
            - type: number
            - type: 'null'
        hos_price:
          anyOf:
            - type: number
            - type: 'null'
        previous_hos_price:
          anyOf:
            - type: number
            - type: 'null'
        hos_price_hkd:
          anyOf:
            - type: number
            - type: 'null'
        hos_price_per_area:
          anyOf:
            - type: number
            - type: 'null'
        hos_price_per_net_area:
          anyOf:
            - type: number
            - type: 'null'
        rent:
          anyOf:
            - type: number
            - type: 'null'
        previous_rent:
          anyOf:
            - type: number
            - type: 'null'
        rent_hkd:
          anyOf:
            - type: number
            - type: 'null'
        rent_per_area:
          anyOf:
            - type: number
            - type: 'null'
        rent_per_net_area:
          anyOf:
            - type: number
            - type: 'null'
        monthly_payment:
          anyOf:
            - type: number
            - type: 'null'
        monthly_payment_hkd:
          anyOf:
            - type: number
            - type: 'null'
        hos_monthly_payment:
          anyOf:
            - type: number
            - type: 'null'
        hos_monthly_payment_hkd:
          anyOf:
            - type: number
            - type: 'null'
        mortgage_percent:
          anyOf:
            - type: number
            - type: 'null'
        hos_mortgage_percent:
          anyOf:
            - type: number
            - type: 'null'
        area:
          anyOf:
            - type: number
            - type: 'null'
        net_area:
          anyOf:
            - type: number
            - type: 'null'
        net_area_ratio:
          anyOf:
            - type: number
            - type: 'null'
        bedroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        master_bedroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        guest_room_count:
          anyOf:
            - type: integer
            - type: 'null'
        sitting_room_count:
          anyOf:
            - type: integer
            - type: 'null'
        bathroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        other_room_count:
          anyOf:
            - type: integer
            - type: 'null'
        covered_carpark_count:
          anyOf:
            - type: integer
            - type: 'null'
        floor_level:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        flat:
          anyOf:
            - type: string
            - type: 'null'
        orientation:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        photos:
          items:
            $ref: '#/components/schemas/MidlandPropertyPhoto'
          type: array
          default: []
        videos:
          items:
            $ref: '#/components/schemas/MidlandPropertyVideo'
          type: array
          default: []
        virtual_tours:
          items:
            $ref: '#/components/schemas/MidlandVirtualTour'
          type: array
          default: []
        floor_plans:
          items:
            $ref: '#/components/schemas/MidlandFloorPlan'
          type: array
          default: []
        static_maps:
          items:
            type: string
          type: array
          default: []
        features:
          items:
            $ref: '#/components/schemas/MidlandRef'
          type: array
          default: []
        facility_groups:
          items:
            $ref: '#/components/schemas/MidlandRef'
          type: array
          default: []
        amenities:
          items:
            $ref: '#/components/schemas/MidlandAmenity'
          type: array
          default: []
        mtr_stations:
          items:
            $ref: '#/components/schemas/MidlandMtrStation'
          type: array
          default: []
        geo:
          anyOf:
            - $ref: '#/components/schemas/MidlandGeo'
            - type: 'null'
        neighbourhood:
          anyOf:
            - $ref: '#/components/schemas/MidlandNeighbourhood'
            - type: 'null'
        estate:
          anyOf:
            - $ref: '#/components/schemas/MidlandPropertyEstate'
            - type: 'null'
        phase:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        building:
          anyOf:
            - $ref: '#/components/schemas/MidlandBuilding'
            - type: 'null'
        market_stat:
          anyOf:
            - $ref: '#/components/schemas/MidlandMarketStat'
            - type: 'null'
        price_index:
          items:
            $ref: '#/components/schemas/MidlandPriceIndexPoint'
          type: array
          default: []
        nearby_sale_transactions:
          items:
            $ref: '#/components/schemas/MidlandNearbyTransaction'
          type: array
          default: []
        nearby_rent_transactions:
          items:
            $ref: '#/components/schemas/MidlandNearbyTransaction'
          type: array
          default: []
        branches:
          items:
            $ref: '#/components/schemas/MidlandBranchContact'
          type: array
          default: []
        agents:
          items:
            $ref: '#/components/schemas/MidlandAgent'
          type: array
          default: []
        mortgage:
          anyOf:
            - $ref: '#/components/schemas/MidlandMortgage'
            - type: 'null'
        comparable_room_count:
          anyOf:
            - type: string
            - type: 'null'
        comparable_listing_net_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        comparable_listing_price_change_percent:
          anyOf:
            - type: number
            - type: 'null'
        comparable_transaction_net_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        comparable_listing_net_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
        comparable_transaction_net_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
        estate_url:
          anyOf:
            - type: string
            - type: 'null'
        transactions_url:
          anyOf:
            - type: string
            - type: 'null'
        news_url:
          anyOf:
            - type: string
            - type: 'null'
        first_published_at:
          anyOf:
            - type: integer
            - type: 'null'
        posted_at:
          anyOf:
            - type: integer
            - type: 'null'
        updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        eaa_effective_at:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - serial_no
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    MidlandLang:
      type: string
      enum:
        - zh-hk
        - zh-cn
        - en
    MidlandUnit:
      type: string
      enum:
        - feet
        - meter
    MidlandCurrency:
      type: string
      enum:
        - HKD
        - CNY
    MidlandRef:
      properties:
        '@type':
          type: string
          default: MidlandRef
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandPropertyPhoto:
      properties:
        '@type':
          type: string
          default: MidlandPropertyPhoto
        url:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        type:
          anyOf:
            - type: string
            - type: 'null'
        width:
          anyOf:
            - type: integer
            - type: 'null'
        height:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
    MidlandPropertyVideo:
      properties:
        '@type':
          type: string
          default: MidlandPropertyVideo
        id:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        stream_url:
          anyOf:
            - type: string
            - type: 'null'
        thumbnail:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandVirtualTour:
      properties:
        '@type':
          type: string
          default: MidlandVirtualTour
        url:
          anyOf:
            - type: string
            - type: 'null'
        thumbnail:
          anyOf:
            - type: string
            - type: 'null'
        is_deluxe:
          anyOf:
            - type: boolean
            - type: 'null'
      type: object
    MidlandFloorPlan:
      properties:
        '@type':
          type: string
          default: MidlandFloorPlan
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        source:
          anyOf:
            - type: string
            - type: 'null'
        phase_id:
          anyOf:
            - type: string
            - type: 'null'
        phase_name:
          anyOf:
            - type: string
            - type: 'null'
        building_id:
          anyOf:
            - type: string
            - type: 'null'
        building_name:
          anyOf:
            - type: string
            - type: 'null'
        floor_from:
          anyOf:
            - type: string
            - type: 'null'
        floor_to:
          anyOf:
            - type: string
            - type: 'null'
        floor_text:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandAmenity:
      properties:
        '@type':
          type: string
          default: MidlandAmenity
        type:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        walking_minutes:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
    MidlandMtrStation:
      properties:
        '@type':
          type: string
          default: MidlandMtrStation
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        exit:
          anyOf:
            - type: string
            - type: 'null'
        walking_seconds:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
    MidlandGeo:
      properties:
        '@type':
          type: string
          default: MidlandGeo
        region:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        subregion:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        sm_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        combined_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        int_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        int_sm_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        lux_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
      type: object
    MidlandNeighbourhood:
      properties:
        '@type':
          type: string
          default: MidlandNeighbourhood
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        unit_rank_text:
          anyOf:
            - type: string
            - type: 'null'
        total_unit_count:
          anyOf:
            - type: integer
            - type: 'null'
        sell_count:
          anyOf:
            - type: integer
            - type: 'null'
        rent_count:
          anyOf:
            - type: integer
            - type: 'null'
        air_quality_level:
          anyOf:
            - type: string
            - type: 'null'
        market_stat:
          anyOf:
            - $ref: '#/components/schemas/MidlandMarketStat'
            - type: 'null'
      type: object
    MidlandPropertyEstate:
      properties:
        '@type':
          type: string
          default: MidlandPropertyEstate
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        phase_id:
          anyOf:
            - type: string
            - type: 'null'
        phase_name:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        developer:
          anyOf:
            - type: string
            - type: 'null'
        vendor:
          anyOf:
            - type: string
            - type: 'null'
        management_company:
          anyOf:
            - type: string
            - type: 'null'
        op_date_text:
          anyOf:
            - type: string
            - type: 'null'
        first_op_at:
          anyOf:
            - type: integer
            - type: 'null'
        last_op_at:
          anyOf:
            - type: integer
            - type: 'null'
        block_count_text:
          anyOf:
            - type: string
            - type: 'null'
        storey_text:
          anyOf:
            - type: string
            - type: 'null'
        total_flats_text:
          anyOf:
            - type: string
            - type: 'null'
        school_net:
          anyOf:
            - $ref: '#/components/schemas/MidlandSchoolNet'
            - type: 'null'
        sell_count:
          anyOf:
            - type: integer
            - type: 'null'
        rent_count:
          anyOf:
            - type: integer
            - type: 'null'
        min_price:
          anyOf:
            - type: number
            - type: 'null'
        max_price:
          anyOf:
            - type: number
            - type: 'null'
        min_rent:
          anyOf:
            - type: number
            - type: 'null'
        max_rent:
          anyOf:
            - type: number
            - type: 'null'
        avg_net_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        avg_net_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
        net_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
        site_plans:
          items:
            type: string
          type: array
          default: []
        videos:
          items:
            $ref: '#/components/schemas/MidlandPropertyVideo'
          type: array
          default: []
        other_phases:
          items:
            $ref: '#/components/schemas/MidlandRef'
          type: array
          default: []
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandBuilding:
      properties:
        '@type':
          type: string
          default: MidlandBuilding
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        first_op_at:
          anyOf:
            - type: integer
            - type: 'null'
        floor_count:
          anyOf:
            - type: integer
            - type: 'null'
        building_type:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        streetview_latitude:
          anyOf:
            - type: number
            - type: 'null'
        streetview_longitude:
          anyOf:
            - type: number
            - type: 'null'
        streetview_angle:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
    MidlandMarketStat:
      properties:
        '@type':
          type: string
          default: MidlandMarketStat
        net_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        previous_net_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        net_ft_price_change_percent:
          anyOf:
            - type: number
            - type: 'null'
        ft_price:
          anyOf:
            - type: number
            - type: 'null'
        previous_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        ft_price_change_percent:
          anyOf:
            - type: number
            - type: 'null'
        net_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
        transaction_count:
          anyOf:
            - type: integer
            - type: 'null'
        transaction_amount:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    MidlandPriceIndexPoint:
      properties:
        '@type':
          type: string
          default: MidlandPriceIndexPoint
        date_at:
          anyOf:
            - type: integer
            - type: 'null'
        transaction_count:
          anyOf:
            - type: integer
            - type: 'null'
        avg_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        avg_net_ft_price:
          anyOf:
            - type: number
            - type: 'null'
        avg_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
        avg_net_ft_rent:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    MidlandNearbyTransaction:
      properties:
        '@type':
          type: string
          default: MidlandNearbyTransaction
        price:
          anyOf:
            - type: number
            - type: 'null'
        net_area:
          anyOf:
            - type: number
            - type: 'null'
        bedroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        estate_name:
          anyOf:
            - type: string
            - type: 'null'
        phase_name:
          anyOf:
            - type: string
            - type: 'null'
        building_name:
          anyOf:
            - type: string
            - type: 'null'
        floor:
          anyOf:
            - type: string
            - type: 'null'
        floor_name:
          anyOf:
            - type: string
            - type: 'null'
        flat:
          anyOf:
            - type: string
            - type: 'null'
        gain_percent:
          anyOf:
            - type: number
            - type: 'null'
        holding_period_years:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    MidlandBranchContact:
      properties:
        '@type':
          type: string
          default: MidlandBranchContact
        name:
          anyOf:
            - type: string
            - type: 'null'
        phone:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandAgent:
      properties:
        '@type':
          type: string
          default: MidlandAgent
        licence_no:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        name_en:
          anyOf:
            - type: string
            - type: 'null'
        nickname:
          anyOf:
            - type: string
            - type: 'null'
        job_title:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        phone:
          anyOf:
            - type: string
            - type: 'null'
        mobile_phone:
          anyOf:
            - type: string
            - type: 'null'
        china_mobile_phone:
          anyOf:
            - type: string
            - type: 'null'
        wechat_id:
          anyOf:
            - type: string
            - type: 'null'
        wechat_qr:
          anyOf:
            - type: string
            - type: 'null'
        department_id:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        is_owner:
          anyOf:
            - type: boolean
            - type: 'null'
      type: object
    MidlandMortgage:
      properties:
        '@type':
          type: string
          default: MidlandMortgage
        loan_percent:
          anyOf:
            - type: number
            - type: 'null'
        loan_years:
          anyOf:
            - type: integer
            - type: 'null'
        interest_rate_percent:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
    MidlandSchoolNet:
      properties:
        '@type':
          type: string
          default: MidlandSchoolNet
        kindergarten_id:
          anyOf:
            - type: string
            - type: 'null'
        kindergarten_name:
          anyOf:
            - type: string
            - type: 'null'
        primary_id:
          anyOf:
            - type: string
            - type: 'null'
        primary_name:
          anyOf:
            - type: string
            - type: 'null'
        secondary_id:
          anyOf:
            - type: string
            - type: 'null'
        secondary_name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````