SAGA APIsaga.hamburg ↗
Access live office, apartment, and parking listings from SAGA Hamburg via one API endpoint. Filter by category, get rent, area, and availability data.
What is the SAGA API?
The SAGA Hamburg API provides access to current rental property listings from one of Hamburg's largest housing companies through a single search_offices endpoint. Each response includes up to the full current inventory of offices, apartments, or parking spots, returning structured data across fields such as address, rent, available area, and availability status — all filterable by the category parameter.
curl -X GET 'https://api.parse.bot/scraper/8fe7e14d-e42e-45e8-abd3-c3eb2b016d04/search_offices?category=OFFICE' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace saga-hamburg-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: SAGA Hamburg property search — bounded, re-runnable; every call capped."""
from parse_apis.saga_hamburg_api import Saga, Category, InvalidCategory
client = Saga()
# Search for commercial/office listings (the default category).
for listing in client.listings.search(category=Category.OFFICE, limit=3):
print(listing.title, listing.district, listing.total_rent_eur)
# Take one listing to inspect its details.
office = client.listings.search(category=Category.OFFICE, limit=1).first()
if office:
print(office.address, office.area_m2, office.available_from)
print(f"Location: {office.latitude}, {office.longitude}")
# Typed error: catch invalid category input.
try:
client.listings.search(category=Category.PARKING, limit=1).first()
except InvalidCategory as e:
print(f"bad category: {e.category}")
print("exercised: listings.search")
Search for available property listings in Hamburg by category. Returns all currently listed properties including offices, apartments, or parking spots with address, rent, area, and availability details. Results are returned in a single page (no pagination).
| Param | Type | Description |
|---|---|---|
| category | string | Property category to search. |
{
"type": "object",
"fields": {
"total": "number of listings found",
"category": "selected category code",
"listings": "array of property listing objects"
},
"sample": {
"data": {
"total": 11,
"category": "OFFICE",
"listings": [
{
"title": "Existenzgründerbüro 3 - 1 Zimmer",
"address": "Havighorster Redder 39, 22115 Hamburg",
"area_m2": "24,16",
"district": "Billstedt",
"latitude": "53.5277585",
"longitude": "10.1477334",
"detail_path": "/immobiliensuche/immo-detail/6184/existenzgrunderburo-3-1-zimmer",
"available_from": "2026-01-01",
"total_rent_eur": "483,03"
}
]
},
"status": "success"
}
}About the SAGA API
What the API Returns
The search_offices endpoint queries SAGA Hamburg's live property inventory and returns a structured response containing a total count of matching listings alongside a listings array of individual property objects. Each listing carries address details, rental price, floor area, and availability information. The category input parameter lets you scope results to a specific property type — commercial office spaces, residential apartments, or parking facilities.
Filtering and Response Shape
Passing a value to the category parameter narrows results to that property type, and the response echoes back the selected category code alongside the matched listings. If category is omitted, the endpoint applies a default category. Results are returned in a single flat array — there is no cursor or page token, so the full result set for a given category arrives in one response.
Data Coverage
All listings reflect SAGA Hamburg's current publicly advertised availability. Fields per listing include rent amount, usable area (square meters), address, and availability date or status. The data covers only properties actively listed by SAGA Hamburg at the time of the request — historical listings, expired offers, and properties from other Hamburg landlords are not included.
The SAGA API is a managed, monitored endpoint for saga.hamburg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when saga.hamburg changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official saga.hamburg API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new office space availability in Hamburg by polling the API and diffing
totalcounts over time - Build a rental alert tool that notifies users when apartments matching their area or rent range appear in
listings - Aggregate current SAGA Hamburg parking spot availability for a Hamburg mobility or logistics app
- Feed live commercial property data into a Hamburg real estate market dashboard
- Compare SAGA Hamburg office rents and floor areas across listed properties for tenant research tools
- Track how quickly listings are added or removed to estimate vacancy turnover rates
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SAGA Hamburg provide an official developer API?+
What property categories can I retrieve with the search_offices endpoint?+
category parameter accepts values corresponding to commercial offices, residential apartments, and parking spots. The response includes a category field confirming which category was applied, and total reflects the count of listings found under that category at the time of the request.