sakani.sa APIsakani.sa ↗
Access Saudi Arabia's official Sakani housing portal via API. Retrieve popular land projects, property units, price ranges, and developer info in structured JSON.
curl -X GET 'https://api.parse.bot/scraper/3c3b72cb-83ce-403f-b898-78ebf5629b32/get_popular_projects?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Get popular land/real estate projects from the marketplace. Returns projects sorted by popularity with details including pricing, developer info, media, and unit statistics.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of projects to return. |
| city_id | integer | Filter by city ID (e.g. 14 for Riyadh). |
| region_id | integer | Filter by region ID (e.g. 1 for Riyadh region). |
| project_type | string | Filter by project type. Observed values: 'offplan_private_land', 'offplan_moh_land', 'villa', 'townhouse'. |
{
"type": "object",
"fields": {
"total": "integer - Total number of projects returned",
"projects": "array of project objects with project_id, project_name, project_code, project_type, city, region, location, min_price, max_price, developer_name, tags, views_count, media, units_statistics"
},
"sample": {
"data": {
"total": 5,
"projects": [
{
"city": "الرياض",
"tags": {
"promoted": false,
"sold_out": false,
"availability": true
},
"media": {
"banner": {
"url": "https://jed-s3.bluvalt.com/sakani-prod-media-assets/uploads/published_medium/file/696c9202ba3079ccccd11745/high_17-park_side_Khuzam__1_.jpg"
},
"gallery": [],
"master_plan": {}
},
"region": "الرياض",
"city_id": 14,
"geohash": "th3nj0",
"location": {
"lat": 24.965245,
"lon": 46.634595
},
"max_price": 2204073,
"min_price": 376451,
"region_id": 1,
"project_id": "project_1458",
"unit_types": [
"apartment"
],
"description": "",
"views_count": 522767,
"availability": true,
"project_code": "02-01-0121",
"project_name": "تلال خزام - الرياض",
"project_type": "offplan_private_land",
"subsidizable": true,
"developer_name": "شركة تلال الخزام للتطوير و الاستثمارالعقاري",
"units_statistics": {
"all_units_count": 3655,
"available_units_count": 505
},
"marketplace_price": 376451,
"available_units_count": 0
}
]
},
"status": "success"
}
}About the sakani.sa API
The Sakani.sa API exposes 4 endpoints covering Saudi Arabia's official government housing marketplace, returning structured data on land projects, residential units, and market price ceilings. The get_popular_projects endpoint returns project-level records including pricing, city/region identifiers, developer info, and unit statistics, while get_popular_units lets you filter individual listings by bedroom count, unit type, and SAR price range.
Projects and Units
get_popular_projects returns an array of project objects sorted by popularity. Each record includes project_id, project_name, project_code, project_type, geographic fields (city, region, location), and a min_price/max_price range. You can narrow results with city_id (e.g. 14 for Riyadh), region_id (e.g. 1 for Riyadh region), or project_type values such as offplan_private_land, offplan_moh_land, villa, or townhouse. A limit parameter controls how many records come back.
Unit-Level Listings
get_popular_units returns individual property records rather than project aggregates. Each unit object carries unit_id, unit_code, unit_type, unit_size, price, bedroom_count, bathroom_count, floor, status, and a nested project reference. Filtering parameters include unit_type (apartment, villa, townhouse, land, house), bedrooms, min_price/max_price in SAR, city_id, and region_id.
Price Range and Versioning
get_price_ranges returns the two ceiling values currently live in the marketplace: max_price (highest sale price in SAR) and max_rental_price (highest rental price in SAR). These are useful for calibrating slider bounds in search UIs without hard-coding numbers. get_version_info returns a version hash string identifying the current API deployment, which can help detect when the underlying data schema changes.
- Build a property search UI for Saudi buyers, filtering units by bedroom count, city, and SAR price range via get_popular_units
- Track off-plan land project availability in Riyadh by querying get_popular_projects with city_id=14 and project_type=offplan_moh_land
- Populate dynamic price-range sliders in a real estate app using the max_price and max_rental_price values from get_price_ranges
- Compare min and max project pricing across Saudi regions by iterating get_popular_projects with different region_id values
- Monitor new villa and townhouse listings on Sakani by periodically polling get_popular_units with unit_type filters
- Aggregate developer and project metadata for a Saudi real estate dataset using project_id, project_name, and location fields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Sakani.sa have an official developer API?+
How do city and region filters work in get_popular_projects and get_popular_units?+
city_id and region_id as integer parameters. For example, passing city_id=14 scopes results to Riyadh, and region_id=1 targets the broader Riyadh administrative region. The two filters can be combined or used independently.Does the API return rental listings or only sale listings?+
get_popular_units endpoint returns sale-oriented unit records, and get_price_ranges exposes a max_rental_price ceiling, but there is no dedicated endpoint for browsing individual rental listings. The API currently covers sale projects and units. You can fork it on Parse and revise it to add a rental listings endpoint.Is project and unit data paginated, or does the API return everything at once?+
get_popular_projects and get_popular_units accept a limit parameter to cap the number of records returned, but there is no offset or cursor parameter for paginating through the full dataset. Results reflect the top items sorted by popularity up to the specified limit.Does the API include neighborhood-level location data or coordinates for listings?+
location field, but the API does not currently expose discrete latitude/longitude coordinates or neighborhood-level breakdowns as standalone filterable fields. Geographic filtering is limited to city_id and region_id. You can fork the API on Parse and revise it to surface coordinate or neighborhood fields if those are present in the source data.