darak

The official Python client for the Darak API: every live rental and sale listing in Saudi Arabia, deduplicated across 13+ sources. Standard library only, Python 3.9+.

pip install darak

from darak import Darak, DarakError

darak = Darak()  # reads DARAK_API_KEY

page = darak.listings.search(city="riyadh", listing_type="rent", beds=3, limit=25)
print(page["data"][0]["price"]["yearly_sar"])

# Every result, fetching pages as you go (stops at your plan's paging depth).
for listing in darak.listings.search_all(city="jeddah", listing_type="sale"):
    print(listing["id"], listing["location"]["neighborhood_name_en"])

try:
    darak.listings.get(1)
except DarakError as e:
    print(e.status, e.code, e.request_id)

Get a key at platform.darak.app.

• Lists are sent comma-separated: property_type=["apartment", "villa"].
• 429 and 5xx (and network errors) are retried, honoring Retry-After. A monthly-quota 429 isn't waited out; it raises.
• Methods: listings.search / search_all / count / get / batch / price_history, cities.list / neighborhoods / directions, enums(), broker_listings(...), and request(method, path, query, body) for anything else.

Tests: python3 -m unittest discover -s tests.