/midland/commercial/properties/search

curl --request POST \
  --url https://api.anysite.io/api/midland/commercial/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "lang": "zh-hk",
  "text": "<string>",
  "districts": [],
  "building_id": "<string>",
  "street_id": "<string>",
  "mtr_id": "<string>",
  "grades": [],
  "floor_levels": [],
  "stock_types": [],
  "tags": [],
  "min_price": 1,
  "max_price": 1,
  "min_rent": 1,
  "max_rent": 1,
  "min_area": 1,
  "max_area": 1,
  "min_price_per_area": 1,
  "max_price_per_area": 1,
  "min_rent_per_area": 1,
  "max_rent_per_area": 1,
  "with_photo": true,
  "with_video": true,
  "with_vr": true,
  "with_vr720": true
}
'

import requests

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

payload = {
    "count": 2,
    "timeout": 300,
    "lang": "zh-hk",
    "text": "<string>",
    "districts": [],
    "building_id": "<string>",
    "street_id": "<string>",
    "mtr_id": "<string>",
    "grades": [],
    "floor_levels": [],
    "stock_types": [],
    "tags": [],
    "min_price": 1,
    "max_price": 1,
    "min_rent": 1,
    "max_rent": 1,
    "min_area": 1,
    "max_area": 1,
    "min_price_per_area": 1,
    "max_price_per_area": 1,
    "min_rent_per_area": 1,
    "max_rent_per_area": 1,
    "with_photo": True,
    "with_video": True,
    "with_vr": True,
    "with_vr720": True
}
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: 2,
    timeout: 300,
    lang: 'zh-hk',
    text: '<string>',
    districts: [],
    building_id: '<string>',
    street_id: '<string>',
    mtr_id: '<string>',
    grades: [],
    floor_levels: [],
    stock_types: [],
    tags: [],
    min_price: 1,
    max_price: 1,
    min_rent: 1,
    max_rent: 1,
    min_area: 1,
    max_area: 1,
    min_price_per_area: 1,
    max_price_per_area: 1,
    min_rent_per_area: 1,
    max_rent_per_area: 1,
    with_photo: true,
    with_video: true,
    with_vr: true,
    with_vr720: true
  })
};

