Rumah123 Search API searches homes for sale and for rent in Indonesia. Each item has the listing id, URL, property type, price in IDR (number and text), address, coordinates, bedrooms, bathrooms, land and building size, certificate, furnishing, agent and all photos. Filters are always honoured: a listing that breaks a requested filter is never returned, and meta.filtered_out shows how many were removed from the page. Rent searches without a property type cover all six types. Searches reach page 2500 (50,000 listings); a higher page is an error, and every page carries its own data. Narrow big searches with a location and filters. A valid empty result is a successful, billable answer.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
19 optional filters available.
string
Optional
Location id from the autocomplete route. Leave empty to search all of Indonesia.
1234567890
string
Optional
sale (default) or rent.
example
string
Optional
Comma separated: house, apartment, shophouse, villa, retail, land.
example
integer
Optional
Minimum price in IDR. For rent this is the price per rent period.
10
integer
Optional
Maximum price in IDR. Must not be below min_price.
10
integer
Optional
Minimum bedrooms.
10
integer
Optional
Maximum bedrooms.
10
integer
Optional
Minimum bathrooms.
10
integer
Optional
Maximum bathrooms.
10
integer
Optional
Minimum land size in square meters.
10
integer
Optional
Maximum land size in square meters.
10
integer
Optional
Minimum building size in square meters.
10
integer
Optional
Maximum building size in square meters.
10
string
Optional
daily, weekly, monthly or annual. Rent searches only.
example
string
Optional
furnished, semi_furnished or unfurnished.
example
string
Optional
shm, hgb, ppjb or strata.
example
boolean
Optional
true to keep only listings with a price drop.
true
string
Optional
newest (default), price_asc or price_desc.
relevance
integer
Optional
One-based page number, 1 to 2500. Each page has 20 listings.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": "hos41188791",
"url": "https://www.rumah123.com/en/property/jakarta-selatan-jagakarsa/disewakan-rumah-komplek-mewah-selangkah-dari-gerbang-tol-brigif-fasilitas-kolam-renanang-club-house-lapangan-tenis-bulu-hos41188791/",
"uuid": "d0bddf68-2aae-4456-abcd-4cd809cfc581",
"agent": {
"id": "61740",
"name": "Hendra"
},
"price": {
"value": 99000000,
"display": "Rp 99 Juta",
"currency": "IDR",
"per_meter": 687500
},
"title": "For Rent: Luxury Complex House Just Steps from Brigif Toll Gate, Facilities Include Swimming Pool, Club House, Tennis Court, Badminton Court, Jogging Track, Jagakarsa, South Jakarta",
"floors": 2,
"images": [
"https://picture.rumah123.com/r123-images/1080x720-fit/customer/61740/c336595d45668614aedcfade2c852879.webp",
"https://picture.rumah123.com/r123-images/1080x720-fit/customer/61740/01523d2afaee5740edd122d97bea59ba.webp",
"https://picture.rumah123.com/r123-images/1080x720-fit/customer/61740/14228da673f682841a5d52e190b71f2a.webp"
],
"address": "Jakarta, Jakarta Selatan, Jagakarsa",
"bedrooms": 4,
"location": {
"lat": -6.33406498,
"lng": 106.8222591,
"city": "Jakarta Selatan",
"name": "Jagakarsa",
"text": "Jagakarsa, Jakarta Selatan",
"uuid": "3b0b6e48-3d48-455d-bb23-f248e9fb37de",
"district": "Jagakarsa",
"province": "DKI Jakarta"
},
"bathrooms": 3,
"condition": null,
"posted_at": "2026-08-30T17:19:20+00:00",
"rent_type": null,
"created_at": "2026-03-10T06:30:29+00:00",
"furnishing": null,
"updated_at": "2026-08-30T17:19:18+00:00",
"certificate": "SHM",
"electricity": "Others",
"image_count": 10,
"land_size_m2": 144,
"listing_type": "sale",
"is_price_drop": false,
"property_type": {
"code": 0,
"slug": "house",
"label": "House"
},
"building_size_m2": 160
},
{
"id": "hos42371530",
"url": "https://www.rumah123.com/en/property/jakarta-selatan-kebagusan/disewakan-rumah-townhouse-siap-huni-strategis-kebagusan-pasar-minggu-jaksel-hos42371530/",
"uuid": "fb1692f6-edcb-4000-a8a5-15466a93a5eb",
"agent": {
"id": "1447615",
"name": "RE/MAX FAST",
"organization": "Re/max Fast"
},
"price": {
"value": 110000000,
"display": "Rp 110 Juta",
"currency": "IDR",
"per_meter": 753425
},
"title": "Furnished Townhouse for Rent, Strategic Location - Kebagusan, Pasar Minggu - South Jakarta",
"floors": 2,
"images": [
"https://picture.rumah123.com/r123-images/1080x720-fit/customer/1447615/47e95aa90232e1c15ca3fd4a6d901081.jpg",
"https://picture.rumah123.com/r123-images/1080x720-fit/customer/1447615/6b382c841f858b3792e29e35de866803.jpg",
"https://picture.rumah123.com/r123-images/1080x720-fit/customer/1447615/2ed30fa26e44629383ef95e53a58346f.jpg"
],
"address": "Kebagusan",
"bedrooms": 5,
"location": {
"lat": -6.301786799999999,
"lng": 106.8262867,
"city": "Jakarta Selatan",
"name": "Kebagusan",
"text": "Kebagusan, Jakarta Selatan",
"uuid": "a8f0b563-d227-4aa2-b42f-9b96cd7d03ca",
"district": "Kebagusan",
"province": "DKI Jakarta"
},
"bathrooms": 4,
"condition": null,
"posted_at": "2026-09-09T11:28:22+00:00",
"rent_type": null,
"created_at": "2026-09-09T11:28:21+00:00",
"furnishing": null,
"updated_at": "2026-09-09T11:28:22+00:00",
"certificate": "Strata",
"electricity": "Others",
"image_count": 4,
"land_size_m2": 146,
"listing_type": "sale",
"is_price_drop": false,
"property_type": {
"code": 0,
"slug": "house",
"label": "House"
},
"building_size_m2": 150
}
],
"pagination": {
"max_page": 2500,
"per_page": 20,
"page_count": 2500,
"total_count": 114969,
"current_page": 1
},
"filters_applied": {
"sort": "price_asc",
"location_id": "fd7063ac-b425-49de-a925-abcc4a2aa2db",
"listing_type": "sale",
"min_bedrooms": 3,
"property_type": [
"house"
]
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a range is invalid, or the page is above 2500, or rent_type is used with a sale search. This response is not billable.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Rumah123 could not be reached or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Rumah123 could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.