{
  "openapi": "3.0.1",
  "info": {
    "title": "MyHome.ie Scraper",
    "description": "Scrape MyHome.ie - Ireland's leading property portal. Search residential properties for sale and rent across all 26 counties with filters for county, mode, property type, price range, and bedrooms. Returns address, price, size, energy rating, coordinates, agent, and property URL.",
    "version": "1.0",
    "x-build-id": "jonwREdWvMWi20mkp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~myhome-ie-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-myhome-ie-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/crawlerbros~myhome-ie-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-myhome-ie-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/crawlerbros~myhome-ie-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-myhome-ie-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",
        "required": [
          "mode",
          "area"
        ],
        "properties": {
          "mode": {
            "title": "Search mode",
            "enum": [
              "buy",
              "rent"
            ],
            "type": "string",
            "description": "Whether to search for properties for sale or rent.",
            "default": "buy"
          },
          "area": {
            "title": "County",
            "enum": [
              "Dublin",
              "Cork",
              "Galway",
              "Limerick",
              "Waterford",
              "Wicklow",
              "Kildare",
              "Meath",
              "Louth",
              "Tipperary",
              "Kerry",
              "Clare",
              "Wexford",
              "Kilkenny",
              "Mayo",
              "Roscommon",
              "Sligo",
              "Donegal",
              "Cavan",
              "Monaghan",
              "Laois",
              "Offaly",
              "Westmeath",
              "Longford",
              "Leitrim",
              "Carlow"
            ],
            "type": "string",
            "description": "Irish county to search in. MyHome.ie covers the Republic of Ireland's 26 counties.",
            "default": "Dublin"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "",
              "Apartment",
              "Terraced House",
              "Semi-Detached House",
              "Detached House",
              "Bungalow",
              "Country House",
              "Farm",
              "Site",
              "End of Terrace House",
              "Cottage",
              "Duplex",
              "Townhouse",
              "Penthouse",
              "Studio",
              "Dormer",
              "Period House",
              "Mews"
            ],
            "type": "string",
            "description": "Filter by property type. Leave as \"Any\" to include all types. Note: for rent mode only Apartment, Terraced House, Semi-Detached House, Detached House, Bungalow, Studio, and Penthouse are supported — other types are ignored when mode=rent.",
            "default": ""
          },
          "minPrice": {
            "title": "Minimum price (EUR)",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Minimum price in euros. For rent mode this is the minimum monthly rent. Leave unset for no minimum."
          },
          "maxPrice": {
            "title": "Maximum price (EUR)",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Maximum price in euros. For rent mode this is the maximum monthly rent. Leave unset for no maximum."
          },
          "minBeds": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Minimum number of bedrooms. Leave unset for no minimum."
          },
          "maxBeds": {
            "title": "Maximum bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of bedrooms. Leave unset for no maximum."
          },
          "minBathrooms": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Minimum number of bathrooms. Leave unset for no minimum."
          },
          "maxBathrooms": {
            "title": "Maximum bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of bathrooms. Leave unset for no maximum."
          },
          "minSizeSqM": {
            "title": "Minimum size (sqm)",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Minimum property floor area in square metres. Leave unset for no minimum."
          },
          "maxSizeSqM": {
            "title": "Maximum size (sqm)",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum property floor area in square metres. Leave unset for no maximum."
          },
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "Optional free-text search across listing descriptions (e.g. \"garden\", \"sea view\", \"renovated\"). Leave blank to skip."
          },
          "locality": {
            "title": "Locality / area (optional)",
            "type": "string",
            "description": "Optional: narrow the search to a specific town, suburb, or area within the selected county (e.g. \"Balbriggan\", \"Rathmines\", \"Dun Laoghaire\", \"Salthill\"). Matched against MyHome.ie's own locality list for that county (case- and accent-insensitive). If no confident match is found, this filter is ignored and results cover the whole county instead. Leave blank to search the entire county."
          },
          "saleStatus": {
            "title": "Sale status",
            "enum": [
              "forSale",
              "saleAgreed",
              "sold"
            ],
            "type": "string",
            "description": "Only applies when mode=\"buy\". Filter sale listings by status. Rent listings are always shown as available to let (no equivalent filter exists for rent on MyHome.ie).",
            "default": "forSale"
          },
          "sortOrder": {
            "title": "Sort order",
            "enum": [
              "mostRecent",
              "priceLowToHigh",
              "priceHighToLow"
            ],
            "type": "string",
            "description": "Order in which listings are returned.",
            "default": "mostRecent"
          },
          "auctionOnly": {
            "title": "Auction listings only",
            "type": "boolean",
            "description": "Only applies when mode=\"buy\". When enabled, returns only properties listed for public auction (advised minimum value / \"AMV\" pricing) instead of all sale listings. Ignored for mode=\"rent\" (MyHome.ie has no rental auctions).",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of listings to return (1–500).",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}