fetch('https://api.anysite.io/api/midland/commercial/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/commercial/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' => 2,
    'timeout' => 300,
    'lang' => 'zh-hk',
    'text' => '<string>',
    'districts' => [
        
    ],
    'building_id' => '<string>',
    'street_id' => '<string>',
    'mtr_id' => '<string>',
    'grades' => [
        
    ],
    'floor_levels' => [
        
    ],
    'stock_types' => [
        
    ],
    'tags' => [
        
    ],
    'min_price' => 1,
    'max_price' => 1,
    'min_rent' => 1,
    'max_rent' => 1,
    'min_area' => 1,
    'max_area' => 1,
    'min_price_per_area' => 1,
    'max_price_per_area' => 1,
    'min_rent_per_area' => 1,
    'max_rent_per_area' => 1,
    'with_photo' => true,
    'with_video' => true,
    'with_vr' => true,
    'with_vr720' => true
  ]),
  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/commercial/properties/search"

	payload := strings.NewReader("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"text\": \"<string>\",\n  \"districts\": [],\n  \"building_id\": \"<string>\",\n  \"street_id\": \"<string>\",\n  \"mtr_id\": \"<string>\",\n  \"grades\": [],\n  \"floor_levels\": [],\n  \"stock_types\": [],\n  \"tags\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_rent\": 1,\n  \"max_rent\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_price_per_area\": 1,\n  \"max_price_per_area\": 1,\n  \"min_rent_per_area\": 1,\n  \"max_rent_per_area\": 1,\n  \"with_photo\": true,\n  \"with_video\": true,\n  \"with_vr\": true,\n  \"with_vr720\": true\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/commercial/properties/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"text\": \"<string>\",\n  \"districts\": [],\n  \"building_id\": \"<string>\",\n  \"street_id\": \"<string>\",\n  \"mtr_id\": \"<string>\",\n  \"grades\": [],\n  \"floor_levels\": [],\n  \"stock_types\": [],\n  \"tags\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_rent\": 1,\n  \"max_rent\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_price_per_area\": 1,\n  \"max_price_per_area\": 1,\n  \"min_rent_per_area\": 1,\n  \"max_rent_per_area\": 1,\n  \"with_photo\": true,\n  \"with_video\": true,\n  \"with_vr\": true,\n  \"with_vr720\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/midland/commercial/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\": 2,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"text\": \"<string>\",\n  \"districts\": [],\n  \"building_id\": \"<string>\",\n  \"street_id\": \"<string>\",\n  \"mtr_id\": \"<string>\",\n  \"grades\": [],\n  \"floor_levels\": [],\n  \"stock_types\": [],\n  \"tags\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_rent\": 1,\n  \"max_rent\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_price_per_area\": 1,\n  \"max_price_per_area\": 1,\n  \"min_rent_per_area\": 1,\n  \"max_rent_per_area\": 1,\n  \"with_photo\": true,\n  \"with_video\": true,\n  \"with_vr\": true,\n  \"with_vr720\": true\n}"

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

[
  {
    "property_no": "<string>",
    "@type": "MidlandCommercialProperty",
    "name": "<string>",
    "url": "<string>",
    "usage": "<string>",
    "transaction_types": [],
    "address": "<string>",
    "district_code": "<string>",
    "district": "<string>",
    "street": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "building": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "grade": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "floor_level": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "stock_type": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "min_area": 123,
    "max_area": 123,
    "price": 123,
    "price_per_area": 123,
    "rent": 123,
    "rent_per_area": 123,
    "is_price_negotiable": true,
    "is_rent_negotiable": true,
    "features": [],
    "tags": [],
    "has_photo": true,
    "has_video": true,
    "has_vr": true,
    "has_vr720": true,
    "image": "<string>",
    "location": {
      "@type": "MidlandLocation",
      "latitude": 123,
      "longitude": 123
    },
    "mtr_station": "<string>",
    "mtr_walking_seconds": 123,
    "transactions_url": "<string>",
    "agents": []
  }
]

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

/midland/commercial

/midland/commercial/properties/search

Search Midland ICI (美聯工商舖) Hong Kong commercial listings — offices, industrial space and shops for sale or lease. Filters cover property class, sale or lease, free text, districts, building, street and MTR station ids, building grade, floor band, stock type, sole-agency and newly listed tags, asking price, monthly rent, area, price per square foot, rent per square foot, and whether photos, a video or a virtual tour are attached. Each listing carries the reference number, name and address, district, street and building, grade, floor band and stock type (street-level shop, basement, upper-floor shop, industrial), the area range, price and rent with per-square-foot figures and negotiability flags, unit features such as lift-facing, sea or garden outlook, tags, media flags, thumbnail, coordinates, the nearest MTR station with walking time, a link to deals in the same building, and the assigned agents with EAA licence numbers and contact channels.

Price: 1 credit

POST

api

midland

commercial

properties

/midland/commercial/properties/search

curl --request POST \
  --url https://api.anysite.io/api/midland/commercial/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "lang": "zh-hk",
  "text": "<string>",
  "districts": [],
  "building_id": "<string>",
  "street_id": "<string>",
  "mtr_id": "<string>",
  "grades": [],
  "floor_levels": [],
  "stock_types": [],
  "tags": [],
  "min_price": 1,
  "max_price": 1,
  "min_rent": 1,
  "max_rent": 1,
  "min_area": 1,
  "max_area": 1,
  "min_price_per_area": 1,
  "max_price_per_area": 1,
  "min_rent_per_area": 1,
  "max_rent_per_area": 1,
  "with_photo": true,
  "with_video": true,
  "with_vr": true,
  "with_vr720": true
}
'

import requests

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

