xe APIxe.gr ↗
Access residential rental listings from xe.gr in Greece. Get price, location, size, bedrooms, images, and new listing alerts via two simple endpoints.
What is the xe API?
The xe.gr API exposes 2 endpoints for tracking residential rental property listings across Greece. get_recent_rentals returns the current set of listings with fields including price, address, geo coordinates, bedroom and bathroom counts, size, images, and a direct URL. get_new_listings_alert compares against previously seen listings within a session and surfaces only entries posted since the last call — making it straightforward to build real-time property alert workflows.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/242bbfb2-cc29-4cd4-874c-2ed2fc3d0aec/get_recent_rentals' \ -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 xe-gr-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.
from parse_apis.xe_gr_property_api import XeGr, Listing
client = XeGr()
# List recent rental properties in Greece
for listing in client.listings.list_recent():
print(listing.title, listing.price, listing.address, listing.bedrooms)
# Check for new listings (alerting use case)
for new_listing in client.listings.list_new():
print(new_listing.id, new_listing.title, new_listing.price, new_listing.size)
Returns the most recent residential rental property listings from xe.gr in Greece. Each listing includes price, location, size, bedrooms, bathrooms, images, construction year, and posting date. Results are ordered by recency. No input parameters required — always returns the current batch of recent listings (typically 20-50 items).
No input parameters required.
{
"type": "object",
"fields": {
"count": "integer - total number of listings returned",
"source": "string - data source identifier",
"listings": "array of Listing objects with property details"
},
"sample": {
"data": {
"count": 24,
"source": "xe.gr recent listings",
"listings": [
{
"id": "c1d0b6c5-7346-4c77-b046-3894009422cd",
"url": "https://www.xe.gr/property/d/enoikiaseis-katoikion/c1d0b6c5-7346-4c77-b046-3894009422cd/patra-280-30",
"size": "30 τ.μ.",
"price": "280 €",
"title": "Διαμέρισμα 30 τ.μ.",
"is_new": false,
"levels": [
"1ος"
],
"www_id": "20260610062534629",
"address": "Πάτρα",
"geo_lat": 38.2369168,
"geo_lng": 21.7326105,
"bedrooms": "1",
"bathrooms": "1",
"image_url": "https://blob.cdn.xe.gr/live/2025/09/27/e2f867cf-6ccc-4fda-b997-0af3c25adf44/e2f867cf-6ccc-4fda-b997-0af3c25adf44-source.jpg?width=640&height=480&format=jpg",
"item_type": "re_residence",
"date_posted": "πριν από 2 λεπτά",
"internal_id": "20260610062534629",
"price_value": "280",
"company_title": "Tzeli Real Estate",
"image_gallery": [
"https://blob.cdn.xe.gr/live/2025/09/27/e2f867cf-6ccc-4fda-b997-0af3c25adf44/e2f867cf-6ccc-4fda-b997-0af3c25adf44-source.jpg?width=640&height=480&format=jpg"
],
"is_commercial": true,
"price_per_sqm": "9 €/τ.μ.",
"transaction_type": "LET.NORMAL",
"unique_group_url": null,
"construction_year": "2007",
"title_abbreviation": "Διαμέρισμα 30 τ.μ."
}
]
},
"status": "success"
}
}About the xe API
What the API Returns
get_recent_rentals returns a full snapshot of current residential rental listings on xe.gr. Each listing object includes a unique id, human-readable title, price, address, geo coordinates (latitude/longitude), bedrooms, bathrooms, size (square meters), an array of images, and a url linking to the original listing. The response also carries a top-level count indicating how many listings were returned and a source identifier.
New Listing Detection
get_new_listings_alert is designed for alerting pipelines. On the first call within a session, all current listings are considered new. On subsequent calls within the same session, only listings that have appeared since the previous call are returned in new_listings. The count field tells you how many new entries were detected. This makes it practical to poll the endpoint on a schedule and trigger notifications only when genuinely new properties are posted.
Coverage and Scope
Both endpoints cover residential rentals listed on xe.gr, which is one of the primary property portals in Greece. Listing data reflects what is publicly visible on the platform, including city and neighborhood-level address strings alongside coordinate data. No filtering parameters are currently exposed — both endpoints return the full available dataset on each call.
The xe API is a managed, monitored endpoint for xe.gr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when xe.gr 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 xe.gr 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?+
- Send push notifications when new rental listings appear in a target area using
get_new_listings_alert - Build a property price tracker that logs xe.gr rental prices over time from
get_recent_rentals - Plot rental listings on a map using the geo coordinates returned per listing
- Compare bedroom and size data across listings to calculate price-per-square-meter benchmarks
- Feed listing images and titles into a property aggregator covering the Greek rental market
- Monitor listing volume trends by tracking the
countfield from repeatedget_recent_rentalscalls - Aggregate xe.gr rental data alongside other sources to analyze regional rental demand in Greece
| 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 | 100 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 xe.gr offer an official developer API?+
What does `get_new_listings_alert` return on the first call?+
new_listings. From the second call onward, only listings that did not appear in the previous response are included. The count field reflects how many new entries were detected in each call.Can I filter listings by city, neighborhood, price range, or number of bedrooms?+
address, price, bedrooms, and geo coordinates, so filtering can be applied client-side after retrieval. You can fork this API on Parse and revise it to add server-side filtering endpoints.