Project brief for development:
Monitoring system for new listings on Immomio and Saga Hamburg + Telegram bot
1. Project goal
Create a system that will track the appearance of new available housing listings in real-time on:
- Immomio (invitations/Expose/Apply links with working tokens)
- SAGA Hamburg (new offers on the portal)
and send them instantly to Telegram.
2. Project tasks
2.1. IMMOMIO automatic retrieval of new listings
A mechanism is required that will:
A) Retrieve only those listings and links that are valid and eligible for application submission.
That is, the system must:
✔ determine that the listing exists
✔ extract the correct working token
✔ check that the link opens for the user and is not a placeholder
✔ send to Telegram:
B) Capture new listings as quickly as possible (1–10 seconds)
Monitoring of the source is required so that the listing reaches Telegram within the first seconds of its appearance.
C) The data source must be found by the contractor
Client's requirement:
“I don't care how exactly the contractor will obtain data via API, hidden requests, notifications, GraphQL, WebSocket, personal account, cookie — the main thing is that the links are working and appear quickly.”
This means:
- It is necessary to investigate the network requests of Immomio
- Determine the point where new Application Links appear
- Find a way to extract a valid token
- Bypass the issue with Expose → Apply, so that the links open for the client
D) Check the validity of the link
The contractor is obliged to:
- Check the HTTP code (200, 401, 404, 403)
- Check for the presence of a placeholder: “Kein Zugriff”, “Kein gültiges Angebot”, “Nicht verfügbar”
- Check if the page opens without errors
E) Exclude ID guessing or scanning non-existent pages
The system must not work through:
❌ brute force ID
❌ random token generation
❌ bypassing the client's login
but through a real data source from Immomio that provides valid listings.
2.2. SAGA Hamburg — monitoring new listings
A scanner for the website is required:
🔗 https://www.saga.hamburg/
The system must:
✔ find new rental offers
✔ extract data: address, price, area, link
✔ check availability
✔ send new listings to Telegram
Check frequency: every 3–15 seconds
Data source: to be determined by the contractor (HTML, API, RSS, hidden requests).
3. Telegram bot
The bot must:
- receive new listings from both systems
- send nicely formatted messages:
🏠 New listing (IMMOMIO)
Address: …
Price: …
Area: …
Status: verfügbar
Link: https://tenant.immomio.com/apply/ID?token=...
---
🏠 New listing (SAGA Hamburg)
- work 24/7
- store a database of already sent links
- not send duplicates
- restart after errors
4. Technical requirements
The contractor must:
- identify the real APIs / network requests of the Immomio and Saga systems
- develop a mechanism to bypass dynamic tokens of Immomio
- implement a listing validator
- ensure high update speed
- not violate the rules of the websites
- provide the source code
5. What is required as output
✔ Monitoring script for Immomio with working tokens
✔ Monitoring script for SAGA Hamburg
✔ Telegram bot
✔ Installation instructions (Linux)
✔ Source code (Python or Node.js)
6. Deadlines and budget
The contractor must specify:
- Estimated timelines
- Cost of work
- What methods of data retrieval they plan to use
