{
  "openapi": "3.0.1",
  "info": {
    "title": "Inmuebles24 scraper - Mexico Real Estate listings",
    "description": "Extract Mexico real-estate listings from inmuebles24.com in JSON, CSV, or Excel-ready datasets. Filter homes, apartments, land, rentals, sales, prices, rooms, areas, locations, media, publication dates, and advertisers for market research, lead generation, and investment analysis.",
    "version": "0.0",
    "x-build-id": "s2hAB2MTxnx4Mbbom"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/igolaizola~inmuebles24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-igolaizola-inmuebles24-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/igolaizola~inmuebles24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-igolaizola-inmuebles24-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/igolaizola~inmuebles24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-igolaizola-inmuebles24-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": [
          "maxItems"
        ],
        "properties": {
          "maxItems": {
            "title": "Maximum listings",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings to save. Set to 0 to continue until no more results remain.",
            "default": 50
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, neighborhood, municipality, or state to search. Example: Ciudad de México. Leave empty when using coordinates."
          },
          "latitude": {
            "title": "Latitude",
            "minimum": -90,
            "maximum": 90,
            "type": "number",
            "description": "Latitude in decimal degrees for a point search. Use together with longitude; coordinates take precedence over location text. Example: 19.4326."
          },
          "longitude": {
            "title": "Longitude",
            "minimum": -180,
            "maximum": 180,
            "type": "number",
            "description": "Longitude in decimal degrees for a point search. Use together with latitude; coordinates take precedence over location text. Example: -99.1332."
          },
          "operation": {
            "title": "Listing type",
            "enum": [
              "buy",
              "rent",
              "temporary-rental",
              "transfer",
              "development",
              "auction",
              "foreclosure"
            ],
            "type": "string",
            "description": "Type of property listing to find.",
            "default": "buy"
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Limit results to one or more property types.",
            "items": {
              "type": "string",
              "enum": [
                "house",
                "apartment",
                "commercial-warehouse",
                "condominium-house",
                "mixed-use-house",
                "shared-apartment",
                "development",
                "horizontal-development",
                "vertical-development",
                "duplex",
                "building",
                "orchard",
                "urban-productive-property",
                "commercial-premises",
                "shopping-centre-premises",
                "industrial-warehouse",
                "office",
                "vacation-home",
                "ranch",
                "land",
                "commercial-land",
                "industrial-land",
                "villa"
              ],
              "enumTitles": [
                "House",
                "Apartment",
                "Commercial warehouse",
                "Condominium house",
                "Mixed-use house",
                "Shared apartment",
                "Development",
                "Horizontal development",
                "Vertical development",
                "Duplex",
                "Building",
                "Orchard",
                "Urban productive property",
                "Commercial premises",
                "Shopping center premises",
                "Industrial warehouse",
                "Office",
                "Vacation home",
                "Ranch",
                "Land or lot",
                "Commercial land",
                "Industrial land",
                "Villa"
              ]
            }
          },
          "keyword": {
            "title": "Keywords",
            "type": "string",
            "description": "Optional words that should appear in the listing, such as furnished or garden.",
            "default": ""
          },
          "currency": {
            "title": "Price currency",
            "enum": [
              "MXN",
              "USD"
            ],
            "type": "string",
            "description": "Currency used for the price filters.",
            "default": "MXN"
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest listing price. Leave at 0 for no minimum.",
            "default": 0
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest listing price. Leave at 0 for no maximum.",
            "default": 0
          },
          "minExpenses": {
            "title": "Minimum maintenance fees",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest condominium or maintenance fee. Leave at 0 for no minimum.",
            "default": 0
          },
          "maxExpenses": {
            "title": "Maximum maintenance fees",
            "minimum": 0,
            "type": "integer",
            "description": "Highest condominium or maintenance fee. Leave at 0 for no maximum.",
            "default": 0
          },
          "areaUnit": {
            "title": "Area unit",
            "enum": [
              "square-metres",
              "hectares",
              "celemines"
            ],
            "type": "string",
            "description": "Unit used for total-area or covered-area filters.",
            "default": "square-metres"
          },
          "minArea": {
            "title": "Minimum total area",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum complete property area. Do not combine with covered-area filters.",
            "default": 0
          },
          "maxArea": {
            "title": "Maximum total area",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum complete property area. Do not combine with covered-area filters.",
            "default": 0
          },
          "minCoveredArea": {
            "title": "Minimum covered area",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum indoor or built area. Do not combine with total-area filters.",
            "default": 0
          },
          "maxCoveredArea": {
            "title": "Maximum covered area",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum indoor or built area. Do not combine with total-area filters.",
            "default": 0
          },
          "minRooms": {
            "title": "Minimum rooms",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Minimum number of rooms.",
            "default": 0
          },
          "maxRooms": {
            "title": "Maximum rooms",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Maximum number of rooms. Select 5 for five or more.",
            "default": 0
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Minimum number of bedrooms.",
            "default": 0
          },
          "maxBedrooms": {
            "title": "Maximum bedrooms",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Maximum number of bedrooms. Select 5 for five or more.",
            "default": 0
          },
          "minBathrooms": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Minimum number of bathrooms.",
            "default": 0
          },
          "maxBathrooms": {
            "title": "Maximum bathrooms",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Maximum number of bathrooms. Select 5 for five or more.",
            "default": 0
          },
          "minGarages": {
            "title": "Minimum parking spaces",
            "minimum": 0,
            "maximum": 4,
            "type": "integer",
            "description": "Minimum number of parking spaces.",
            "default": 0
          },
          "maxGarages": {
            "title": "Maximum parking spaces",
            "minimum": 0,
            "maximum": 4,
            "type": "integer",
            "description": "Maximum number of parking spaces. Select 4 for four or more.",
            "default": 0
          },
          "noGarages": {
            "title": "Only properties without parking",
            "type": "boolean",
            "description": "Return only listings with no parking spaces. Do not combine with parking-space ranges.",
            "default": false
          },
          "ageRanges": {
            "title": "Property age",
            "type": "array",
            "description": "Select one or more construction-age ranges.",
            "items": {
              "type": "string",
              "enum": [
                "under-construction",
                "brand-new",
                "up-to-5-years",
                "5-to-10-years",
                "10-to-20-years",
                "20-to-50-years",
                "over-50-years"
              ],
              "enumTitles": [
                "Under construction",
                "Brand new",
                "Up to 5 years",
                "5–10 years",
                "10–20 years",
                "20–50 years",
                "More than 50 years"
              ]
            }
          },
          "publicationDate": {
            "title": "Published",
            "enum": [
              "",
              "today",
              "since-yesterday",
              "last-week",
              "last-15-days",
              "last-30-days",
              "last-45-days"
            ],
            "type": "string",
            "description": "How recently the listing was published.",
            "default": ""
          },
          "multimedia": {
            "title": "Media available",
            "enum": [
              "",
              "video",
              "photos",
              "virtual-tour",
              "floor-plan"
            ],
            "type": "string",
            "description": "Require a particular type of listing media.",
            "default": ""
          },
          "publisherType": {
            "title": "Advertiser",
            "enum": [
              "",
              "company",
              "private-owner"
            ],
            "type": "string",
            "description": "Limit results by advertiser type.",
            "default": ""
          },
          "projectStage": {
            "title": "Development stage",
            "enum": [
              "",
              "all-stages",
              "pre-sale",
              "for-sale"
            ],
            "type": "string",
            "description": "Stage of a new development. Relevant when searching developments.",
            "default": ""
          },
          "sort": {
            "title": "Sort results",
            "enum": [
              "relevance",
              "most-recent",
              "lowest-price",
              "highest-price",
              "lowest-price-per-area",
              "highest-price-per-area",
              "lowest-total-monthly-cost",
              "largest-price-reduction",
              "most-viewed"
            ],
            "type": "string",
            "description": "Order in which listings are returned.",
            "default": "relevance"
          },
          "fetchDetails": {
            "title": "Include full listing details",
            "type": "boolean",
            "description": "Collect additional information for every listing. This takes longer and may increase usage.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}