{
  "openapi": "3.0.1",
  "info": {
    "title": "Inmuebles24 Mexico Real Estate Scraper & Monitor",
    "description": "Extract Inmuebles24 listings in Mexico for rent and sale with price in pesos and dollars, mantenimiento, monthly cost, price per m², built and land area, GPS, WhatsApp and photos. Filter by colonia, amenities, pets or direct owners, and track new listings and price drops.",
    "version": "1.0",
    "x-build-id": "rgUG4rogDUjbPOutp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datamole~inmuebles24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datamole-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/datamole~inmuebles24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-datamole-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/datamole~inmuebles24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-datamole-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",
        "properties": {
          "locations": {
            "title": "Ubicaciones",
            "type": "array",
            "description": "Colonias, alcaldías, municipios o estados como aparecen en Inmuebles24, por ejemplo Polanco, Roma Norte, Santa Fe, Guadalajara o Querétaro.",
            "items": {
              "type": "string"
            }
          },
          "operation": {
            "title": "Operación",
            "enum": [
              "renta",
              "venta",
              "temporal-vacacional",
              "traspaso"
            ],
            "type": "string",
            "description": "Renta, Venta, Temporal / vacacional, Traspaso.",
            "default": "renta"
          },
          "propertyTypes": {
            "title": "Tipo de propiedad",
            "type": "array",
            "description": "Uno o varios tipos.",
            "items": {
              "type": "string",
              "enum": [
                "casa",
                "departamento",
                "terreno-lote",
                "oficina",
                "local-comercial",
                "edificio",
                "quinta",
                "casa-en-condominio",
                "departamento-compartido",
                "rancho",
                "villa",
                "casa-uso-de-suelo",
                "huerta",
                "inmueble-productivo-urbano",
                "local-en-centro-comercial",
                "terreno-comercial",
                "bodega-comercial",
                "nave-industrial",
                "terreno-industrial",
                "desarrollo-horizontal",
                "desarrollo-vertical",
                "desarrollo-horizontal-vertical",
                "duplex"
              ],
              "enumTitles": [
                "Casa",
                "Departamento",
                "Terreno / Lote",
                "Oficina",
                "Local comercial",
                "Edificio",
                "Quinta",
                "Casa en condominio",
                "Departamento compartido",
                "Rancho",
                "Villa",
                "Casa uso de suelo",
                "Huerta",
                "Inmueble productivo urbano",
                "Local en centro comercial",
                "Terreno comercial",
                "Bodega comercial",
                "Nave industrial",
                "Terreno industrial",
                "Desarrollo horizontal",
                "Desarrollo vertical",
                "Desarrollo horizontal/vertical",
                "Dúplex"
              ]
            },
            "default": [
              "departamento"
            ]
          },
          "searchUrls": {
            "title": "URLs de búsqueda",
            "type": "array",
            "description": "Opcional. Pegá cualquier búsqueda del portal con tus filtros ya aplicados. Se recorren todas sus páginas.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Máximo de avisos",
            "minimum": 1,
            "type": "integer",
            "description": "Tope para toda la corrida. Vacío = sin tope."
          },
          "maxPagesPerSearch": {
            "title": "Máximo de páginas por búsqueda",
            "minimum": 1,
            "type": "integer",
            "description": "Cada página trae 30 avisos. Vacío = todas."
          },
          "minPrice": {
            "title": "Precio mínimo",
            "minimum": 0,
            "type": "integer",
            "description": "Precio mínimo"
          },
          "maxPrice": {
            "title": "Precio máximo",
            "minimum": 0,
            "type": "integer",
            "description": "Precio máximo"
          },
          "priceCurrency": {
            "title": "Moneda del filtro de precio",
            "enum": [
              "MXN",
              "USD"
            ],
            "type": "string",
            "description": "Moneda del filtro de precio.",
            "default": "MXN"
          },
          "minMaintenance": {
            "title": "Mantenimiento mínimo (MXN)",
            "minimum": 0,
            "type": "integer",
            "description": "Mantenimiento mínimo."
          },
          "maxMaintenance": {
            "title": "Mantenimiento máximo (MXN)",
            "minimum": 0,
            "type": "integer",
            "description": "Mantenimiento máximo."
          },
          "minBedrooms": {
            "title": "Recámaras (mínimo)",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Recámaras."
          },
          "minBathrooms": {
            "title": "Baños (mínimo)",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Baños (mínimo)"
          },
          "minParking": {
            "title": "Estacionamientos (mínimo)",
            "minimum": 0,
            "maximum": 4,
            "type": "integer",
            "description": "Estacionamientos."
          },
          "minArea": {
            "title": "Superficie mínima (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Superficie construida."
          },
          "maxArea": {
            "title": "Superficie máxima (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Superficie construida."
          },
          "antiquity": {
            "title": "Antigüedad",
            "enum": [
              "en-construccion",
              "a-estrenar",
              "hasta-5",
              "hasta-10",
              "hasta-20",
              "hasta-50",
              "mas-de-50"
            ],
            "type": "string",
            "description": "Antigüedad máxima del inmueble."
          },
          "general": {
            "title": "Generales",
            "type": "array",
            "description": "Alberca, amueblado, elevador, permite mascotas, closet y más. Se exigen todas las elegidas.",
            "items": {
              "type": "string",
              "enum": [
                "amueblado",
                "elevador",
                "centros-comerciales-cercanos",
                "escuelas-cercanas",
                "blancos",
                "permite-mascotas",
                "acceso-para-personas-con-movilidad-reducida",
                "duplex",
                "closet",
                "triplex",
                "alberca"
              ],
              "enumTitles": [
                "Amueblado",
                "Elevador",
                "Centros comerciales cercanos",
                "Escuelas cercanas",
                "Blancos",
                "Permite mascotas",
                "Acceso para personas con movilidad reducida",
                "Dúplex",
                "Closet",
                "Triplex",
                "Alberca"
              ]
            }
          },
          "outdoor": {
            "title": "Exteriores",
            "type": "array",
            "description": "Asador, balcón, terraza, jardín privado, patio. Se exigen todas las elegidas.",
            "items": {
              "type": "string",
              "enum": [
                "asador",
                "patio",
                "terraza",
                "balcon",
                "jardin-privado"
              ],
              "enumTitles": [
                "Asador",
                "Patio",
                "Terraza",
                "Balcón",
                "Jardín privado"
              ]
            }
          },
          "services": {
            "title": "Servicios",
            "type": "array",
            "description": "Seguridad privada, caseta de guardia, aire acondicionado, cisterna y más. Se exigen todas las elegidas.",
            "items": {
              "type": "string",
              "enum": [
                "caseta-de-guardia",
                "internet-wifi",
                "aire-acondicionado",
                "seguridad-privada",
                "cisterna",
                "servicios-basicos-agua-luz",
                "estacionamiento-de-visitas",
                "calefaccion"
              ],
              "enumTitles": [
                "Caseta de guardia",
                "Internet/Wifi",
                "Aire acondicionado",
                "Seguridad privada",
                "Cisterna",
                "Servicios básicos (agua/luz)",
                "Estacionamiento de visitas",
                "Calefacción"
              ]
            }
          },
          "amenities": {
            "title": "Amenidades",
            "type": "array",
            "description": "Gimnasio, spa, co-working, salón de usos múltiples, áreas deportivas y más. Se exigen todas las elegidas.",
            "items": {
              "type": "string",
              "enum": [
                "gimnasio",
                "jardines",
                "sauna",
                "area-de-eventos",
                "business-center",
                "jacuzzi",
                "area-de-juegos-infantiles",
                "salon-de-usos-multiples",
                "spa",
                "espacio-de-co-working",
                "areas-deportivas"
              ],
              "enumTitles": [
                "Gimnasio",
                "Jardines",
                "Sauna",
                "Área de eventos",
                "Business center",
                "Jacuzzi",
                "Área de juegos infantiles",
                "Salón de usos múltiples",
                "Spa",
                "Espacio de co-working",
                "Áreas deportivas"
              ]
            }
          },
          "roomTypes": {
            "title": "Ambientes",
            "type": "array",
            "description": "Estudio, cuarto de servicio, cuarto de TV, cocina integral y más. Se exigen todas las elegidas.",
            "items": {
              "type": "string",
              "enum": [
                "area-de-lavado",
                "bodega",
                "estudio",
                "cuartos-de-servicio",
                "cuarto-de-juegos",
                "cocina-integral",
                "cuarto-de-tv",
                "oficina",
                "sotano"
              ],
              "enumTitles": [
                "Área de lavado",
                "Bodega",
                "Estudio",
                "Cuartos de servicio",
                "Cuarto de juegos",
                "Cocina integral",
                "Cuarto de TV",
                "Oficina",
                "Sótano"
              ]
            }
          },
          "view": {
            "title": "Vista",
            "enum": [
              "frente",
              "interior"
            ],
            "type": "string",
            "description": "Frente o interior."
          },
          "publisherType": {
            "title": "Anunciante",
            "enum": [
              "todos",
              "inmobiliaria",
              "dueno-directo"
            ],
            "type": "string",
            "description": "Todos, inmobiliaria / trato directo.",
            "default": "todos"
          },
          "publishedWithin": {
            "title": "Publicado",
            "enum": [
              "hoy",
              "desde-ayer",
              "ultima-semana",
              "ultimos-15-dias",
              "ultimos-30-dias",
              "ultimos-45-dias"
            ],
            "type": "string",
            "description": "Solo avisos publicados en este período."
          },
          "multimedia": {
            "title": "Multimedia",
            "type": "array",
            "description": "Solo avisos con video, recorrido 360 o planos.",
            "items": {
              "type": "string",
              "enum": [
                "video",
                "recorrido-360",
                "planos"
              ],
              "enumTitles": [
                "Video",
                "Recorrido 360",
                "Planos"
              ]
            }
          },
          "keyword": {
            "title": "Palabra clave",
            "type": "string",
            "description": "Buscador de palabras del portal. Es estricto y devuelve pocos avisos: para comodidades usá los filtros de comodidades."
          },
          "sort": {
            "title": "Orden",
            "enum": [
              "more_recent",
              "relevance",
              "low_price",
              "high_price",
              "most_lowered_price"
            ],
            "type": "string",
            "description": "Más recientes recorre la búsqueda completa sin repetidos. Bajaron de precio muestra primero las rebajas.",
            "default": "more_recent"
          },
          "includeDetails": {
            "title": "Detalle completo (con costo extra)",
            "type": "boolean",
            "description": "Abre cada aviso para sumar todas las comodidades, antigüedad, teléfono del anunciante, dirección exacta, descripción completa y fecha de publicación. Es más lento y tiene un costo adicional por aviso.",
            "default": false
          },
          "monitorMode": {
            "title": "Modo monitoreo",
            "type": "boolean",
            "description": "Recuerda los avisos entre corridas y devuelve solo los nuevos y los que cambiaron de precio, con el precio anterior y el % de cambio. La primera corrida devuelve todo.",
            "default": false
          },
          "monitorName": {
            "title": "Nombre del monitoreo",
            "type": "string",
            "description": "Opcional. Usá el mismo nombre para compartir la memoria entre configuraciones. Vacío = se identifica por los filtros."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "El portal exige IP residencial del país. Dejalo como está.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "MX"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}