# Spiti24.gr Scraper: Greek Property Listings with Agent Phones (`fayoussef/spiti24-scraper`) Actor

Scrape spiti24.gr property listings in Greece: apartments, houses, land and commercial, for sale or rent. Prices, size, rooms, energy class, amenities, coordinates, all photos and the agency with phone numbers. Filter by area, price, size and more.

- **URL**: https://apify.com/fayoussef/spiti24-scraper.md
- **Developed by:** [Youssef Farhan](https://apify.com/fayoussef) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Spiti24.gr Scraper: Greek Property Listings with Agent Phones

[English](#english) | [Ελληνικά](#ελληνικά)

### English

Scrape property listings from [spiti24.gr](https://www.spiti24.gr), a major Greek real estate portal: apartments, maisonettes, houses, villas, land, offices and shops, for sale or rent. Get prices, sizes, GPS coordinates, every photo and the agency's phone numbers in clean JSON, CSV or Excel. No API key and no login needed.

#### What you get per listing

- **Price**: amount, price per sqm, negotiable flag, monthly period for rentals
- **Property**: type, category, area in sqm, bedrooms, bathrooms, kitchens, living rooms, WC, floor and floors in the building, year built and renovated, energy class and consumption range, heating, zone, parking, condition, use
- **Land and commercial**: buildable area, within city plan, building and coverage coefficients
- **Location**: address, area and the full area path, latitude and longitude with their precision
- **Text and features**: the full description, every amenity present (elevator, view, pool and more), and values such as distance to the sea, monthly fees, orientation, floors and glazing
- **The whole detail table**: every row the site shows, under its own label, in `details`
- **Media**: all photos at full size and the video link
- **Agency**: name, id and page, logo, address, contact person, website, short profile
- **Phones**: every phone number shown on the listing page, including the contact person's number
- **Listing**: listing id, property code, the agent's own code, published and last updated dates

#### How to use

1. Paste a spiti24.gr search URL or listing URLs in **Start URLs**, or use the filters: sale or rent, categories, property types, locations, price, size, rooms, year built, how recently listed or updated, private owners, new developments, price reductions, required features and sort order.
2. Pick the **output language**, English or Greek.
3. Set **Max listings** and run. Results appear in the **Overview** and **Agent contacts** views.

Locations accept English or Greek names (Glyfada, Γλυφάδα, Kolonaki, Χαλκιδική) or a spiti24.gr area id. The run log names the area each name matched. At least one location is needed, as on the site itself. A name that is not recognised is skipped with an error.

#### Languages

- **Input**: the form labels, location names and filters work in English and Greek.
- **Output**: field names are always English. With the English setting, titles, the labels in `details`, area names, amenities and the description come from spiti24.gr's own English pages, so you get the agent's English description when there is one. With the Greek setting they come back in Greek. The street address is only shown on the Greek pages, so it is left out in English. The English setting needs the detail option on, otherwise the short card title stays Greek.

#### Free and paid

Free plan runs return the first 25 listings of the first search. Paid plans have no cap. See the [Apify plan](https://apify.com/pricing?fpr=youssef) options. The current rate is shown on this Actor's Store page.

#### Good to know

- The site masks phone numbers inside the agent's description text. The numbers on the page itself are collected in `phones`.
- Switch off **Add description, all photos and agent contacts** for a much faster run with price, size, rooms, area and one photo.
- Photo links open in any browser, with no login.
- The same property can appear on several portals, so match on the property code if you combine sources.

Bug reports go to the Issues tab. Need a custom version or another site? [Contact me through my Apify profile](https://apify.com/fayoussef)

### Ελληνικά

Εξαγωγή αγγελιών ακινήτων από το [spiti24.gr](https://www.spiti24.gr), μία από τις μεγάλες ελληνικές πύλες ακινήτων: διαμερίσματα, μεζονέτες, μονοκατοικίες, βίλες, γη, γραφεία και καταστήματα, προς πώληση ή ενοικίαση. Παίρνετε τιμές, εμβαδά, συντεταγμένες GPS, όλες τις φωτογραφίες και τα τηλέφωνα του γραφείου σε JSON, CSV ή Excel. Χωρίς API key και χωρίς σύνδεση.

#### Τι παίρνετε για κάθε αγγελία

- **Τιμή**: ποσό, τιμή ανά τ.μ., ένδειξη «διαπραγματεύσιμη», μηνιαία περίοδος για ενοικιάσεις
- **Ακίνητο**: τύπος, κατηγορία, εμβαδόν, υπνοδωμάτια, μπάνια, κουζίνες, καθιστικά, WC, όροφος και όροφοι κτιρίου, έτος κατασκευής και ανακαίνισης, ενεργειακή κλάση και εύρος κατανάλωσης, θέρμανση, ζώνη, πάρκινγκ, κατάσταση, χρήση
- **Γη και επαγγελματικά**: οικοδομήσιμο εμβαδόν, εντός σχεδίου πόλεως, συντελεστές δόμησης και κάλυψης
- **Τοποθεσία**: διεύθυνση, περιοχή και πλήρης διαδρομή περιοχής, γεωγραφικό πλάτος και μήκος με την ακρίβειά τους
- **Κείμενο και χαρακτηριστικά**: πλήρης περιγραφή, όλα τα διαθέσιμα χαρακτηριστικά (ασανσέρ, θέα, πισίνα και άλλα) και τιμές όπως απόσταση από τη θάλασσα, κοινόχρηστα, προσανατολισμός, κουφώματα
- **Ολόκληρος ο πίνακας λεπτομερειών**: κάθε γραμμή που εμφανίζει το site, με τη δική της ετικέτα, στο `details`
- **Πολυμέσα**: όλες οι φωτογραφίες σε πλήρες μέγεθος και ο σύνδεσμος βίντεο
- **Γραφείο**: όνομα, κωδικός και σελίδα, λογότυπο, διεύθυνση, υπεύθυνος επικοινωνίας, ιστοσελίδα, σύντομο προφίλ
- **Τηλέφωνα**: όλα τα τηλέφωνα που εμφανίζονται στη σελίδα της αγγελίας, και του υπευθύνου επικοινωνίας
- **Αγγελία**: κωδικός αγγελίας, κωδικός ακινήτου, ο δικός κωδικός του μεσίτη, ημερομηνίες καταχώρισης και τελευταίας ενημέρωσης

#### Πώς το χρησιμοποιείτε

1. Επικολλήστε έναν σύνδεσμο αναζήτησης ή συνδέσμους αγγελιών του spiti24.gr στα **Start URLs**, ή χρησιμοποιήστε τα φίλτρα: πώληση ή ενοικίαση, κατηγορίες, τύποι ακινήτων, περιοχές, τιμή, εμβαδόν, δωμάτια, έτος κατασκευής, πόσο πρόσφατη ή ενημερωμένη είναι η αγγελία, ιδιώτες, νεόδμητα, μειωμένες τιμές, απαραίτητα χαρακτηριστικά και ταξινόμηση.
2. Διαλέξτε τη **γλώσσα αποτελεσμάτων**, αγγλικά ή ελληνικά.
3. Ορίστε **Max listings** και εκτελέστε. Τα αποτελέσματα εμφανίζονται στις προβολές **Overview** και **Agent contacts**.

Οι περιοχές δέχονται ελληνικά ή αγγλικά ονόματα (Γλυφάδα, Glyfada, Κολωνάκι, Chalkidiki) ή κωδικό περιοχής του spiti24.gr. Το αρχείο καταγραφής της εκτέλεσης δείχνει σε ποια περιοχή αντιστοιχίστηκε κάθε όνομα. Χρειάζεται τουλάχιστον μία περιοχή, όπως και στο ίδιο το site. Άγνωστο όνομα παραλείπεται με σφάλμα.

#### Γλώσσες

- **Είσοδος**: οι ετικέτες της φόρμας, τα ονόματα περιοχών και τα φίλτρα δουλεύουν σε ελληνικά και αγγλικά.
- **Έξοδος**: τα ονόματα των πεδίων είναι πάντα αγγλικά. Με την αγγλική επιλογή, οι τίτλοι, οι ετικέτες στο `details`, τα ονόματα περιοχών, τα χαρακτηριστικά και η περιγραφή προέρχονται από τις αγγλικές σελίδες του spiti24.gr, άρα παίρνετε την αγγλική περιγραφή του μεσίτη όταν υπάρχει. Με την ελληνική επιλογή επιστρέφονται στα ελληνικά. Η διεύθυνση (οδός) εμφανίζεται μόνο στις ελληνικές σελίδες, γι' αυτό παραλείπεται στα αγγλικά. Η αγγλική επιλογή θέλει ενεργή την επιλογή λεπτομερειών, αλλιώς ο σύντομος τίτλος της κάρτας μένει ελληνικός.

#### Δωρεάν και επί πληρωμή

Οι δωρεάν εκτελέσεις δίνουν τις πρώτες 25 αγγελίες της πρώτης αναζήτησης. Τα επί πληρωμή πλάνα δεν έχουν όριο. Δείτε τα [πλάνα Apify](https://apify.com/pricing?fpr=youssef). Η τρέχουσα τιμή εμφανίζεται στη σελίδα του Actor στο Store.

#### Καλό είναι να ξέρετε

- Το site κρύβει τα τηλέφωνα μέσα στο κείμενο της περιγραφής. Τα τηλέφωνα της ίδιας της σελίδας συγκεντρώνονται στο `phones`.
- Απενεργοποιήστε την επιλογή **Add description, all photos and agent contacts** για πολύ πιο γρήγορη εκτέλεση με τιμή, εμβαδόν, δωμάτια, περιοχή και μία φωτογραφία.
- Οι σύνδεσμοι φωτογραφιών ανοίγουν σε κάθε browser, χωρίς σύνδεση.
- Το ίδιο ακίνητο μπορεί να υπάρχει σε περισσότερες πύλες, γι' αυτό αντιστοιχίστε με τον κωδικό ακινήτου αν συνδυάζετε πηγές.

Για σφάλματα χρησιμοποιήστε την καρτέλα Issues. Θέλετε προσαρμοσμένη έκδοση ή άλλο site; [Επικοινωνήστε μέσω του προφίλ μου στο Apify](https://apify.com/fayoussef)

# Actor input Schema

## `start_urls` (type: `array`):

spiti24.gr search result URLs (set your filters on spiti24.gr, then paste the address) or single listing URLs (spiti24.gr/<number>). When given, the filter fields below are ignored. / Σύνδεσμοι αναζήτησης ή αγγελιών του spiti24.gr. Αν δοθούν, τα φίλτρα παρακάτω αγνοούνται.

## `language` (type: `string`):

Language of the listing titles, the labels in the detail table, area names, amenities and the description. English uses spiti24.gr's own English pages, so the agent's English description is returned when there is one. The address is only shown on the Greek pages. Needs 'Add description, all photos and agent contacts' on. / Γλώσσα τίτλων, ετικετών, περιοχών, χαρακτηριστικών και περιγραφής. Η διεύθυνση εμφανίζεται μόνο στις ελληνικές σελίδες.

## `offer_type` (type: `string`):

Which listings to search. Used when no Start URL is given.

## `categories` (type: `array`):

Which kinds of property to search. Leave empty for residential. Property types below add their own category. / Αφήστε κενό για κατοικίες.

## `property_types` (type: `array`):

Narrow to specific types (apartment, villa, office, plot and more). Each type is searched on its own. Leave empty for every type of the chosen categories. / Αφήστε κενό για όλους τους τύπους.

## `locations` (type: `array`):

Areas of Greece, one per line, in English or Greek (Glyfada, Γλυφάδα, Kolonaki, Χαλκιδική) or a spiti24.gr area id. Names are looked up in spiti24.gr's own area search and the best match is used (the run log names it). At least one is needed, as on the site itself. / Περιοχές, μία ανά γραμμή, στα ελληνικά ή αγγλικά.

## `price_min` (type: `integer`):

Lowest price. For rentals this is the monthly rent.

## `price_max` (type: `integer`):

Highest price. For rentals this is the monthly rent.

## `area_min` (type: `integer`):

Smallest size in square meters.

## `area_max` (type: `integer`):

Largest size in square meters.

## `rooms_min` (type: `integer`):

At least this many rooms.

## `rooms_max` (type: `integer`):

At most this many rooms.

## `year_min` (type: `integer`):

Earliest construction year.

## `year_max` (type: `integer`):

Latest construction year.

## `listed_within` (type: `string`):

Only listings first published in this period.

## `updated_within` (type: `string`):

Only listings last changed in this period.

## `private_only` (type: `boolean`):

Only listings from private owners, no agencies.

## `new_development` (type: `boolean`):

Only new-build listings.

## `price_reduced` (type: `boolean`):

Only listings whose price was lowered.

## `with_photo_only` (type: `boolean`):

Skip listings that have no photo.

## `features` (type: `array`):

Only listings with all of these features ticked on spiti24.gr. / Μόνο αγγελίες με όλα τα επιλεγμένα χαρακτηριστικά.

## `sort_by` (type: `string`):

Order of the results.

## `max_items` (type: `integer`):

Stop after this many listings. Leave empty for no limit. Free-plan runs are capped at 25.

## `include_details` (type: `boolean`):

Open every listing's page to add the full description, the whole detail table, amenities, every photo, coordinates, the agency and the phones shown on the page. One extra request per listing. Turn off for a much faster run with price, size, rooms, area and one photo.

## Actor input object example

```json
{
  "start_urls": [
    {
      "url": "https://www.spiti24.gr/pwliseis/katoikies/glyfada"
    }
  ],
  "language": "el",
  "offer_type": "sale",
  "locations": [
    "Glyfada"
  ],
  "listed_within": "any",
  "updated_within": "any",
  "private_only": false,
  "new_development": false,
  "price_reduced": false,
  "with_photo_only": false,
  "sort_by": "latest_change",
  "max_items": 50,
  "include_details": true
}
```

# Actor output Schema

## `listings` (type: `string`):

Every listing found, with price, size, location, photos and the agency's contacts. / Όλες οι αγγελίες με τιμή, εμβαδόν, τοποθεσία, φωτογραφίες και επαφές γραφείου.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "start_urls": [
        {
            "url": "https://www.spiti24.gr/pwliseis/katoikies/glyfada"
        }
    ],
    "locations": [
        "Glyfada"
    ],
    "max_items": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("fayoussef/spiti24-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "start_urls": [{ "url": "https://www.spiti24.gr/pwliseis/katoikies/glyfada" }],
    "locations": ["Glyfada"],
    "max_items": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("fayoussef/spiti24-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "start_urls": [
    {
      "url": "https://www.spiti24.gr/pwliseis/katoikies/glyfada"
    }
  ],
  "locations": [
    "Glyfada"
  ],
  "max_items": 50
}' |
apify call fayoussef/spiti24-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fayoussef/spiti24-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CipJECfuHDoV3uCDz/builds/mkzLegX3ldjzybJQV/openapi.json
