/midland/properties/search

curl --request POST \
  --url https://api.anysite.io/api/midland/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 5000,
  "timeout": 300,
  "lang": "zh-hk",
  "unit": "feet",
  "currency": "HKD",
  "min_building_age": 499,
  "max_building_age": 499,
  "text": "<string>",
  "property_types": [],
  "categories": [],
  "sort": "default",
  "region_id": "<string>",
  "subregion_ids": [
    "<string>"
  ],
  "district_ids": [
    "<string>"
  ],
  "sm_district_ids": [
    "<string>"
  ],
  "combined_district_ids": [
    "<string>"
  ],
  "int_district_ids": [
    "<string>"
  ],
  "int_sm_district_ids": [
    "<string>"
  ],
  "lux_district_ids": [
    "<string>"
  ],
  "estate_ids": [
    "<string>"
  ],
  "phase_ids": [
    "<string>"
  ],
  "building_ids": [
    "<string>"
  ],
  "street_ids": [
    "<string>"
  ],
  "house_street_ids": [
    "<string>"
  ],
  "mtr_ids": [
    "<string>"
  ],
  "walking_duration": 2,
  "school_net": "<string>",
  "university_ids": [],
  "min_price": 1,
  "max_price": 1,
  "min_area": 1,
  "max_area": 1,
  "min_net_area": 1,
  "max_net_area": 1,
  "min_net_ft_price": 1,
  "max_net_ft_price": 1,
  "min_ft_price": 1,
  "max_ft_price": 1,
  "bedrooms": [],
  "master_bedrooms": [],
  "bathrooms": [],
  "other_rooms": [],
  "floor_levels": [],
  "flat": "<string>",
  "orientations": [],
  "views": [],
  "garden_features": [],
  "decorations": [],
  "facilities": [],
  "facility_groups": [],
  "nearby_facilities": [],
  "media": [],
  "developer": "<string>",
  "star_ratings": [],
  "lifestyles": [],
  "department_id": "<string>",
  "licence_no": "<string>",
  "first_published": "7days",
  "updated_after": "<string>",
  "mortgage_percent": 50,
  "mortgage_term": 20
}
'

import requests

url = "https://api.anysite.io/api/midland/properties/search"

payload = {
    "count": 5000,
    "timeout": 300,
    "lang": "zh-hk",
    "unit": "feet",
    "currency": "HKD",
    "min_building_age": 499,
    "max_building_age": 499,
    "text": "<string>",
    "property_types": [],
    "categories": [],
    "sort": "default",
    "region_id": "<string>",
    "subregion_ids": ["<string>"],
    "district_ids": ["<string>"],
    "sm_district_ids": ["<string>"],
    "combined_district_ids": ["<string>"],
    "int_district_ids": ["<string>"],
    "int_sm_district_ids": ["<string>"],
    "lux_district_ids": ["<string>"],
    "estate_ids": ["<string>"],
    "phase_ids": ["<string>"],
    "building_ids": ["<string>"],
    "street_ids": ["<string>"],
    "house_street_ids": ["<string>"],
    "mtr_ids": ["<string>"],
    "walking_duration": 2,
    "school_net": "<string>",
    "university_ids": [],
    "min_price": 1,
    "max_price": 1,
    "min_area": 1,
    "max_area": 1,
    "min_net_area": 1,
    "max_net_area": 1,
    "min_net_ft_price": 1,
    "max_net_ft_price": 1,
    "min_ft_price": 1,
    "max_ft_price": 1,
    "bedrooms": [],
    "master_bedrooms": [],
    "bathrooms": [],
    "other_rooms": [],
    "floor_levels": [],
    "flat": "<string>",
    "orientations": [],
    "views": [],
    "garden_features": [],
    "decorations": [],
    "facilities": [],
    "facility_groups": [],
    "nearby_facilities": [],
    "media": [],
    "developer": "<string>",
    "star_ratings": [],
    "lifestyles": [],
    "department_id": "<string>",
    "licence_no": "<string>",
    "first_published": "7days",
    "updated_after": "<string>",
    "mortgage_percent": 50,
    "mortgage_term": 20
}
headers = {
    "access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    count: 5000,
    timeout: 300,
    lang: 'zh-hk',
    unit: 'feet',
    currency: 'HKD',
    min_building_age: 499,
    max_building_age: 499,
    text: '<string>',
    property_types: [],
    categories: [],
    sort: 'default',
    region_id: '<string>',
    subregion_ids: ['<string>'],
    district_ids: ['<string>'],
    sm_district_ids: ['<string>'],
    combined_district_ids: ['<string>'],
    int_district_ids: ['<string>'],
    int_sm_district_ids: ['<string>'],
    lux_district_ids: ['<string>'],
    estate_ids: ['<string>'],
    phase_ids: ['<string>'],
    building_ids: ['<string>'],
    street_ids: ['<string>'],
    house_street_ids: ['<string>'],
    mtr_ids: ['<string>'],
    walking_duration: 2,
    school_net: '<string>',
    university_ids: [],
    min_price: 1,
    max_price: 1,
    min_area: 1,
    max_area: 1,
    min_net_area: 1,
    max_net_area: 1,
    min_net_ft_price: 1,
    max_net_ft_price: 1,
    min_ft_price: 1,
    max_ft_price: 1,
    bedrooms: [],
    master_bedrooms: [],
    bathrooms: [],
    other_rooms: [],
    floor_levels: [],
    flat: '<string>',
    orientations: [],
    views: [],
    garden_features: [],
    decorations: [],
    facilities: [],
    facility_groups: [],
    nearby_facilities: [],
    media: [],
    developer: '<string>',
    star_ratings: [],
    lifestyles: [],
    department_id: '<string>',
    licence_no: '<string>',
    first_published: '7days',
    updated_after: '<string>',
    mortgage_percent: 50,
    mortgage_term: 20
  })
};

