{
  "openapi": "3.0.1",
  "info": {
    "title": "Inmuebles24 Scraper: Mexico Real Estate API",
    "description": "Inmuebles24 scraper and Mexico real estate API: paste any inmuebles24.com search URL or pick operation, property type and colonia. Get price and currency (MXN/USD), m2, recamaras, bathrooms, address, photos, agency and listing URL.",
    "version": "0.11",
    "x-build-id": "V3u7AoGaaKgW7p3Og"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/barefoot_grade~inmuebles24-mx-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-barefoot_grade-inmuebles24-mx-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/barefoot_grade~inmuebles24-mx-scraper/runs": {
      "post": {
        "operationId": "runs-sync-barefoot_grade-inmuebles24-mx-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/barefoot_grade~inmuebles24-mx-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-barefoot_grade-inmuebles24-mx-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": {
          "portal": {
            "title": "Portal (fixed for this record)",
            "enum": [
              "inmuebles24"
            ],
            "type": "string",
            "description": "This record searches only Inmuebles24 (inmuebles24.com, Mexico). Omit this input or use inmuebles24; a different portal is rejected.",
            "default": "inmuebles24"
          },
          "operation": {
            "title": "Operation",
            "enum": [
              "sale",
              "rental"
            ],
            "type": "string",
            "description": "Listing operation to search: sale or rental. With startUrls, leave this at sale; each URL supplies its own operation.",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "departamentos",
              "casas",
              "terrenos",
              "ph",
              "oficinas",
              "locales-comerciales"
            ],
            "type": "string",
            "description": "Property type to search on Inmuebles24 in Mexico. Choose one of this record's supported property types.",
            "default": "departamentos"
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Optional Mexico location slug, for example \"polanco\" or \"condesa\". Spaces become hyphens and accents are folded. Empty searches the whole country. An unknown or changed location scope fails the run instead of returning unrelated listings.",
            "default": ""
          },
          "priceMin": {
            "title": "Minimum source-search price",
            "minimum": 0,
            "type": "number",
            "description": "Optional positive search price bound for Inmuebles24, in currency. Must not exceed priceMax. Returned prices retain their source currencies."
          },
          "priceMax": {
            "title": "Maximum source-search price",
            "minimum": 0,
            "type": "number",
            "description": "Optional positive search price bound for Inmuebles24, in currency. Must be at least priceMin. Returned prices retain their source currencies."
          },
          "currency": {
            "title": "Price-filter currency",
            "type": "string",
            "description": "Optional three-letter currency code for search price bounds, for example MXN or USD. This does not convert the returned source prices."
          },
          "startUrls": {
            "title": "Inmuebles24 search URLs (optional alternative)",
            "maxItems": 10,
            "type": "array",
            "description": "Up to 10 HTTPS Inmuebles24 listing-search URLs copied from your browser, as a URL string or {\"url\": \"...\"} object, for example https://www.inmuebles24.com/departamentos-en-venta-en-polanco-con-2-recamaras.html. Every filter in the address (area, rooms, amenities, price, sort order) is kept. Empty uses ordinary inputs. Leave operation=sale and propertyType=departamentos (the form defaults); other nondefault search fields that conflict with a URL are rejected. A later page number in the URL restarts at page 1. Other sites and unsupported property types are rejected. Page/result caps are global across the batch; duplicates are returned once.",
            "default": []
          },
          "bedroomsMin": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Optional minimum bedrooms, zero or greater. Applied after reading listings, before results are saved. Missing or ranged bedroom values are excluded. Must not exceed bedroomsMax."
          },
          "bedroomsMax": {
            "title": "Maximum bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Optional maximum bedrooms, zero or greater. Applied after reading listings, before results are saved. Missing or ranged bedroom values are excluded. Must be at least bedroomsMin."
          },
          "bathroomsMin": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Optional minimum bathrooms, zero or greater. Applied after reading listings, before results are saved. Missing or ambiguous bathroom values are excluded. Must not exceed bathroomsMax."
          },
          "bathroomsMax": {
            "title": "Maximum bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Optional maximum bathrooms, zero or greater. Applied after reading listings, before results are saved. Missing or ambiguous bathroom values are excluded. Must be at least bathroomsMin."
          },
          "areaMinM2": {
            "title": "Minimum measured area (m2)",
            "minimum": 5e-324,
            "type": "number",
            "description": "Optional finite positive minimum area in square metres (strictly greater than zero). Uses areaBasis. Applied after reading listings; missing, ambiguous or ranged measurements are excluded. Must not exceed areaMaxM2."
          },
          "areaMaxM2": {
            "title": "Maximum measured area (m2)",
            "minimum": 5e-324,
            "type": "number",
            "description": "Optional finite positive maximum area in square metres (strictly greater than zero). Uses areaBasis. Applied after reading listings; missing, ambiguous or ranged measurements are excluded. Must be at least areaMinM2."
          },
          "areaBasis": {
            "title": "Area measurement for filters",
            "enum": [
              "total",
              "built",
              "covered"
            ],
            "type": "string",
            "description": "Select total, built or covered source-labelled area for areaMinM2/areaMaxM2. Measurements are not substituted for one another. This does not select the pricePerM2 calculation basis; read that output's companions.",
            "default": "total"
          },
          "includeDevelopments": {
            "title": "Include development listings",
            "type": "boolean",
            "description": "Include development/project postings by default. Set false to exclude developments after reading listings, before results are saved. Projects are not individual-unit availability; their prices may be starting prices and their measurements may be ranges.",
            "default": true
          },
          "maxPages": {
            "title": "Maximum pages (global)",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Global search-page budget, 1 to 20 (default 3), shared across all search URLs. A page does not guarantee a fixed number of usable matches.",
            "default": 3
          },
          "maxResults": {
            "title": "Maximum results (global)",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Global cap on unique matching listings, 1 to 200 (default 50). A target, not a guaranteed count; availability, page budget and post-read filters can reduce the result count.",
            "default": 50
          },
          "requestDelaySecs": {
            "title": "Delay between page requests",
            "minimum": 0.5,
            "maximum": 10,
            "type": "number",
            "description": "Delay between search-page requests, from 0.5 to 10 seconds (default 1).",
            "default": 1
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}