Metadata-Version: 2.4
Name: spitogatos-gr-real-estate-scraper-greece-properties-data
Version: 1.0.0
Summary: Spitogatos.gr Real Estate Scraper — free API client for the Apify platform. No API key setup, thousands of structured results, export to JSON, CSV or Excel.
Author: logiover
License: MIT
Project-URL: Homepage, https://apify.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data
Project-URL: Repository, https://github.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data
Project-URL: Bug Tracker, https://github.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data/issues
Keywords: spitogatos,gr,real,estate,scraper,greece,properties,data,spitogatos.gr,apify,web scraping,data export,crawler,json,csv,no api key,unofficial api,dataset,data extraction
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: apify-client>=1.6
Dynamic: license-file

# Spitogatos.gr Real Estate Scraper

[![Run on Apify](https://img.shields.io/badge/Apify-Run%20Actor-97D700?logo=apify)](https://apify.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data) [![Python client](https://img.shields.io/badge/client-py-blue)](https://github.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data)

**Spitogatos.gr Real Estate Scraper** — a Python client for the [Apify Actor](https://apify.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data). Pull **Spitogatos.gr Real Estate** data at scale with no API-key hassle: thousands of clean, structured results you can export to JSON, CSV or Excel.

▶️ **Run it on Apify:** https://apify.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data

## Install
```bash
pip install spitogatos-gr-real-estate-scraper-greece-properties-data
```

## Usage
```python
from spitogatos_gr_real_estate_scraper_greece_properties_data import scrape

items = scrape({}, token="YOUR_APIFY_TOKEN")
print(len(items), "results")
print(items[0])
```

Get your free Apify token at <https://console.apify.com/account/integrations>.

## Input
| Field | Type | Description |
|---|---|---|
| `region` | string | Area |
| `listingType` | string | Listing Type |
| `category` | string | Category |
| `areaIDs` | array | Area IDs (advanced — multi-area) |
| `priceFrom` | integer | Min Price (EUR) |
| `priceTo` | integer | Max Price (EUR) |
| `sqmFrom` | integer | Min Surface (m²) |
| `sqmTo` | integer | Max Surface (m²) |
| `bedroomsFrom` | integer | Min Bedrooms |
| `bedroomsTo` | integer | Max Bedrooms |
| `sortBy` | string | Sort By |
| `sortOrder` | string | Sort Order |
| `language` | string | Language |
| `maxListings` | integer | Max Listings |
| `maxOffsetPerTask` | integer | Max Offset per Task |

*All fields optional — run with empty input `{}` for a broad default result set.*

## Output
Each result item includes fields such as: `adId`, `category`, `listingType`, `price`, `currency`, `sqMeters`, `pricePerSqm`, `rooms`, `bathrooms`, `floorNumber`, `geography`, `agencyName`, `modified`, `imageCount`, `detailUrl`, `title`, `priceText`, `priceReduced`, `pricePreReduction`, `priceChangePercentage`.

## Why use this
- ⚡ Thousands of results per run, auto-paginated
- 🔑 No Spitogatos.gr Real Estate login or reverse-engineering — just call the Actor
- 📦 Export to JSON, CSV, Excel, JSONL, XML
- ☁️ Runs on Apify cloud — schedule it, add webhooks, wire into Make / Zapier / n8n

## FAQ
### Do I need an API key?
Only a free Apify token (grab one at https://console.apify.com/account/integrations). No Spitogatos.gr Real Estate login and no scraping setup on your side.

### How many results can I get?
Thousands per run. Raise the limit in the input to pull more — the Actor paginates for you.

### What export formats are supported?
Results are plain JSON in code; from the Apify dataset you can export CSV, Excel, JSON, JSONL or XML.

### Is this an official Spitogatos.gr Real Estate API?
No. It is an unofficial Spitogatos.gr Real Estate data client on the Apify platform — a maintained alternative when there is no official or affordable API.

## Links
- ▶️ Run the Actor: https://apify.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data
- 📚 Docs & examples: https://github.com/logiover/spitogatos-gr-real-estate-scraper-greece-properties-data
- 🧰 More scrapers by logiover: https://apify.com/logiover

---
MIT © 2026 logiover · Client library for the hosted Apify Actor. Not affiliated with Spitogatos.gr Real Estate.
