curl --request POST \
--url https://api.anysite.io/api/centaline/transactions/search \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"count": 2,
"timeout": 300,
"lang": "hk",
"keyword": "<string>",
"hma_ids": [
"<string>"
],
"estates": [
"<string>"
],
"order": "Ascending",
"deal_type": "Sale",
"period": "Day30",
"phases": [
"<string>"
],
"primary_school_nets": [
"<string>"
],
"source": [],
"market": [],
"estate_usages": [],
"min_price": 1,
"max_price": 1,
"min_saleable_area": 1,
"max_saleable_area": 1,
"min_price_per_sqft": 1,
"max_price_per_sqft": 1,
"min_building_age": 1,
"max_building_age": 1,
"bedroom_counts": [
2
],
"developers": [
"<string>"
],
"sort": "InsOrRegDate"
}
'import requests
url = "https://api.anysite.io/api/centaline/transactions/search"
payload = {
"count": 2,
"timeout": 300,
"lang": "hk",
"keyword": "<string>",
"hma_ids": ["<string>"],
"estates": ["<string>"],
"order": "Ascending",
"deal_type": "Sale",
"period": "Day30",
"phases": ["<string>"],
"primary_school_nets": ["<string>"],
"source": [],
"market": [],
"estate_usages": [],
"min_price": 1,
"max_price": 1,
"min_saleable_area": 1,
"max_saleable_area": 1,
"min_price_per_sqft": 1,
"max_price_per_sqft": 1,
"min_building_age": 1,
"max_building_age": 1,
"bedroom_counts": [2],
"developers": ["<string>"],
"sort": "InsOrRegDate"
}
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: 'hk',
keyword: '<string>',
hma_ids: ['<string>'],
estates: ['<string>'],
order: 'Ascending',
deal_type: 'Sale',
period: 'Day30',
phases: ['<string>'],
primary_school_nets: ['<string>'],
source: [],
market: [],
estate_usages: [],
min_price: 1,
max_price: 1,
min_saleable_area: 1,
max_saleable_area: 1,
min_price_per_sqft: 1,
max_price_per_sqft: 1,
min_building_age: 1,
max_building_age: 1,
bedroom_counts: [2],
developers: ['<string>'],
sort: 'InsOrRegDate'
})
};
fetch('https://api.anysite.io/api/centaline/transactions/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/centaline/transactions/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' => 'hk',
'keyword' => '<string>',
'hma_ids' => [
'<string>'
],
'estates' => [
'<string>'
],
'order' => 'Ascending',
'deal_type' => 'Sale',
'period' => 'Day30',
'phases' => [
'<string>'
],
'primary_school_nets' => [
'<string>'
],
'source' => [
],
'market' => [
],
'estate_usages' => [
],
'min_price' => 1,
'max_price' => 1,
'min_saleable_area' => 1,
'max_saleable_area' => 1,
'min_price_per_sqft' => 1,
'max_price_per_sqft' => 1,
'min_building_age' => 1,
'max_building_age' => 1,
'bedroom_counts' => [
2
],
'developers' => [
'<string>'
],
'sort' => 'InsOrRegDate'
]),
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/centaline/transactions/search"
payload := strings.NewReader("{\n \"count\": 2,\n \"timeout\": 300,\n \"lang\": \"hk\",\n \"keyword\": \"<string>\",\n \"hma_ids\": [\n \"<string>\"\n ],\n \"estates\": [\n \"<string>\"\n ],\n \"order\": \"Ascending\",\n \"deal_type\": \"Sale\",\n \"period\": \"Day30\",\n \"phases\": [\n \"<string>\"\n ],\n \"primary_school_nets\": [\n \"<string>\"\n ],\n \"source\": [],\n \"market\": [],\n \"estate_usages\": [],\n \"min_price\": 1,\n \"max_price\": 1,\n \"min_saleable_area\": 1,\n \"max_saleable_area\": 1,\n \"min_price_per_sqft\": 1,\n \"max_price_per_sqft\": 1,\n \"min_building_age\": 1,\n \"max_building_age\": 1,\n \"bedroom_counts\": [\n 2\n ],\n \"developers\": [\n \"<string>\"\n ],\n \"sort\": \"InsOrRegDate\"\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/centaline/transactions/search")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 2,\n \"timeout\": 300,\n \"lang\": \"hk\",\n \"keyword\": \"<string>\",\n \"hma_ids\": [\n \"<string>\"\n ],\n \"estates\": [\n \"<string>\"\n ],\n \"order\": \"Ascending\",\n \"deal_type\": \"Sale\",\n \"period\": \"Day30\",\n \"phases\": [\n \"<string>\"\n ],\n \"primary_school_nets\": [\n \"<string>\"\n ],\n \"source\": [],\n \"market\": [],\n \"estate_usages\": [],\n \"min_price\": 1,\n \"max_price\": 1,\n \"min_saleable_area\": 1,\n \"max_saleable_area\": 1,\n \"min_price_per_sqft\": 1,\n \"max_price_per_sqft\": 1,\n \"min_building_age\": 1,\n \"max_building_age\": 1,\n \"bedroom_counts\": [\n 2\n ],\n \"developers\": [\n \"<string>\"\n ],\n \"sort\": \"InsOrRegDate\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/centaline/transactions/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\": \"hk\",\n \"keyword\": \"<string>\",\n \"hma_ids\": [\n \"<string>\"\n ],\n \"estates\": [\n \"<string>\"\n ],\n \"order\": \"Ascending\",\n \"deal_type\": \"Sale\",\n \"period\": \"Day30\",\n \"phases\": [\n \"<string>\"\n ],\n \"primary_school_nets\": [\n \"<string>\"\n ],\n \"source\": [],\n \"market\": [],\n \"estate_usages\": [],\n \"min_price\": 1,\n \"max_price\": 1,\n \"min_saleable_area\": 1,\n \"max_saleable_area\": 1,\n \"min_price_per_sqft\": 1,\n \"max_price_per_sqft\": 1,\n \"min_building_age\": 1,\n \"max_building_age\": 1,\n \"bedroom_counts\": [\n 2\n ],\n \"developers\": [\n \"<string>\"\n ],\n \"sort\": \"InsOrRegDate\"\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"@type": "CentalineTransaction",
"url": "<string>",
"deal_type": "<string>",
"estate_group_name": "<string>",
"estate_name": "<string>",
"building_name": "<string>",
"address": "<string>",
"district": "<string>",
"floor_level": "<string>",
"unit": "<string>",
"price": 123,
"gross_area": 123,
"saleable_area": 123,
"gross_price_per_sqft": 123,
"saleable_price_per_sqft": 123,
"bedroom_count": 123,
"direction": "<string>",
"unit_type_code": "<string>",
"estate_structure": "<string>",
"occupation_year": "<string>",
"source": "<string>",
"market": "<string>",
"instrument_at": 123,
"registered_at": 123,
"building_group_id": "<string>",
"building_group_name": "<string>",
"unit_code": "<string>",
"type_code": "<string>",
"scope": {
"@type": "CentalineScope",
"region": "<string>",
"region_code": "<string>",
"district": "<string>",
"district_code": "<string>",
"area": "<string>",
"area_code": "<string>",
"hma": "<string>",
"hma_id": "<string>",
"hma_description": "<string>",
"image": "<string>"
},
"media": {
"@type": "CentalineMediaFlags",
"has_media": true,
"has_photos": true,
"has_street_view": true,
"has_sphere": true,
"has_video": true,
"has_virtual_tour": true,
"has_floor_plan": true,
"has_planning_diagram": true,
"has_unit_plan": true,
"has_aerial_view": true,
"has_building_3d_model": true
},
"image": "<string>",
"floor_plans": []
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}/centaline/transactions/search
Search Hong Kong property transactions recorded by Centaline — Land Registry filings plus Centaline’s own closed deals, covering roughly three years of sales and leases. Filter by deal type, look-back period, free-text keyword, Housing Market Area, estate and phase type codes, primary school net, record source, first- or second-hand market, ownership category, price, saleable area, price per saleable sq ft, building age, bedroom count and developer, ordered by date, price, area or price per sq ft. Each record has the address down to the unit, price, gross and saleable areas with per-sq-ft rates, bedroom count, orientation, occupation year, building group, instrument and registration dates and coordinates.
Price: 5 credits per 100 results
curl --request POST \
--url https://api.anysite.io/api/centaline/transactions/search \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"count": 2,
"timeout": 300,
"lang": "hk",
"keyword": "<string>",
"hma_ids": [
"<string>"
],
"estates": [
"<string>"
],
"order": "Ascending",
"deal_type": "Sale",
"period": "Day30",
"phases": [
"<string>"
],
"primary_school_nets": [
"<string>"
],
"source": [],
"market": [],
"estate_usages": [],
"min_price": 1,
"max_price": 1,
"min_saleable_area": 1,
"max_saleable_area": 1,
"min_price_per_sqft": 1,
"max_price_per_sqft": 1,
"min_building_age": 1,
"max_building_age": 1,
"bedroom_counts": [
2
],
"developers": [
"<string>"
],
"sort": "InsOrRegDate"
}
'import requests
url = "https://api.anysite.io/api/centaline/transactions/search"
payload = {
"count": 2,
"timeout": 300,
"lang": "hk",
"keyword": "<string>",
"hma_ids": ["<string>"],
"estates": ["<string>"],
"order": "Ascending",
"deal_type": "Sale",
"period": "Day30",
"phases": ["<string>"],
"primary_school_nets": ["<string>"],
"source": [],
"market": [],
"estate_usages": [],
"min_price": 1,
"max_price": 1,
"min_saleable_area": 1,
"max_saleable_area": 1,
"min_price_per_sqft": 1,
"max_price_per_sqft": 1,
"min_building_age": 1,
"max_building_age": 1,
"bedroom_counts": [2],
"developers": ["<string>"],
"sort": "InsOrRegDate"
}
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: 'hk',
keyword: '<string>',
hma_ids: ['<string>'],
estates: ['<string>'],
order: 'Ascending',
deal_type: 'Sale',
period: 'Day30',
phases: ['<string>'],
primary_school_nets: ['<string>'],
source: [],
market: [],
estate_usages: [],
min_price: 1,
max_price: 1,
min_saleable_area: 1,
max_saleable_area: 1,
min_price_per_sqft: 1,
max_price_per_sqft: 1,
min_building_age: 1,
max_building_age: 1,
bedroom_counts: [2],
developers: ['<string>'],
sort: 'InsOrRegDate'
})
};
fetch('https://api.anysite.io/api/centaline/transactions/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/centaline/transactions/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' => 'hk',
'keyword' => '<string>',
'hma_ids' => [
'<string>'
],
'estates' => [
'<string>'
],
'order' => 'Ascending',
'deal_type' => 'Sale',
'period' => 'Day30',
'phases' => [
'<string>'
],
'primary_school_nets' => [
'<string>'
],
'source' => [
],
'market' => [
],
'estate_usages' => [
],
'min_price' => 1,
'max_price' => 1,
'min_saleable_area' => 1,
'max_saleable_area' => 1,
'min_price_per_sqft' => 1,
'max_price_per_sqft' => 1,
'min_building_age' => 1,
'max_building_age' => 1,
'bedroom_counts' => [
2
],
'developers' => [
'<string>'
],
'sort' => 'InsOrRegDate'
]),
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/centaline/transactions/search"
payload := strings.NewReader("{\n \"count\": 2,\n \"timeout\": 300,\n \"lang\": \"hk\",\n \"keyword\": \"<string>\",\n \"hma_ids\": [\n \"<string>\"\n ],\n \"estates\": [\n \"<string>\"\n ],\n \"order\": \"Ascending\",\n \"deal_type\": \"Sale\",\n \"period\": \"Day30\",\n \"phases\": [\n \"<string>\"\n ],\n \"primary_school_nets\": [\n \"<string>\"\n ],\n \"source\": [],\n \"market\": [],\n \"estate_usages\": [],\n \"min_price\": 1,\n \"max_price\": 1,\n \"min_saleable_area\": 1,\n \"max_saleable_area\": 1,\n \"min_price_per_sqft\": 1,\n \"max_price_per_sqft\": 1,\n \"min_building_age\": 1,\n \"max_building_age\": 1,\n \"bedroom_counts\": [\n 2\n ],\n \"developers\": [\n \"<string>\"\n ],\n \"sort\": \"InsOrRegDate\"\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/centaline/transactions/search")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 2,\n \"timeout\": 300,\n \"lang\": \"hk\",\n \"keyword\": \"<string>\",\n \"hma_ids\": [\n \"<string>\"\n ],\n \"estates\": [\n \"<string>\"\n ],\n \"order\": \"Ascending\",\n \"deal_type\": \"Sale\",\n \"period\": \"Day30\",\n \"phases\": [\n \"<string>\"\n ],\n \"primary_school_nets\": [\n \"<string>\"\n ],\n \"source\": [],\n \"market\": [],\n \"estate_usages\": [],\n \"min_price\": 1,\n \"max_price\": 1,\n \"min_saleable_area\": 1,\n \"max_saleable_area\": 1,\n \"min_price_per_sqft\": 1,\n \"max_price_per_sqft\": 1,\n \"min_building_age\": 1,\n \"max_building_age\": 1,\n \"bedroom_counts\": [\n 2\n ],\n \"developers\": [\n \"<string>\"\n ],\n \"sort\": \"InsOrRegDate\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/centaline/transactions/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\": \"hk\",\n \"keyword\": \"<string>\",\n \"hma_ids\": [\n \"<string>\"\n ],\n \"estates\": [\n \"<string>\"\n ],\n \"order\": \"Ascending\",\n \"deal_type\": \"Sale\",\n \"period\": \"Day30\",\n \"phases\": [\n \"<string>\"\n ],\n \"primary_school_nets\": [\n \"<string>\"\n ],\n \"source\": [],\n \"market\": [],\n \"estate_usages\": [],\n \"min_price\": 1,\n \"max_price\": 1,\n \"min_saleable_area\": 1,\n \"max_saleable_area\": 1,\n \"min_price_per_sqft\": 1,\n \"max_price_per_sqft\": 1,\n \"min_building_age\": 1,\n \"max_building_age\": 1,\n \"bedroom_counts\": [\n 2\n ],\n \"developers\": [\n \"<string>\"\n ],\n \"sort\": \"InsOrRegDate\"\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"@type": "CentalineTransaction",
"url": "<string>",
"deal_type": "<string>",
"estate_group_name": "<string>",
"estate_name": "<string>",
"building_name": "<string>",
"address": "<string>",
"district": "<string>",
"floor_level": "<string>",
"unit": "<string>",
"price": 123,
"gross_area": 123,
"saleable_area": 123,
"gross_price_per_sqft": 123,
"saleable_price_per_sqft": 123,
"bedroom_count": 123,
"direction": "<string>",
"unit_type_code": "<string>",
"estate_structure": "<string>",
"occupation_year": "<string>",
"source": "<string>",
"market": "<string>",
"instrument_at": 123,
"registered_at": 123,
"building_group_id": "<string>",
"building_group_name": "<string>",
"unit_code": "<string>",
"type_code": "<string>",
"scope": {
"@type": "CentalineScope",
"region": "<string>",
"region_code": "<string>",
"district": "<string>",
"district_code": "<string>",
"area": "<string>",
"area_code": "<string>",
"hma": "<string>",
"hma_id": "<string>",
"hma_description": "<string>",
"image": "<string>"
},
"media": {
"@type": "CentalineMediaFlags",
"has_media": true,
"has_photos": true,
"has_street_view": true,
"has_sphere": true,
"has_video": true,
"has_virtual_tour": true,
"has_floor_plan": true,
"has_planning_diagram": true,
"has_unit_plan": true,
"has_aerial_view": true,
"has_building_3d_model": true
},
"image": "<string>",
"floor_plans": []
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
API token from the dashboard
Headers
Body
x >= 120 <= x <= 1500hk, sc, en Ascending, Descending Sale, Rent Day30, Day90, Day180, Day365, Day1095 Land, AC FirstHand, SecondHand RE, HOS, PRH, Carpark, Other x >= 0x >= 0x >= 0x >= 0x >= 0x >= 0x >= 0x >= 00 <= x <= 4InsOrRegDate, Price, NSize, NUnitPrice Response
Successful Response
Show child attributes
Show child attributes
Show child attributes
Show child attributes