payload = {
    "count": 2,
    "timeout": 300,
    "lang": "zh-hk",
    "text": "<string>",
    "districts": [],
    "building_id": "<string>",
    "street_id": "<string>",
    "mtr_id": "<string>",
    "grades": [],
    "floor_levels": [],
    "stock_types": [],
    "tags": [],
    "min_price": 1,
    "max_price": 1,
    "min_rent": 1,
    "max_rent": 1,
    "min_area": 1,
    "max_area": 1,
    "min_price_per_area": 1,
    "max_price_per_area": 1,
    "min_rent_per_area": 1,
    "max_rent_per_area": 1,
    "with_photo": True,
    "with_video": True,
    "with_vr": True,
    "with_vr720": True
}
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: 2,
    timeout: 300,
    lang: 'zh-hk',
    text: '<string>',
    districts: [],
    building_id: '<string>',
    street_id: '<string>',
    mtr_id: '<string>',
    grades: [],
    floor_levels: [],
    stock_types: [],
    tags: [],
    min_price: 1,
    max_price: 1,
    min_rent: 1,
    max_rent: 1,
    min_area: 1,
    max_area: 1,
    min_price_per_area: 1,
    max_price_per_area: 1,
    min_rent_per_area: 1,
    max_rent_per_area: 1,
    with_photo: true,
    with_video: true,
    with_vr: true,
    with_vr720: true
  })
};

