# Plot.gr Scraper: Greek Real Estate Listings with Agent Phones (`fayoussef/plot-gr-scraper`) Actor

Scrape plot.gr property listings in Greece: apartments, houses, land and commercial, for sale or rent. Prices, area, bedrooms, coordinates, photos and the agent's phone, email and website. Filter by area, price and size.

- **URL**: https://apify.com/fayoussef/plot-gr-scraper.md
- **Developed by:** [Youssef Farhan](https://apify.com/fayoussef) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 4 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

## Plot.gr Scraper: Greek Real Estate Listings with Agent Phones

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

### English

Scrape property listings from [plot.gr](https://www.plot.gr), Greece's real estate portal: apartments, maisonettes, houses, villas, land and commercial, for sale or rent. Get prices, sizes, GPS coordinates, photos and the agent's phone, email and website in clean JSON, CSV or Excel.

#### What you get per listing

- **Price**: amount, price per sqm, estimated gross yield, negotiable and price-on-request flags
- **Property**: area, bedrooms, bathrooms, kitchens, floor, year built, energy class, heating, zone
- **Location**: address, area path, latitude and longitude
- **Text and features**: full description, extras such as balcony, view or elevator, every specification
- **Media**: all photos and YouTube video links
- **Agent**: name, type, phones, mobile, email, website, social links, address, number of listings, Google rating
- **Listing**: listed and modified dates, views, promotion

#### How to use

1. Paste a plot.gr search URL or listing URLs in **Start URLs**, or use the filters: offer type, property types, locations, price, area, bedrooms, listing age, seller type 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, Γλυφάδα, Thessaloniki, Χαλκιδική) or a plot.gr location id. A name that is not recognised is skipped instead of searching all of Greece.

plot.gr returns at most 300 pages per search, so very large searches are split by price automatically.

#### Languages

- **Input**: location names, the form labels and the filter values work in English and Greek.
- **Output**: with the English setting, titles, categories, area names, specifications and extras come back in English. With the Greek setting they come back in Greek. The description text is what the agent wrote, mostly Greek, and is marked in `description_language`.

#### 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

- A phone number the agent marked as not public is left out.
- Switch off **Add description, all photos and agent contacts** for a faster run with price, area, address and one photo.
- Photo links open in any browser, with no login.

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

### Ελληνικά

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

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

- **Τιμή**: ποσό, τιμή ανά τ.μ., εκτιμώμενη μικτή απόδοση, ενδείξεις «διαπραγματεύσιμη» και «τιμή κατόπιν συνεννόησης»
- **Ακίνητο**: εμβαδόν, υπνοδωμάτια, μπάνια, κουζίνες, όροφος, έτος κατασκευής, ενεργειακή κλάση, θέρμανση, ζώνη
- **Τοποθεσία**: διεύθυνση, περιοχή, γεωγραφικό πλάτος και μήκος
- **Κείμενο και χαρακτηριστικά**: πλήρης περιγραφή, ιδιαιτερότητες (μπαλκόνι, θέα, ασανσέρ), όλες οι προδιαγραφές
- **Πολυμέσα**: όλες οι φωτογραφίες και σύνδεσμοι βίντεο YouTube
- **Μεσίτης**: όνομα, τύπος, τηλέφωνα, κινητό, email, ιστοσελίδα, social, διεύθυνση, αριθμός αγγελιών, βαθμολογία Google
- **Αγγελία**: ημερομηνίες καταχώρισης και τροποποίησης, προβολές, προώθηση

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

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

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

Το plot.gr δίνει το πολύ 300 σελίδες ανά αναζήτηση, γι' αυτό οι πολύ μεγάλες αναζητήσεις σπάνε αυτόματα ανά εύρος τιμής.

#### Γλώσσες

- **Είσοδος**: τα ονόματα περιοχών, οι ετικέτες της φόρμας και οι τιμές φίλτρων δουλεύουν σε ελληνικά και αγγλικά.
- **Έξοδος**: με την αγγλική επιλογή, οι τίτλοι, οι κατηγορίες, οι περιοχές, οι προδιαγραφές και οι ιδιαιτερότητες επιστρέφονται στα αγγλικά, με την ελληνική στα ελληνικά. Η περιγραφή είναι το κείμενο που έγραψε ο μεσίτης, κυρίως ελληνικό, και η γλώσσα της φαίνεται στο `description_language`.

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

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

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

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

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

# Actor input Schema

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

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

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

Language of titles, categories, area names, specifications and extras. Listing descriptions written by the agent stay in the language they were written in (mostly Greek). / Γλώσσα τίτλων, κατηγοριών, περιοχών και χαρακτηριστικών. Οι περιγραφές των αγγελιών μένουν όπως τις έγραψε ο πωλητής.

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

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

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

Leave empty for every type. / Αφήστε κενό για όλους τους τύπους.

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

Areas of Greece, one per line, in English or Greek (Glyfada, Γλυφάδα, Thessaloniki, Χαλκιδική) or a plot.gr location id. Names are matched against plot.gr's own area list, and an unrecognised name is skipped with an error. Leave empty to search all of Greece. / Περιοχές, μία ανά γραμμή, στα ελληνικά ή αγγλικά. Άγνωστα ονόματα παραλείπονται με σφάλμα.

## `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.

## `bedrooms_min` (type: `integer`):

At least this many bedrooms.

## `bedrooms_max` (type: `integer`):

At most this many bedrooms.

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

Earliest construction year.

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

Only listings created in this period.

## `seller_type` (type: `string`):

Who is selling.

## `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 detail to add the full description, every specification, extras, all photos and the agent's phones, email and website. One extra request per listing. Turn off for a faster run with price, area, address, coordinates and one photo.

## Actor input object example

```json
{
  "start_urls": [
    {
      "url": "https://www.plot.gr/search?category=20077&location=19"
    }
  ],
  "language": "el",
  "offer_type": "sale",
  "locations": [
    "Glyfada"
  ],
  "listed_within": "any",
  "seller_type": "any",
  "sort_by": "latest_change",
  "max_items": 50,
  "include_details": true
}
```

# Actor output Schema

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

Every listing found, with price, area, location, photos and the agent'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.plot.gr/search?category=20077&location=19"
        }
    ],
    "locations": [
        "Glyfada"
    ],
    "max_items": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("fayoussef/plot-gr-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.plot.gr/search?category=20077&location=19" }],
    "locations": ["Glyfada"],
    "max_items": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("fayoussef/plot-gr-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.plot.gr/search?category=20077&location=19"
    }
  ],
  "locations": [
    "Glyfada"
  ],
  "max_items": 50
}' |
apify call fayoussef/plot-gr-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fayoussef/plot-gr-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/6EbPqdrXIBb1N1N5E/builds/Zxs9dcpecT08Use8P/openapi.json
