{
  "openapi": "3.0.1",
  "info": {
    "title": "Spiti24.gr Scraper: Greek Property Listings with Agent Phones",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "mkzLegX3ldjzybJQV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fayoussef~spiti24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fayoussef-spiti24-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/fayoussef~spiti24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fayoussef-spiti24-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/fayoussef~spiti24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fayoussef-spiti24-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "start_urls": {
            "title": "Start URLs / Σύνδεσμοι εκκίνησης",
            "type": "array",
            "description": "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. Αν δοθούν, τα φίλτρα παρακάτω αγνοούνται.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "language": {
            "title": "Output language / Γλώσσα αποτελεσμάτων",
            "enum": [
              "el",
              "en"
            ],
            "type": "string",
            "description": "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. / Γλώσσα τίτλων, ετικετών, περιοχών, χαρακτηριστικών και περιγραφής. Η διεύθυνση εμφανίζεται μόνο στις ελληνικές σελίδες.",
            "default": "el"
          },
          "offer_type": {
            "title": "For sale or rent / Πώληση ή ενοικίαση",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Which listings to search. Used when no Start URL is given.",
            "default": "sale"
          },
          "categories": {
            "title": "Categories / Κατηγορίες",
            "type": "array",
            "description": "Which kinds of property to search. Leave empty for residential. Property types below add their own category. / Αφήστε κενό για κατοικίες.",
            "items": {
              "type": "string",
              "enum": [
                "residential",
                "commercial",
                "land",
                "other"
              ],
              "enumTitles": [
                "Residential / Κατοικία",
                "Commercial / Επαγγελματική στέγη",
                "Land / Γη",
                "Other / Λοιπά ακίνητα"
              ]
            }
          },
          "property_types": {
            "title": "Property types / Τύποι ακινήτων",
            "type": "array",
            "description": "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. / Αφήστε κενό για όλους τους τύπους.",
            "items": {
              "type": "string",
              "enum": [
                "apartment",
                "studio",
                "maisonette",
                "detached",
                "villa",
                "loft",
                "bungalow",
                "building",
                "apartment complex",
                "farm",
                "houseboat",
                "other residential",
                "office",
                "store",
                "warehouse",
                "industrial space",
                "craft space",
                "hotel",
                "business building",
                "hall",
                "showroom",
                "other commercial",
                "plot",
                "parcel",
                "island",
                "other land",
                "parking spot",
                "business",
                "prefabricated",
                "detachable",
                "air",
                "other"
              ],
              "enumTitles": [
                "Apartment / Διαμέρισμα",
                "Studio / Studio / Γκαρσονιέρα",
                "Maisonette / Μεζονέτα",
                "Detached / Μονοκατοικία",
                "Villa / Βίλα",
                "Loft / Loft",
                "Bungalow / Bungalow",
                "Building / Κτίριο",
                "Apartment Complex / Συγκρότημα διαμερισμάτων",
                "Farm / Φάρμα / Ράντσο",
                "Houseboat / Πλωτό σπίτι",
                "Other Residential / Λοιπά κατοικίας",
                "Office / Γραφείο",
                "Store / Κατάστημα",
                "Warehouse / Αποθήκη",
                "Industrial Space / Βιομηχανικός χώρος",
                "Craft Space / Βιοτεχνικός χώρος",
                "Hotel / Ξενοδοχείο",
                "Business Building / Κτίριο επαγγελματικών χώρων",
                "Hall / Αίθουσα",
                "Showroom / Εκθεσιακός χώρος",
                "Other Commercial / Λοιπά επαγγελματικά",
                "Plot / Οικόπεδο",
                "Parcel / Αγροτεμάχιο",
                "Island / Νησί",
                "Other Land / Λοιπά γης",
                "Parking Spot / Πάρκινγκ",
                "Business / Επιχείρηση",
                "Prefabricated / Προκατασκευασμένο",
                "Detachable / Λυόμενο",
                "Air / Αέρας",
                "Other / Λοιπά ακίνητα"
              ]
            }
          },
          "locations": {
            "title": "Locations / Περιοχές",
            "type": "array",
            "description": "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. / Περιοχές, μία ανά γραμμή, στα ελληνικά ή αγγλικά.",
            "items": {
              "type": "string"
            }
          },
          "price_min": {
            "title": "Min price (EUR) / Ελάχιστη τιμή (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price. For rentals this is the monthly rent."
          },
          "price_max": {
            "title": "Max price (EUR) / Μέγιστη τιμή (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price. For rentals this is the monthly rent."
          },
          "area_min": {
            "title": "Min area (sqm) / Ελάχιστο εμβαδόν (τ.μ.)",
            "minimum": 0,
            "type": "integer",
            "description": "Smallest size in square meters."
          },
          "area_max": {
            "title": "Max area (sqm) / Μέγιστο εμβαδόν (τ.μ.)",
            "minimum": 0,
            "type": "integer",
            "description": "Largest size in square meters."
          },
          "rooms_min": {
            "title": "Min rooms / Ελάχιστα δωμάτια",
            "minimum": 0,
            "type": "integer",
            "description": "At least this many rooms."
          },
          "rooms_max": {
            "title": "Max rooms / Μέγιστα δωμάτια",
            "minimum": 0,
            "type": "integer",
            "description": "At most this many rooms."
          },
          "year_min": {
            "title": "Built in or after / Έτος κατασκευής από",
            "minimum": 0,
            "type": "integer",
            "description": "Earliest construction year."
          },
          "year_max": {
            "title": "Built in or before / Έτος κατασκευής έως",
            "minimum": 0,
            "type": "integer",
            "description": "Latest construction year."
          },
          "listed_within": {
            "title": "Listed within / Καταχωρήθηκε εντός",
            "enum": [
              "any",
              "1d",
              "3d",
              "7d",
              "30d",
              "90d",
              "180d",
              "365d"
            ],
            "type": "string",
            "description": "Only listings first published in this period.",
            "default": "any"
          },
          "updated_within": {
            "title": "Updated within / Ενημερώθηκε εντός",
            "enum": [
              "any",
              "1d",
              "3d",
              "7d",
              "30d",
              "90d",
              "180d",
              "365d"
            ],
            "type": "string",
            "description": "Only listings last changed in this period.",
            "default": "any"
          },
          "private_only": {
            "title": "Private owners only / Μόνο ιδιώτες",
            "type": "boolean",
            "description": "Only listings from private owners, no agencies.",
            "default": false
          },
          "new_development": {
            "title": "New developments only / Μόνο νεόδμητα",
            "type": "boolean",
            "description": "Only new-build listings.",
            "default": false
          },
          "price_reduced": {
            "title": "Price reduced only / Μόνο μειωμένες τιμές",
            "type": "boolean",
            "description": "Only listings whose price was lowered.",
            "default": false
          },
          "with_photo_only": {
            "title": "With photo only / Μόνο με φωτογραφία",
            "type": "boolean",
            "description": "Skip listings that have no photo.",
            "default": false
          },
          "features": {
            "title": "Must have / Να διαθέτει",
            "type": "array",
            "description": "Only listings with all of these features ticked on spiti24.gr. / Μόνο αγγελίες με όλα τα επιλεγμένα χαρακτηριστικά.",
            "items": {
              "type": "string",
              "enum": [
                "elevator",
                "storage",
                "balcony",
                "corner",
                "furnished",
                "solarHeater",
                "view",
                "garage",
                "airConditioning",
                "garden",
                "secureDoor",
                "swimmingPool",
                "fireplace",
                "alarm",
                "facade",
                "loadingDock",
                "withinCityPlan",
                "residentialArea",
                "studentHome"
              ],
              "enumTitles": [
                "Elevator / Ασανσέρ",
                "Storage / Αποθήκη",
                "Balcony / Βεράντα",
                "Corner / Γωνιακό",
                "Furnished / Επιπλωμένο",
                "Solar water heater / Ηλιακός",
                "View / Θέα",
                "Garage / Γκαράζ",
                "Air conditioning / Κλιματισμός",
                "Garden / Κήπος",
                "Security door / Πόρτα ασφαλείας",
                "Swimming pool / Πισίνα",
                "Fireplace / Τζάκι",
                "Alarm / Συναγερμός",
                "Street frontage / Προσόψεως",
                "Loading dock / Εξέδρα φόρτωσης",
                "Within city plan / Εντός σχεδίου",
                "Residential zone / Οικιστική ζώνη",
                "Student home / Φοιτητικό"
              ]
            }
          },
          "sort_by": {
            "title": "Sort by / Ταξινόμηση",
            "enum": [
              "relevance",
              "latest_change",
              "price_low",
              "price_high",
              "price_sqm_low",
              "price_sqm_high",
              "size_small",
              "size_large"
            ],
            "type": "string",
            "description": "Order of the results.",
            "default": "latest_change"
          },
          "max_items": {
            "title": "Max listings / Μέγιστες αγγελίες",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many listings. Leave empty for no limit. Free-plan runs are capped at 25."
          },
          "include_details": {
            "title": "Add description, all photos and agent contacts / Πλήρη στοιχεία, φωτογραφίες και επαφές",
            "type": "boolean",
            "description": "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.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}