មគ្គុទ្ទេសក៍សមាហរណកម្ម Housing Market API

តារាងយោង ការពិពណ៌នាចំណុចបញ្ចប់ (endpoint) កូដកំហុស និងឧទាហរណ៍ ត្រូវបានបង្កើតចេញពីលក្ខណៈបច្ចេកទេសរបស់ API ហើយនៅតែជាភាសាអង់គ្លេសនៅគ្រប់ភាសា។ ឈ្មោះ ប៉ារ៉ាម៉ែត្រ និងកូដ គឺដូចគ្នានៅគ្រប់កន្លែង។

តម្រង

ប៉ារ៉ាម៉ែត្រ country គឺចាំបាច់។ តម្រងផ្សេងទៀតនីមួយៗធ្វើឱ្យលទ្ធផលតូចចង្អៀតជាងមុន ហើយតម្រងអាចប្រើរួមគ្នាបាន។

ប៉ារ៉ាម៉ែត្រដែលចំណុចបញ្ចប់មិនបានកំណត់ ត្រូវបានបដិសេធដោយ invalid_parameter ជំនួសឱ្យការមិនអើពើ ដូច្នេះតម្រងដែលសរសេរខុសមិនអាចត្រឡប់ទំព័រដែលមិនបានត្រងដោយស្ងាត់ៗបានទេ។

ទីកន្លែងអាចត្រងតាមលេខសម្គាល់ ឬតាមឈ្មោះ។ ឈ្មោះត្រូវបានផ្គូផ្គងដោយមិនគិតពីអក្សរធំ ឬអក្សរតូច។ សម្រាប់កម្រិតនីមួយៗ សូមប្រើឈ្មោះ ឬលេខសម្គាល់ មិនមែនទាំងពីរទេ។

តម្រងតម្លៃប្រៀបធៀបលេខដូចដែលបានបោះពុម្ពផ្សាយ ជារូបិយប័ណ្ណរបស់ការផ្សាយនីមួយៗផ្ទាល់។ គ្មានអ្វីត្រូវបានប្ដូររូបិយប័ណ្ណទេ។

ទស្សន៍ទ្រនិច (cursor) មួយជាកម្មសិទ្ធិរបស់តម្រងដែលវាត្រូវបានចេញឱ្យ។ ដើម្បីផ្លាស់ប្ដូរតម្រង សូមចាប់ផ្ដើមម្ដងទៀតពីទំព័រទីមួយ។

ប៉ារ៉ាម៉ែត្ររបស់ GET /v1/properties

Parameter	Type	Required	Values	Description
`country`	`string`	yes	pattern `^[A-Z]{2}$`	ISO 3166-1 alpha-2 code of the country, for example `TH`. A country outside your subscription is refused with `country_not_entitled`.
`listing_type`	`string`	no	`all` `sale` `rent` default `all`	Which kind of listing to include. `all` is the default.
`property_type`	`string`	no		Return only this property type, for example `condominium`. The value is the `property_type` that listings carry; an unknown value returns an empty page.
`province_id`	`integer`	no	min `1`	Return only listings in this province or state, by the `province_id` listings carry.
`city`	`string`	no		Return only listings in this city, matched by name without regard to case. Do not combine with `city_id`.
`city_id`	`integer`	no	min `1`	Return only listings in this city, by the `city_id` listings carry.
`area`	`string`	no		Return only listings in this district or area, matched by name without regard to case. Do not combine with `area_id`.
`area_id`	`integer`	no	min `1`	Return only listings in this district or area, by the `area_id` listings carry.
`min_price`	`number`	no	min `0`	Lowest price to include, in the listing's own currency. Prices are never converted, so in a country with listings in more than one currency the filter compares the number as published.
`max_price`	`number`	no	min `0`	Highest price to include, in the listing's own currency.
`min_bedrooms`	`integer`	no	min `0`	Fewest bedrooms to include. Listings that do not state a number of bedrooms are left out.
`max_bedrooms`	`integer`	no	min `0`	Most bedrooms to include. Listings that do not state a number of bedrooms are left out.
`published_since`	`string`	no		Return only listings first published at or after this instant: a date (`YYYY-MM-DD`, read as midnight UTC) or a date-time with a time zone, for example `2026-10-01T00:00:00Z`. A date-time without a time zone is refused with `invalid_parameter`.
`updated_since`	`string`	no		Return only listings whose `last_updated` is at or after this instant, in the same format as `published_since`. Use it to fetch what changed since your last walk. A listing that has been withdrawn is not returned; request it by `id` to confirm it is gone.
`limit`	`integer`	no	default `50` min `1` max `100`	Page size. At most the maximum shown; larger values are refused with `invalid_parameter`.
`cursor`	`string`	no		The `next_cursor` of the previous page. Opaque: do not parse it, store it, or build one. It is bound to your key and to the filters of the request that produced it, and a cursor used with different filters is refused with `invalid_cursor`.