Endpoint Playground
Returns Homes & Apartments results for an Agoda city: full listing detail for every matching property whose accommodation type is Apartment. Callers may supply a known Agoda city id or a free-text city name; when both are supplied city_id takes precedence.
14 Oct 2026: 3 homes; 12 fields had a value in every checked item and 1 varied between items.
Sample value profiles: rating: 2 to 4, median 3.5; description_short: “. Unwind and Enjoy at The Quarter Ploenchit by UHG (SHA Plu…” and 2 other values; main_image_url: pix8.agoda.net.
curl 'https://api.crawlora.net/api/v1/agoda/homes/search' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| city_id | integer | No | Numeric Agoda city id, e.g. 9395 for Bangkok. Either city_id or city is required; city_id takes precedence when both are supplied. | |
| city | string | No | Free-text city name, resolved to a numeric city id via Agoda's own destination search. Ignored when city_id is also supplied. | |
| page | integer | No | 1-indexed result page over the underlying city search, defaults to 1 | |
| limit | integer | No | Candidate listings fetched per page before filtering to homes/apartments, defaults to 10, maximum 50 |
{
"code": 200,
"msg": "OK",
"data": {
"city_id": 9395,
"page": 1,
"limit": 10,
"count": 1,
"homes": [
{
"property_id": 149146,
"display_name": "Diamond Bangkok Apartment",
"accommodation_type": 120,
"rating": 3.5,
"address": {
"city": {
"id": 9395,
"name": "Bangkok"
},
"country": {
"id": 106,
"name": "Thailand"
}
},
"source_url": "https://www.agoda.com/search?cid=-1&selectedproperty=149146&city=9395"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.