fetch('https://api.anysite.io/api/midland/commercial/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/commercial/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' => 2,
    'timeout' => 300,
    'lang' => 'zh-hk',
    'text' => '<string>',
    'districts' => [
        
    ],
    'building_id' => '<string>',
    'street_id' => '<string>',
    'mtr_id' => '<string>',
    'grades' => [
        
    ],
    'floor_levels' => [
        
    ],
    'stock_types' => [
        
    ],
    'tags' => [
        
    ],
    'min_price' => 1,
    'max_price' => 1,
    'min_rent' => 1,
    'max_rent' => 1,
    'min_area' => 1,
    'max_area' => 1,
    'min_price_per_area' => 1,
    'max_price_per_area' => 1,
    'min_rent_per_area' => 1,
    'max_rent_per_area' => 1,
    'with_photo' => true,
    'with_video' => true,
    'with_vr' => true,
    'with_vr720' => true
  ]),
  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/commercial/properties/search"

	payload := strings.NewReader("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"text\": \"<string>\",\n  \"districts\": [],\n  \"building_id\": \"<string>\",\n  \"street_id\": \"<string>\",\n  \"mtr_id\": \"<string>\",\n  \"grades\": [],\n  \"floor_levels\": [],\n  \"stock_types\": [],\n  \"tags\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_rent\": 1,\n  \"max_rent\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_price_per_area\": 1,\n  \"max_price_per_area\": 1,\n  \"min_rent_per_area\": 1,\n  \"max_rent_per_area\": 1,\n  \"with_photo\": true,\n  \"with_video\": true,\n  \"with_vr\": true,\n  \"with_vr720\": true\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/commercial/properties/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"count\": 2,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"text\": \"<string>\",\n  \"districts\": [],\n  \"building_id\": \"<string>\",\n  \"street_id\": \"<string>\",\n  \"mtr_id\": \"<string>\",\n  \"grades\": [],\n  \"floor_levels\": [],\n  \"stock_types\": [],\n  \"tags\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_rent\": 1,\n  \"max_rent\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_price_per_area\": 1,\n  \"max_price_per_area\": 1,\n  \"min_rent_per_area\": 1,\n  \"max_rent_per_area\": 1,\n  \"with_photo\": true,\n  \"with_video\": true,\n  \"with_vr\": true,\n  \"with_vr720\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/midland/commercial/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\": 2,\n  \"timeout\": 300,\n  \"lang\": \"zh-hk\",\n  \"text\": \"<string>\",\n  \"districts\": [],\n  \"building_id\": \"<string>\",\n  \"street_id\": \"<string>\",\n  \"mtr_id\": \"<string>\",\n  \"grades\": [],\n  \"floor_levels\": [],\n  \"stock_types\": [],\n  \"tags\": [],\n  \"min_price\": 1,\n  \"max_price\": 1,\n  \"min_rent\": 1,\n  \"max_rent\": 1,\n  \"min_area\": 1,\n  \"max_area\": 1,\n  \"min_price_per_area\": 1,\n  \"max_price_per_area\": 1,\n  \"min_rent_per_area\": 1,\n  \"max_rent_per_area\": 1,\n  \"with_photo\": true,\n  \"with_video\": true,\n  \"with_vr\": true,\n  \"with_vr720\": true\n}"

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

[
  {
    "property_no": "<string>",
    "@type": "MidlandCommercialProperty",
    "name": "<string>",
    "url": "<string>",
    "usage": "<string>",
    "transaction_types": [],
    "address": "<string>",
    "district_code": "<string>",
    "district": "<string>",
    "street": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "building": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "grade": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "floor_level": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "stock_type": {
      "@type": "MidlandRef",
      "id": "<string>",
      "name": "<string>"
    },
    "min_area": 123,
    "max_area": 123,
    "price": 123,
    "price_per_area": 123,
    "rent": 123,
    "rent_per_area": 123,
    "is_price_negotiable": true,
    "is_rent_negotiable": true,
    "features": [],
    "tags": [],
    "has_photo": true,
    "has_video": true,
    "has_vr": true,
    "has_vr720": true,
    "image": "<string>",
    "location": {
      "@type": "MidlandLocation",
      "latitude": 123,
      "longitude": 123
    },
    "mtr_station": "<string>",
    "mtr_walking_seconds": 123,
    "transactions_url": "<string>",
    "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: x >= 1

timeout

integer

default:300

Required range: 20 <= x <= 1500

lang

enum<string>

default:zh-hk

Available options:

zh-hk,

zh-cn,

en

usage

enum<string> | null

Available options:

COMMERCIAL,

INDUSTRIAL,

SHOPS

transaction_type

enum<string> | null

Available options:

S,

L

text

string | null

Minimum string length: 1

districts

enum<string>[] | null

Available options:

ABE,

ADM,

ALC,

CAB,

CEN,

CHW,

CSW,

FAN,

FOT,

HAV,

HMT,

HSK,

HUH,

ISD,

JOR,

KAT,

KOB,

KOC,

KOT,

KWC,

KWT,

MEF,

MIL,

MOK,

MOS,

NCW,

NOP,

NTK,

PFL,

PRE,

QUB,

SAK,

SHM,

SHS,

SHT,

SHW,

SKW,

SLY,

SOU,

SPK,

SSP,

STS,

TAH,

TAK,

TAP,

TAW,

TIH,

TIS,

TIW,

TKO,

TKT,

TKW,

TSE,

TSI,

TST,

TSW,

TSY,

TUC,

TUM,

VIP,

WAC,

WCH,

WCN,

WES,

WTS,

YAT,

YMT,

YUL

building_id

string | null

Minimum string length: 1

street_id

string | null

Minimum string length: 1

mtr_id

string | null

Minimum string length: 1

grades

enum<string>[] | null

Available options:

MISC00165,

MISC00166

floor_levels

enum<string>[] | null

Available options:

MISC00169,

MISC00170,

MISC00171,

MISC00172,

MISC00173,

MISC00174

stock_types

enum<string>[] | null

Available options:

MISC00177,

MISC00178,

MISC00179,

MISC00180,

MISC00109,

MISC00100,

MISC00110,

MISC00108,

MISC00105,

MISC00115

Response

Successful Response

property_no

string

required

@type

string

default:MidlandCommercialProperty

name

string | null

url

string | null

usage

string | null

transaction_types

string[]

address

string | null

district_code

string | null

district

string | null

street

object | null

Show child attributes

building

object | null

Show child attributes

grade

object | null

Show child attributes

floor_level

object | null

Show child attributes

stock_type

object | null

Show child attributes

min_area

number | null

max_area

number | null

price

number | null

price_per_area

number | null

rent

number | null

rent_per_area

number | null

is_price_negotiable

boolean | null

is_rent_negotiable

boolean | null

features

object[]

Show child attributes

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/commercial/properties/search

Authorizations

Headers

Body

Response