> ## 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.

# /28hse/transactions/search

> Search the Hong Kong property transaction register that 28Hse and Squarefoot publish — over a million sale and lease records combined from the Land Registry and from market reporting. Filter by sale or lease, the three-level area tree, private estate versus subsidised or public housing, building age band and free text. Each record returns the deal id and page URL, the transaction and last-update dates, the price in HKD, saleable and gross areas with the matching price per square foot, bedroom and carpark counts, whether the unit comes with a carpark, orientation, the extra unit features, the estate with both of the ids the source keys it by, the phase, block, floor band, floor and unit designation, the district, the register the record came from with its Land Registry and agency reference numbers, and — where the same unit changed hands before — the previous price, the previous transaction date and the signed profit or loss percentage. The total number of matching records is returned in the X-Total-Available-Results header.

**Price:** 1 credit



## OpenAPI

````yaml /openapi/real-estate.json post /api/28hse/transactions/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/28hse/transactions/search:
    post:
      tags:
        - /28hse
      summary: /28hse/transactions/search
      description: >-
        Search the Hong Kong property transaction register that 28Hse and
        Squarefoot publish — over a million sale and lease records combined from
        the Land Registry and from market reporting. Filter by sale or lease,
        the three-level area tree, private estate versus subsidised or public
        housing, building age band and free text. Each record returns the deal
        id and page URL, the transaction and last-update dates, the price in
        HKD, saleable and gross areas with the matching price per square foot,
        bedroom and carpark counts, whether the unit comes with a carpark,
        orientation, the extra unit features, the estate with both of the ids
        the source keys it by, the phase, block, floor band, floor and unit
        designation, the district, the register the record came from with its
        Land Registry and agency reference numbers, and — where the same unit
        changed hands before — the previous price, the previous transaction date
        and the signed profit or loss percentage. The total number of matching
        records is returned in the X-Total-Available-Results header.


        **Price:** 1 credit
      operationId: __api_28hse_transactions_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Hse28TransactionsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Hse28Transaction'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Hse28TransactionsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        site:
          $ref: '#/components/schemas/Hse28Site'
          default: 28hse
        lang:
          $ref: '#/components/schemas/Hse28Lang'
          default: tc
        count:
          type: integer
          minimum: 1
        deal_type:
          $ref: '#/components/schemas/Hse28DealScope'
          default: any
        regions:
          anyOf:
            - items:
                $ref: '#/components/schemas/Hse28AreaRegion'
              type: array
              uniqueItems: true
            - type: 'null'
        district_groups:
          anyOf:
            - items:
                $ref: '#/components/schemas/Hse28DistrictGroup'
              type: array
              uniqueItems: true
            - type: 'null'
        districts:
          anyOf:
            - items:
                $ref: '#/components/schemas/Hse28District'
              type: array
              uniqueItems: true
            - type: 'null'
        estate_category:
          anyOf:
            - $ref: '#/components/schemas/Hse28EstateCategory'
            - type: 'null'
        building_ages:
          anyOf:
            - items:
                $ref: '#/components/schemas/Hse28TransactionBuildingAge'
              type: array
              uniqueItems: true
            - type: 'null'
        keyword:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - count
    Hse28Transaction:
      properties:
        '@type':
          type: string
          default: Hse28Transaction
        id:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        buy_rent:
          anyOf:
            - type: string
            - type: 'null'
        transaction_at:
          anyOf:
            - type: integer
            - type: 'null'
        updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        price_per_saleable_sqft:
          anyOf:
            - type: number
            - type: 'null'
        price_per_gross_sqft:
          anyOf:
            - type: number
            - type: 'null'
        saleable_area:
          anyOf:
            - type: number
            - type: 'null'
        gross_area:
          anyOf:
            - type: number
            - type: 'null'
        room_count:
          anyOf:
            - type: integer
            - type: 'null'
        carpark_count:
          anyOf:
            - type: integer
            - type: 'null'
        has_carpark:
          anyOf:
            - type: boolean
            - type: 'null'
        direction:
          anyOf:
            - type: string
            - type: 'null'
        features:
          items:
            type: string
          type: array
          default: []
        features_en:
          items:
            type: string
          type: array
          default: []
        estate:
          anyOf:
            - type: string
            - type: 'null'
        estate_id:
          anyOf:
            - type: string
            - type: 'null'
        estate_cat_id:
          anyOf:
            - type: string
            - type: 'null'
        phase:
          anyOf:
            - type: string
            - type: 'null'
        phase_en:
          anyOf:
            - type: string
            - type: 'null'
        phase_no:
          anyOf:
            - type: string
            - type: 'null'
        block:
          anyOf:
            - type: string
            - type: 'null'
        block_en:
          anyOf:
            - type: string
            - type: 'null'
        block_no:
          anyOf:
            - type: string
            - type: 'null'
        floor_zone:
          anyOf:
            - type: string
            - type: 'null'
        floor:
          anyOf:
            - type: string
            - type: 'null'
        unit:
          anyOf:
            - type: string
            - type: 'null'
        unit_id:
          anyOf:
            - type: string
            - type: 'null'
        district:
          anyOf:
            - type: string
            - type: 'null'
        district_id:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        source:
          anyOf:
            - type: string
            - type: 'null'
        transaction_type:
          anyOf:
            - type: string
            - type: 'null'
        land_registry_ref:
          anyOf:
            - type: string
            - type: 'null'
        agency_ref:
          anyOf:
            - type: string
            - type: 'null'
        previous_price:
          anyOf:
            - type: number
            - type: 'null'
        previous_transaction_at:
          anyOf:
            - type: integer
            - type: 'null'
        profit_loss_percent:
          anyOf:
            - type: number
            - type: 'null'
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    Hse28Site:
      type: string
      enum:
        - 28hse
        - squarefoot
    Hse28Lang:
      type: string
      enum:
        - tc
        - cn
        - en
    Hse28DealScope:
      type: string
      enum:
        - any
        - sale
        - rent
    Hse28AreaRegion:
      type: string
      enum:
        - hong_kong_island
        - kowloon
        - new_territories
        - outlying_islands
    Hse28DistrictGroup:
      type: string
      enum:
        - island_south
        - aberdeen_ap_lei_chau_wong_chuk_hang
        - chai_wan_siu_sai_wan_shek_o
        - shau_kei_wan_heng_fa_chuen
        - sai_wan_ho
        - taikoo
        - quarry_bay
        - north_point_mid_levels
        - north_point_fortress_hill
        - tin_hau_tai_hang
        - causeway_bay_happy_valley
        - wan_chai_admiralty
        - mid_levels
        - central_sheung_wan
        - sai_ying_pun_shek_tong_tsui
        - kennedy_town
        - whampoa
        - hung_hom
        - tsim_sha_tsui
        - jordan
        - yau_ma_tei
        - mong_kok
        - prince_edward
        - tai_kok_tsui_olympic_kowloon_station
        - lai_king
        - mei_foo
        - cheung_sha_wan
        - lai_chi_kok
        - sham_shui_po_shek_kip_mei_nam_cheong
        - yau_yat_tsuen
        - ho_man_tin
        - kowloon_tong
        - san_po_kong_wong_tai_sin
        - kai_tak
        - kowloon_city
        - to_kwa_wan
        - diamond_hill_lok_fu
        - ngau_chi_wan
        - kowloon_bay
        - kwun_tong_ngau_tau_kok
        - yau_tong
        - lam_tin
        - sha_tau_kok
        - tsing_yi
        - kwai_chung_kwai_fong
        - tsuen_wan_tai_wo_hau
        - tsuen_wan_sham_tseng
        - tuen_mun_castle_peak_road
        - tuen_mun
        - tin_shui_wai
        - yuen_long_hung_shui_kiu
        - sheung_shui
        - fan_ling
        - tai_po_tai_wo_pak_shek_kok
        - sha_tin_tai_wai_fotan
        - ma_on_shan
        - tseung_kwan_o
        - sai_kung_clear_water_bay
        - cheung_chau_other_islands
        - lamma_island
        - peng_chau
        - south_lantau_island_tai_o
        - tung_chung
        - discovery_bay
        - ma_wan
        - greater_bay_area
    Hse28District:
      type: string
      enum:
        - pok_fu_lam
        - shouson_hill
        - baguio_villa
        - southern_district
        - repulse_bay
        - tai_tam
        - stanley
        - south_horizons
        - parkview
        - wong_chuk_hang
        - ap_lei_chau
        - aberdeen
        - chai_wan
        - shek_o
        - siu_sai_wan
        - shau_kei_wan
        - heng_fa_chuen
        - north_point
        - fortress_hill
        - tai_hang
        - tin_hau
        - jardines_lookout
        - happy_valley
        - happy_valley_mid_levels
        - causeway_bay
        - admiralty
        - wan_chai
        - shiu_fai_terrace
        - western_mid_levels
        - mid_levels_central
        - the_peak
        - sheung_wan
        - central
        - sai_ying_pun
        - shek_tong_tsui
        - tai_kok_tsui
        - olympic
        - kowloon_station
        - sham_shui_po
        - shek_kip_mei
        - nam_cheong
        - san_po_kong
        - wong_tai_sin
        - diamond_hill
        - lok_fu
        - ngau_tau_kok
        - kwun_tong
        - kwai_chung
        - kwai_fong
        - tsuen_wan
        - tai_wo_hau
        - yuen_long
        - hung_shui_kiu
        - tai_po
        - tai_wo
        - pak_shek_kok
        - sha_tin
        - tai_wai
        - fotan
        - tseung_kwan_o_town
        - lohas_park
        - hang_hau
        - po_lam
        - tiu_keng_leng
        - sai_kung
        - clear_water_bay
        - cheung_chau
        - other_islands
        - south_lantau_island
        - tai_o
        - zhongshan
        - zhuhai
        - guangdong
        - huizhou
        - shenzhen
        - jiangmen
    Hse28EstateCategory:
      type: string
      enum:
        - private_estate
        - public_and_subsidised_housing
    Hse28TransactionBuildingAge:
      type: string
      enum:
        - brand_new
        - within_5_years
        - within_10_years
        - within_15_years
        - within_20_years
        - within_30_years
        - from_30_to_50_years
        - above_50_years
    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

````