fetch('https://api.anysite.io/api/midland/properties/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anysite.io/api/midland/properties/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'count' => 5000,
    'timeout' => 300,
    'lang' => 'zh-hk',
    'unit' => 'feet',
    'currency' => 'HKD',
    'min_building_age' => 499,
    'max_building_age' => 499,
    'text' => '<string>',
    'property_types' => [
        
    ],
    'categories' => [
        
    ],
    'sort' => 'default',
    'region_id' => '<string>',
    'subregion_ids' => [
        '<string>'
    ],
    'district_ids' => [
        '<string>'
    ],
    'sm_district_ids' => [
        '<string>'
    ],
    'combined_district_ids' => [
        '<string>'
    ],
    'int_district_ids' => [
        '<string>'
    ],
    'int_sm_district_ids' => [
        '<string>'
    ],
    'lux_district_ids' => [
        '<string>'
    ],
    'estate_ids' => [
        '<string>'
    ],
    'phase_ids' => [
        '<string>'
    ],
    'building_ids' => [
        '<string>'
    ],
    'street_ids' => [
        '<string>'
    ],
    'house_street_ids' => [
        '<string>'
    ],
    'mtr_ids' => [
        '<string>'
    ],
    'walking_duration' => 2,
    'school_net' => '<string>',
    'university_ids' => [
        
    ],
    'min_price' => 1,
    'max_price' => 1,
    'min_area' => 1,
    'max_area' => 1,
    'min_net_area' => 1,
    'max_net_area' => 1,
    'min_net_ft_price' => 1,
    'max_net_ft_price' => 1,
    'min_ft_price' => 1,
    'max_ft_price' => 1,
    'bedrooms' => [
        
    ],
    'master_bedrooms' => [
        
    ],
    'bathrooms' => [
        
    ],
    'other_rooms' => [
        
    ],
    'floor_levels' => [
        
    ],
    'flat' => '<string>',
    'orientations' => [
        
    ],
    'views' => [
        
    ],
    'garden_features' => [
        
    ],
    'decorations' => [
        
    ],
    'facilities' => [
        
    ],
    'facility_groups' => [
        
    ],
    'nearby_facilities' => [
        
    ],
    'media' => [
        
    ],
    'developer' => '<string>',
    'star_ratings' => [
        
    ],
    'lifestyles' => [
        
    ],
    'department_id' => '<string>',
    'licence_no' => '<string>',
    'first_published' => '7days',
    'updated_after' => '<string>',
    'mortgage_percent' => 50,
    'mortgage_term' => 20
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anysite.io/api/midland/properties/search"

	payload := strings.NewReader("{\n  \"count\": 5000,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"unit\": \"feet\",\n  \"currency\": \"HKD\",\n  \"min_building_age\": 499,\n  \"max_building_age\": 499,\n  \"text\": \"<string>\",\n  \"property_types\": [],\n  \"categories\": [],\n  \"sort\": \"default\",\n  \"region_id\": \"<string>\",\n  \"subregion_ids\": [\n    \"<string>\"\n  ],\n  \"district_ids\": [\n    \"<string>\"\n  ],\n  \"sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"combined_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"lux_district_ids\": [\n    \"<string>\"\n  ],\n  \"estate_ids\": [\n    \"<string>\"\n  ],\n  \"phase_ids\": [\n    \"<string>\"\n  ],\n  \"building_ids\": [\n    \"<string>\"\n  ],\n  \"street_ids\": [\n    \"<string>\"\n  ],\n  \"house_street_ids\": [\n    \"<string>\"\n  ],\n  \"mtr_ids\": [\n    \"<string>\"\n  ],\n  \"walking_duration\": 2,\n  \"school_net\": \"<string>\",\n  \"university_ids\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_net_area\": 1,\n  \"max_net_area\": 1,\n  \"min_net_ft_price\": 1,\n  \"max_net_ft_price\": 1,\n  \"min_ft_price\": 1,\n  \"max_ft_price\": 1,\n  \"bedrooms\": [],\n  \"master_bedrooms\": [],\n  \"bathrooms\": [],\n  \"other_rooms\": [],\n  \"floor_levels\": [],\n  \"flat\": \"<string>\",\n  \"orientations\": [],\n  \"views\": [],\n  \"garden_features\": [],\n  \"decorations\": [],\n  \"facilities\": [],\n  \"facility_groups\": [],\n  \"nearby_facilities\": [],\n  \"media\": [],\n  \"developer\": \"<string>\",\n  \"star_ratings\": [],\n  \"lifestyles\": [],\n  \"department_id\": \"<string>\",\n  \"licence_no\": \"<string>\",\n  \"first_published\": \"7days\",\n  \"updated_after\": \"<string>\",\n  \"mortgage_percent\": 50,\n  \"mortgage_term\": 20\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/midland/properties/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"count\": 5000,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"unit\": \"feet\",\n  \"currency\": \"HKD\",\n  \"min_building_age\": 499,\n  \"max_building_age\": 499,\n  \"text\": \"<string>\",\n  \"property_types\": [],\n  \"categories\": [],\n  \"sort\": \"default\",\n  \"region_id\": \"<string>\",\n  \"subregion_ids\": [\n    \"<string>\"\n  ],\n  \"district_ids\": [\n    \"<string>\"\n  ],\n  \"sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"combined_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"lux_district_ids\": [\n    \"<string>\"\n  ],\n  \"estate_ids\": [\n    \"<string>\"\n  ],\n  \"phase_ids\": [\n    \"<string>\"\n  ],\n  \"building_ids\": [\n    \"<string>\"\n  ],\n  \"street_ids\": [\n    \"<string>\"\n  ],\n  \"house_street_ids\": [\n    \"<string>\"\n  ],\n  \"mtr_ids\": [\n    \"<string>\"\n  ],\n  \"walking_duration\": 2,\n  \"school_net\": \"<string>\",\n  \"university_ids\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_net_area\": 1,\n  \"max_net_area\": 1,\n  \"min_net_ft_price\": 1,\n  \"max_net_ft_price\": 1,\n  \"min_ft_price\": 1,\n  \"max_ft_price\": 1,\n  \"bedrooms\": [],\n  \"master_bedrooms\": [],\n  \"bathrooms\": [],\n  \"other_rooms\": [],\n  \"floor_levels\": [],\n  \"flat\": \"<string>\",\n  \"orientations\": [],\n  \"views\": [],\n  \"garden_features\": [],\n  \"decorations\": [],\n  \"facilities\": [],\n  \"facility_groups\": [],\n  \"nearby_facilities\": [],\n  \"media\": [],\n  \"developer\": \"<string>\",\n  \"star_ratings\": [],\n  \"lifestyles\": [],\n  \"department_id\": \"<string>\",\n  \"licence_no\": \"<string>\",\n  \"first_published\": \"7days\",\n  \"updated_after\": \"<string>\",\n  \"mortgage_percent\": 50,\n  \"mortgage_term\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/midland/properties/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"count\": 5000,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"unit\": \"feet\",\n  \"currency\": \"HKD\",\n  \"min_building_age\": 499,\n  \"max_building_age\": 499,\n  \"text\": \"<string>\",\n  \"property_types\": [],\n  \"categories\": [],\n  \"sort\": \"default\",\n  \"region_id\": \"<string>\",\n  \"subregion_ids\": [\n    \"<string>\"\n  ],\n  \"district_ids\": [\n    \"<string>\"\n  ],\n  \"sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"combined_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"lux_district_ids\": [\n    \"<string>\"\n  ],\n  \"estate_ids\": [\n    \"<string>\"\n  ],\n  \"phase_ids\": [\n    \"<string>\"\n  ],\n  \"building_ids\": [\n    \"<string>\"\n  ],\n  \"street_ids\": [\n    \"<string>\"\n  ],\n  \"house_street_ids\": [\n    \"<string>\"\n  ],\n  \"mtr_ids\": [\n    \"<string>\"\n  ],\n  \"walking_duration\": 2,\n  \"school_net\": \"<string>\",\n  \"university_ids\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_net_area\": 1,\n  \"max_net_area\": 1,\n  \"min_net_ft_price\": 1,\n  \"max_net_ft_price\": 1,\n  \"min_ft_price\": 1,\n  \"max_ft_price\": 1,\n  \"bedrooms\": [],\n  \"master_bedrooms\": [],\n  \"bathrooms\": [],\n  \"other_rooms\": [],\n  \"floor_levels\": [],\n  \"flat\": \"<string>\",\n  \"orientations\": [],\n  \"views\": [],\n  \"garden_features\": [],\n  \"decorations\": [],\n  \"facilities\": [],\n  \"facility_groups\": [],\n  \"nearby_facilities\": [],\n  \"media\": [],\n  \"developer\": \"<string>\",\n  \"star_ratings\": [],\n  \"lifestyles\": [],\n  \"department_id\": \"<string>\",\n  \"licence_no\": \"<string>\",\n  \"first_published\": \"7days\",\n  \"updated_after\": \"<string>\",\n  \"mortgage_percent\": 50,\n  \"mortgage_term\": 20\n}"

response = http.request(request)
puts response.read_body

[
  {
    "serial_no": "<string>",
    "@type": "MidlandPropertyCard",
    "url": "<string>",
    "transaction_types": [],
    "tags": [],
    "is_hos": true,
    "price": 123,
    "previous_price": 123,
    "price_hkd": 123,
    "price_per_area": 123,
    "price_per_net_area": 123,
    "hos_price": 123,
    "hos_price_hkd": 123,
    "hos_price_per_area": 123,
    "hos_price_per_net_area": 123,
    "rent": 123,
    "previous_rent": 123,
    "rent_hkd": 123,
    "rent_per_area": 123,
    "rent_per_net_area": 123,
    "monthly_payment": 123,
    "monthly_payment_hkd": 123,
    "hos_monthly_payment": 123,
    "hos_monthly_payment_hkd": 123,
    "mortgage_percent": 123,
    "hos_mortgage_percent": 123,
    "has_valuation": true,
    "area": 123,
    "net_area": 123,
    "net_area_ratio": 123,
    "bedroom_count": 123,
    "sitting_room_count": 123,
    "floor_level": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "flat": "<string>",
    "orientation": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "image": "<string>",
    "images": [],
    "has_video": true,
    "has_agent_video": true,
    "has_photo360": true,
    "feature_icons": [],
    "deluxe_star": "<string>",
    "is_tenancy": true,
    "updated_at": 123,
    "geo": {
      "@type": "MidlandGeo",
      "region": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "subregion": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "sm_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "combined_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "int_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "int_sm_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "lux_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      }
    },
    "estate": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "phase": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "building": {
      "@type": "MidlandBuilding",
      "id": "<string>",
      "name": "<string>",
      "address": "<string>",
      "first_op_at": 123,
      "floor_count": 123,
      "building_type": "<string>",
      "latitude": 123,
      "longitude": 123,
      "streetview_latitude": 123,
      "streetview_longitude": 123,
      "streetview_angle": 123
    },
    "features": [],
    "facility_groups": [],
    "amenities": [],
    "mtr_stations": [],
    "primary_school_net": "<string>",
    "location": {
      "@type": "MidlandLocation",
      "latitude": 123,
      "longitude": 123
    },
    "agents": []
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

/midland

/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

POST

api

midland

properties

/midland/properties/search

curl --request POST \
  --url https://api.anysite.io/api/midland/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 5000,
  "timeout": 300,
  "lang": "zh-hk",
  "unit": "feet",
  "currency": "HKD",
  "min_building_age": 499,
  "max_building_age": 499,
  "text": "<string>",
  "property_types": [],
  "categories": [],
  "sort": "default",
  "region_id": "<string>",
  "subregion_ids": [
    "<string>"
  ],
  "district_ids": [
    "<string>"
  ],
  "sm_district_ids": [
    "<string>"
  ],
  "combined_district_ids": [
    "<string>"
  ],
  "int_district_ids": [
    "<string>"
  ],
  "int_sm_district_ids": [
    "<string>"
  ],
  "lux_district_ids": [
    "<string>"
  ],
  "estate_ids": [
    "<string>"
  ],
  "phase_ids": [
    "<string>"
  ],
  "building_ids": [
    "<string>"
  ],
  "street_ids": [
    "<string>"
  ],
  "house_street_ids": [
    "<string>"
  ],
  "mtr_ids": [
    "<string>"
  ],
  "walking_duration": 2,
  "school_net": "<string>",
  "university_ids": [],
  "min_price": 1,
  "max_price": 1,
  "min_area": 1,
  "max_area": 1,
  "min_net_area": 1,
  "max_net_area": 1,
  "min_net_ft_price": 1,
  "max_net_ft_price": 1,
  "min_ft_price": 1,
  "max_ft_price": 1,
  "bedrooms": [],
  "master_bedrooms": [],
  "bathrooms": [],
  "other_rooms": [],
  "floor_levels": [],
  "flat": "<string>",
  "orientations": [],
  "views": [],
  "garden_features": [],
  "decorations": [],
  "facilities": [],
  "facility_groups": [],
  "nearby_facilities": [],
  "media": [],
  "developer": "<string>",
  "star_ratings": [],
  "lifestyles": [],
  "department_id": "<string>",
  "licence_no": "<string>",
  "first_published": "7days",
  "updated_after": "<string>",
  "mortgage_percent": 50,
  "mortgage_term": 20
}
'

import requests

url = "https://api.anysite.io/api/midland/properties/search"

payload = {
    "count": 5000,
    "timeout": 300,
    "lang": "zh-hk",
    "unit": "feet",
    "currency": "HKD",
    "min_building_age": 499,
    "max_building_age": 499,
    "text": "<string>",
    "property_types": [],
    "categories": [],
    "sort": "default",
    "region_id": "<string>",
    "subregion_ids": ["<string>"],
    "district_ids": ["<string>"],
    "sm_district_ids": ["<string>"],
    "combined_district_ids": ["<string>"],
    "int_district_ids": ["<string>"],
    "int_sm_district_ids": ["<string>"],
    "lux_district_ids": ["<string>"],
    "estate_ids": ["<string>"],
    "phase_ids": ["<string>"],
    "building_ids": ["<string>"],
    "street_ids": ["<string>"],
    "house_street_ids": ["<string>"],
    "mtr_ids": ["<string>"],
    "walking_duration": 2,
    "school_net": "<string>",
    "university_ids": [],
    "min_price": 1,
    "max_price": 1,
    "min_area": 1,
    "max_area": 1,
    "min_net_area": 1,
    "max_net_area": 1,
    "min_net_ft_price": 1,
    "max_net_ft_price": 1,
    "min_ft_price": 1,
    "max_ft_price": 1,
    "bedrooms": [],
    "master_bedrooms": [],
    "bathrooms": [],
    "other_rooms": [],
    "floor_levels": [],
    "flat": "<string>",
    "orientations": [],
    "views": [],
    "garden_features": [],
    "decorations": [],
    "facilities": [],
    "facility_groups": [],
    "nearby_facilities": [],
    "media": [],
    "developer": "<string>",
    "star_ratings": [],
    "lifestyles": [],
    "department_id": "<string>",
    "licence_no": "<string>",
    "first_published": "7days",
    "updated_after": "<string>",
    "mortgage_percent": 50,
    "mortgage_term": 20
}
headers = {
    "access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    count: 5000,
    timeout: 300,
    lang: 'zh-hk',
    unit: 'feet',
    currency: 'HKD',
    min_building_age: 499,
    max_building_age: 499,
    text: '<string>',
    property_types: [],
    categories: [],
    sort: 'default',
    region_id: '<string>',
    subregion_ids: ['<string>'],
    district_ids: ['<string>'],
    sm_district_ids: ['<string>'],
    combined_district_ids: ['<string>'],
    int_district_ids: ['<string>'],
    int_sm_district_ids: ['<string>'],
    lux_district_ids: ['<string>'],
    estate_ids: ['<string>'],
    phase_ids: ['<string>'],
    building_ids: ['<string>'],
    street_ids: ['<string>'],
    house_street_ids: ['<string>'],
    mtr_ids: ['<string>'],
    walking_duration: 2,
    school_net: '<string>',
    university_ids: [],
    min_price: 1,
    max_price: 1,
    min_area: 1,
    max_area: 1,
    min_net_area: 1,
    max_net_area: 1,
    min_net_ft_price: 1,
    max_net_ft_price: 1,
    min_ft_price: 1,
    max_ft_price: 1,
    bedrooms: [],
    master_bedrooms: [],
    bathrooms: [],
    other_rooms: [],
    floor_levels: [],
    flat: '<string>',
    orientations: [],
    views: [],
    garden_features: [],
    decorations: [],
    facilities: [],
    facility_groups: [],
    nearby_facilities: [],
    media: [],
    developer: '<string>',
    star_ratings: [],
    lifestyles: [],
    department_id: '<string>',
    licence_no: '<string>',
    first_published: '7days',
    updated_after: '<string>',
    mortgage_percent: 50,
    mortgage_term: 20
  })
};

fetch('https://api.anysite.io/api/midland/properties/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anysite.io/api/midland/properties/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'count' => 5000,
    'timeout' => 300,
    'lang' => 'zh-hk',
    'unit' => 'feet',
    'currency' => 'HKD',
    'min_building_age' => 499,
    'max_building_age' => 499,
    'text' => '<string>',
    'property_types' => [
        
    ],
    'categories' => [
        
    ],
    'sort' => 'default',
    'region_id' => '<string>',
    'subregion_ids' => [
        '<string>'
    ],
    'district_ids' => [
        '<string>'
    ],
    'sm_district_ids' => [
        '<string>'
    ],
    'combined_district_ids' => [
        '<string>'
    ],
    'int_district_ids' => [
        '<string>'
    ],
    'int_sm_district_ids' => [
        '<string>'
    ],
    'lux_district_ids' => [
        '<string>'
    ],
    'estate_ids' => [
        '<string>'
    ],
    'phase_ids' => [
        '<string>'
    ],
    'building_ids' => [
        '<string>'
    ],
    'street_ids' => [
        '<string>'
    ],
    'house_street_ids' => [
        '<string>'
    ],
    'mtr_ids' => [
        '<string>'
    ],
    'walking_duration' => 2,
    'school_net' => '<string>',
    'university_ids' => [
        
    ],
    'min_price' => 1,
    'max_price' => 1,
    'min_area' => 1,
    'max_area' => 1,
    'min_net_area' => 1,
    'max_net_area' => 1,
    'min_net_ft_price' => 1,
    'max_net_ft_price' => 1,
    'min_ft_price' => 1,
    'max_ft_price' => 1,
    'bedrooms' => [
        
    ],
    'master_bedrooms' => [
        
    ],
    'bathrooms' => [
        
    ],
    'other_rooms' => [
        
    ],
    'floor_levels' => [
        
    ],
    'flat' => '<string>',
    'orientations' => [
        
    ],
    'views' => [
        
    ],
    'garden_features' => [
        
    ],
    'decorations' => [
        
    ],
    'facilities' => [
        
    ],
    'facility_groups' => [
        
    ],
    'nearby_facilities' => [
        
    ],
    'media' => [
        
    ],
    'developer' => '<string>',
    'star_ratings' => [
        
    ],
    'lifestyles' => [
        
    ],
    'department_id' => '<string>',
    'licence_no' => '<string>',
    'first_published' => '7days',
    'updated_after' => '<string>',
    'mortgage_percent' => 50,
    'mortgage_term' => 20
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anysite.io/api/midland/properties/search"

	payload := strings.NewReader("{\n  \"count\": 5000,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"unit\": \"feet\",\n  \"currency\": \"HKD\",\n  \"min_building_age\": 499,\n  \"max_building_age\": 499,\n  \"text\": \"<string>\",\n  \"property_types\": [],\n  \"categories\": [],\n  \"sort\": \"default\",\n  \"region_id\": \"<string>\",\n  \"subregion_ids\": [\n    \"<string>\"\n  ],\n  \"district_ids\": [\n    \"<string>\"\n  ],\n  \"sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"combined_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"lux_district_ids\": [\n    \"<string>\"\n  ],\n  \"estate_ids\": [\n    \"<string>\"\n  ],\n  \"phase_ids\": [\n    \"<string>\"\n  ],\n  \"building_ids\": [\n    \"<string>\"\n  ],\n  \"street_ids\": [\n    \"<string>\"\n  ],\n  \"house_street_ids\": [\n    \"<string>\"\n  ],\n  \"mtr_ids\": [\n    \"<string>\"\n  ],\n  \"walking_duration\": 2,\n  \"school_net\": \"<string>\",\n  \"university_ids\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_net_area\": 1,\n  \"max_net_area\": 1,\n  \"min_net_ft_price\": 1,\n  \"max_net_ft_price\": 1,\n  \"min_ft_price\": 1,\n  \"max_ft_price\": 1,\n  \"bedrooms\": [],\n  \"master_bedrooms\": [],\n  \"bathrooms\": [],\n  \"other_rooms\": [],\n  \"floor_levels\": [],\n  \"flat\": \"<string>\",\n  \"orientations\": [],\n  \"views\": [],\n  \"garden_features\": [],\n  \"decorations\": [],\n  \"facilities\": [],\n  \"facility_groups\": [],\n  \"nearby_facilities\": [],\n  \"media\": [],\n  \"developer\": \"<string>\",\n  \"star_ratings\": [],\n  \"lifestyles\": [],\n  \"department_id\": \"<string>\",\n  \"licence_no\": \"<string>\",\n  \"first_published\": \"7days\",\n  \"updated_after\": \"<string>\",\n  \"mortgage_percent\": 50,\n  \"mortgage_term\": 20\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/midland/properties/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"count\": 5000,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"unit\": \"feet\",\n  \"currency\": \"HKD\",\n  \"min_building_age\": 499,\n  \"max_building_age\": 499,\n  \"text\": \"<string>\",\n  \"property_types\": [],\n  \"categories\": [],\n  \"sort\": \"default\",\n  \"region_id\": \"<string>\",\n  \"subregion_ids\": [\n    \"<string>\"\n  ],\n  \"district_ids\": [\n    \"<string>\"\n  ],\n  \"sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"combined_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"lux_district_ids\": [\n    \"<string>\"\n  ],\n  \"estate_ids\": [\n    \"<string>\"\n  ],\n  \"phase_ids\": [\n    \"<string>\"\n  ],\n  \"building_ids\": [\n    \"<string>\"\n  ],\n  \"street_ids\": [\n    \"<string>\"\n  ],\n  \"house_street_ids\": [\n    \"<string>\"\n  ],\n  \"mtr_ids\": [\n    \"<string>\"\n  ],\n  \"walking_duration\": 2,\n  \"school_net\": \"<string>\",\n  \"university_ids\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_net_area\": 1,\n  \"max_net_area\": 1,\n  \"min_net_ft_price\": 1,\n  \"max_net_ft_price\": 1,\n  \"min_ft_price\": 1,\n  \"max_ft_price\": 1,\n  \"bedrooms\": [],\n  \"master_bedrooms\": [],\n  \"bathrooms\": [],\n  \"other_rooms\": [],\n  \"floor_levels\": [],\n  \"flat\": \"<string>\",\n  \"orientations\": [],\n  \"views\": [],\n  \"garden_features\": [],\n  \"decorations\": [],\n  \"facilities\": [],\n  \"facility_groups\": [],\n  \"nearby_facilities\": [],\n  \"media\": [],\n  \"developer\": \"<string>\",\n  \"star_ratings\": [],\n  \"lifestyles\": [],\n  \"department_id\": \"<string>\",\n  \"licence_no\": \"<string>\",\n  \"first_published\": \"7days\",\n  \"updated_after\": \"<string>\",\n  \"mortgage_percent\": 50,\n  \"mortgage_term\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/midland/properties/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"count\": 5000,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"unit\": \"feet\",\n  \"currency\": \"HKD\",\n  \"min_building_age\": 499,\n  \"max_building_age\": 499,\n  \"text\": \"<string>\",\n  \"property_types\": [],\n  \"categories\": [],\n  \"sort\": \"default\",\n  \"region_id\": \"<string>\",\n  \"subregion_ids\": [\n    \"<string>\"\n  ],\n  \"district_ids\": [\n    \"<string>\"\n  ],\n  \"sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"combined_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_district_ids\": [\n    \"<string>\"\n  ],\n  \"int_sm_district_ids\": [\n    \"<string>\"\n  ],\n  \"lux_district_ids\": [\n    \"<string>\"\n  ],\n  \"estate_ids\": [\n    \"<string>\"\n  ],\n  \"phase_ids\": [\n    \"<string>\"\n  ],\n  \"building_ids\": [\n    \"<string>\"\n  ],\n  \"street_ids\": [\n    \"<string>\"\n  ],\n  \"house_street_ids\": [\n    \"<string>\"\n  ],\n  \"mtr_ids\": [\n    \"<string>\"\n  ],\n  \"walking_duration\": 2,\n  \"school_net\": \"<string>\",\n  \"university_ids\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_net_area\": 1,\n  \"max_net_area\": 1,\n  \"min_net_ft_price\": 1,\n  \"max_net_ft_price\": 1,\n  \"min_ft_price\": 1,\n  \"max_ft_price\": 1,\n  \"bedrooms\": [],\n  \"master_bedrooms\": [],\n  \"bathrooms\": [],\n  \"other_rooms\": [],\n  \"floor_levels\": [],\n  \"flat\": \"<string>\",\n  \"orientations\": [],\n  \"views\": [],\n  \"garden_features\": [],\n  \"decorations\": [],\n  \"facilities\": [],\n  \"facility_groups\": [],\n  \"nearby_facilities\": [],\n  \"media\": [],\n  \"developer\": \"<string>\",\n  \"star_ratings\": [],\n  \"lifestyles\": [],\n  \"department_id\": \"<string>\",\n  \"licence_no\": \"<string>\",\n  \"first_published\": \"7days\",\n  \"updated_after\": \"<string>\",\n  \"mortgage_percent\": 50,\n  \"mortgage_term\": 20\n}"

response = http.request(request)
puts response.read_body

[
  {
    "serial_no": "<string>",
    "@type": "MidlandPropertyCard",
    "url": "<string>",
    "transaction_types": [],
    "tags": [],
    "is_hos": true,
    "price": 123,
    "previous_price": 123,
    "price_hkd": 123,
    "price_per_area": 123,
    "price_per_net_area": 123,
    "hos_price": 123,
    "hos_price_hkd": 123,
    "hos_price_per_area": 123,
    "hos_price_per_net_area": 123,
    "rent": 123,
    "previous_rent": 123,
    "rent_hkd": 123,
    "rent_per_area": 123,
    "rent_per_net_area": 123,
    "monthly_payment": 123,
    "monthly_payment_hkd": 123,
    "hos_monthly_payment": 123,
    "hos_monthly_payment_hkd": 123,
    "mortgage_percent": 123,
    "hos_mortgage_percent": 123,
    "has_valuation": true,
    "area": 123,
    "net_area": 123,
    "net_area_ratio": 123,
    "bedroom_count": 123,
    "sitting_room_count": 123,
    "floor_level": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "flat": "<string>",
    "orientation": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "image": "<string>",
    "images": [],
    "has_video": true,
    "has_agent_video": true,
    "has_photo360": true,
    "feature_icons": [],
    "deluxe_star": "<string>",
    "is_tenancy": true,
    "updated_at": 123,
    "geo": {
      "@type": "MidlandGeo",
      "region": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "subregion": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "sm_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "combined_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "int_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "int_sm_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      },
      "lux_district": {
        "@type": "MidlandRef",
        "id": "<string>",
        "name": "<string>"
      }
    },
    "estate": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "phase": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "building": {
      "@type": "MidlandBuilding",
      "id": "<string>",
      "name": "<string>",
      "address": "<string>",
      "first_op_at": 123,
      "floor_count": 123,
      "building_type": "<string>",
      "latitude": 123,
      "longitude": 123,
      "streetview_latitude": 123,
      "streetview_longitude": 123,
      "streetview_angle": 123
    },
    "features": [],
    "facility_groups": [],
    "amenities": [],
    "mtr_stations": [],
    "primary_school_net": "<string>",
    "location": {
      "@type": "MidlandLocation",
      "latitude": 123,
      "longitude": 123
    },
    "agents": []
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

count

integer

required

Required range: 1 <= x <= 10000

timeout

integer

default:300

Required range: 20 <= x <= 1500

lang

enum<string>

default:zh-hk

Available options:

zh-hk,

zh-cn,

en

unit

enum<string>

default:feet

Available options:

feet,

meter

currency

enum<string>

default:HKD

Available options:

HKD,

CNY

min_building_age

integer | null

Required range: 0 <= x <= 999

max_building_age

integer | null

Required range: 0 <= x <= 999

transaction_type

enum<string> | null

Available options:

S,

L

text

string | null

Minimum string length: 1

property_types

enum<string>[] | null

Available options:

private,

hos_prempaid,

hos_premunpaid,

tps_prempaid,

tps_premunpaid

Response

Successful Response

serial_no

string

required

@type

string

default:MidlandPropertyCard

url

string | null

transaction_types

string[]

Token

Ad transparency

App stores

Books

Company & startup intel

Company registries

Compliance & sanctions

Crypto & DeFi

Developer & data

Domains & OSINT

E-commerce & marketplaces

Education & courses

Events & tickets

Finance & markets

Games

Gov & public sector

Jobs

Legal

Local & places

Movies & TV

Music

News & publishing

Package registries

Price comparison

Professional network

Real estate

Research papers

Reviews — consumer & business

Reviews — software & employer

Social media

Travel & hospitality

Utility

Web search

/midland/properties/search

Authorizations

Headers

Body

Response