> ## 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/search

> Search Midland Realty Hong Kong residential listings for sale or rent. Filters cover the full site search surface: free text, sale or rent, ownership class (private / HOS / TPS), curated categories, the eight-level geography (region, sub-region, district, small district, internal districts, luxury districts), estate, phase, building and street ids, MTR station with walking time, primary school net, universities, price, gross and saleable area, price per area unit, building age, bedrooms, master bedrooms, bathrooms, other rooms, floor band, flat, orientation, outlook, special unit features, decoration, unit and estate facilities, nearby amenities, media types, developer, luxury star tier and lifestyle theme, holding branch or agent, publication and update recency, plus mortgage assumptions and result ordering. Each card carries prices and rents with per-area figures, areas and efficiency ratio, room counts, floor and flat, orientation, photos, media flags, tags, the full geography chain, estate / phase / building, unit features, estate facilities, nearby amenities, MTR stations, school net, coordinates and the listing agents.

**Price:** 1 credit



## OpenAPI

````yaml /openapi/real-estate.json post /api/midland/properties/search
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/search:
    post:
      tags:
        - /midland
      summary: /midland/properties/search
      description: >-
        Search Midland Realty Hong Kong residential listings for sale or rent.
        Filters cover the full site search surface: free text, sale or rent,
        ownership class (private / HOS / TPS), curated categories, the
        eight-level geography (region, sub-region, district, small district,
        internal districts, luxury districts), estate, phase, building and
        street ids, MTR station with walking time, primary school net,
        universities, price, gross and saleable area, price per area unit,
        building age, bedrooms, master bedrooms, bathrooms, other rooms, floor
        band, flat, orientation, outlook, special unit features, decoration,
        unit and estate facilities, nearby amenities, media types, developer,
        luxury star tier and lifestyle theme, holding branch or agent,
        publication and update recency, plus mortgage assumptions and result
        ordering. Each card carries prices and rents with per-area figures,
        areas and efficiency ratio, room counts, floor and flat, orientation,
        photos, media flags, tags, the full geography chain, estate / phase /
        building, unit features, estate facilities, nearby amenities, MTR
        stations, school net, coordinates and the listing agents.


        **Price:** 1 credit
      operationId: __api_midland_properties_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MidlandPropertiesSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MidlandPropertyCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    MidlandPropertiesSearchPayload:
      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
        min_building_age:
          anyOf:
            - type: integer
              maximum: 999
              minimum: 0
            - type: 'null'
        max_building_age:
          anyOf:
            - type: integer
              maximum: 999
              minimum: 0
            - type: 'null'
        count:
          type: integer
          maximum: 10000
          minimum: 1
        transaction_type:
          anyOf:
            - $ref: '#/components/schemas/MidlandTransactionType'
            - type: 'null'
        text:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        property_types:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandPropertyType'
              type: array
            - type: 'null'
        categories:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandCategory'
              type: array
            - type: 'null'
        sort:
          $ref: '#/components/schemas/MidlandPropertySort'
          default: default
        region_id:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        subregion_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        district_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        sm_district_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        combined_district_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        int_district_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        int_sm_district_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        lux_district_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        estate_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        phase_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        building_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        street_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        house_street_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        mtr_ids:
          anyOf:
            - items:
                type: string
                minLength: 1
              type: array
            - type: 'null'
        walking_duration:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
        school_net:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        university_ids:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandUniversity'
              type: array
            - type: 'null'
        min_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        min_area:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_area:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        min_net_area:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_net_area:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        min_net_ft_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_net_ft_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        min_ft_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        max_ft_price:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
        bedrooms:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandBedroomCount'
              type: array
            - type: 'null'
        master_bedrooms:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandRoomCount'
              type: array
            - type: 'null'
        bathrooms:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandRoomCount'
              type: array
            - type: 'null'
        other_rooms:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandRoomCount'
              type: array
            - type: 'null'
        floor_levels:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandFloorLevel'
              type: array
            - type: 'null'
        flat:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        orientations:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandOrientation'
              type: array
            - type: 'null'
        views:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandView'
              type: array
            - type: 'null'
        garden_features:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandGardenFeature'
              type: array
            - type: 'null'
        decorations:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandDecoration'
              type: array
            - type: 'null'
        facilities:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandFacility'
              type: array
            - type: 'null'
        facility_groups:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandFacilityGroup'
              type: array
            - type: 'null'
        nearby_facilities:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandNearbyFacility'
              type: array
            - type: 'null'
        media:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandMedia'
              type: array
            - type: 'null'
        developer:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        star_ratings:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandStarRating'
              type: array
            - type: 'null'
        lifestyles:
          anyOf:
            - items:
                $ref: '#/components/schemas/MidlandLifestyle'
              type: array
            - type: 'null'
        department_id:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        licence_no:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        first_published:
          anyOf:
            - $ref: '#/components/schemas/MidlandFirstPublished'
            - type: 'null'
        updated_after:
          anyOf:
            - type: string
            - type: 'null'
        mortgage_percent:
          anyOf:
            - type: integer
              maximum: 100
              minimum: 1
            - type: 'null'
        mortgage_term:
          anyOf:
            - type: integer
              maximum: 40
              minimum: 1
            - type: 'null'
      type: object
      required:
        - count
    MidlandPropertyCard:
      properties:
        '@type':
          type: string
          default: MidlandPropertyCard
        serial_no:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        transaction_types:
          items:
            type: string
          type: array
          default: []
        tags:
          items:
            type: string
          type: array
          default: []
        is_hos:
          anyOf:
            - type: boolean
            - type: 'null'
        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'
        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'
        has_valuation:
          anyOf:
            - type: boolean
            - 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'
        sitting_room_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'
        images:
          items:
            type: string
          type: array
          default: []
        has_video:
          anyOf:
            - type: boolean
            - type: 'null'
        has_agent_video:
          anyOf:
            - type: boolean
            - type: 'null'
        has_photo360:
          anyOf:
            - type: boolean
            - type: 'null'
        feature_icons:
          items:
            type: string
          type: array
          default: []
        deluxe_star:
          anyOf:
            - type: string
            - type: 'null'
        is_tenancy:
          anyOf:
            - type: boolean
            - type: 'null'
        updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        geo:
          anyOf:
            - $ref: '#/components/schemas/MidlandGeo'
            - type: 'null'
        estate:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        phase:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        building:
          anyOf:
            - $ref: '#/components/schemas/MidlandBuilding'
            - type: 'null'
        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: []
        primary_school_net:
          anyOf:
            - type: string
            - type: 'null'
        location:
          anyOf:
            - $ref: '#/components/schemas/MidlandLocation'
            - type: 'null'
        agents:
          items:
            $ref: '#/components/schemas/MidlandAgent'
          type: array
          default: []
      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
    MidlandTransactionType:
      type: string
      enum:
        - S
        - L
    MidlandPropertyType:
      type: string
      enum:
        - private
        - hos_prempaid
        - hos_premunpaid
        - tps_prempaid
        - tps_premunpaid
    MidlandCategory:
      type: string
      enum:
        - pet
        - university
        - northern_metro
        - tenancy
        - below
        - 90ltv
        - 100ssd
        - with_key
        - property_exchange
        - above_mtr
        - deluxe
        - high_rental_return
        - sole
        - invest_immi
        - talent_hot_selection
        - sale
        - latest
        - foreclosure
        - hot
    MidlandPropertySort:
      type: string
      enum:
        - default
        - latest
        - random
        - price
        - price_desc
        - sale_perc
        - sale_perc_desc
        - area
        - area_desc
        - net_area
        - net_area_desc
        - ft_price
        - ft_price_desc
        - net_ft_price
        - net_ft_price_desc
    MidlandUniversity:
      type: string
      enum:
        - U01
        - U02
        - U03
        - U04
        - U05
        - U06
        - U07
        - U08
        - U09
        - U10
        - U11
        - U12
        - U13
    MidlandBedroomCount:
      type: string
      enum:
        - '0'
        - '1'
        - '2'
        - '3'
        - 4+
    MidlandRoomCount:
      type: string
      enum:
        - '1'
        - '2'
        - 3+
    MidlandFloorLevel:
      type: string
      enum:
        - H
        - M
        - L
    MidlandOrientation:
      type: string
      enum:
        - 'N'
        - NE
        - E
        - SE
        - S
        - SW
        - W
        - NW
    MidlandView:
      type: string
      enum:
        - MISCF00037
        - MISCF00039
        - MISCF00036
        - MISCF00035
        - MISCF00042
        - MISCF00049
        - MISCF00047
        - MISCF00041
        - MISCF00050
        - MISCF00051
    MidlandGardenFeature:
      type: string
      enum:
        - MISCF00015
        - MISCF00072
        - MISCF00070
        - MISCF00016
        - MISCF00014
        - MISCF00013
        - MISCF00067
        - MISCF00071
        - MISCF00024
        - MISCF00025
        - MISCF00077
        - MISCF00044
        - MISCF00052
        - MISCF00001
        - MISCF00005
        - MISCF00004
    MidlandDecoration:
      type: string
      enum:
        - MISCF00002
        - MISCF00003
    MidlandFacility:
      type: string
      enum:
        - MISCF00009
        - MISCF00007
        - MISCF00011
        - MISCF00010
        - MISCF00048
    MidlandFacilityGroup:
      type: string
      enum:
        - FM02
        - FM12
        - FM01
        - FM07
        - FM10
        - FM05
        - FM09
        - FM13
        - FM14
    MidlandNearbyFacility:
      type: string
      enum:
        - carpark
        - mall
        - recreation
        - mtr
        - hospital
        - park
    MidlandMedia:
      type: string
      enum:
        - vr
        - agent_video
        - ai_decorate
        - ai_talk
    MidlandStarRating:
      type: string
      enum:
        - star4
        - star5
        - star6
    MidlandLifestyle:
      type: string
      enum:
        - LS01
        - LS02
        - LS03
        - LS04
        - LS05
        - LS06
        - LS07
        - LS08
        - LS09
        - LS10
        - LS11
        - LS12
        - LS13
        - LS14
        - LS15
        - LS16
        - LS17
        - LS18
    MidlandFirstPublished:
      type: string
      enum:
        - 7days
    MidlandRef:
      properties:
        '@type':
          type: string
          default: MidlandRef
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - 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
    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
    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
    MidlandLocation:
      properties:
        '@type':
          type: string
          default: MidlandLocation
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - 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
    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
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````