{
  "openapi": "3.0.1",
  "info": {
    "title": "Propiedades Scraper | Fast & Reliable | $1.5 / 1k",
    "description": "Extract structured real estate listings across Mexico from Propiedades.com with prices, full description, property details, seller data, media and more. Built for enterprise-grade real estate intelligence, lead enrichment, market analysis, and automated data pipelines.",
    "version": "0.0",
    "x-build-id": "Bp39pukqaFgPH0dH8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fatihtahta~propiedades-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fatihtahta-propiedades-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/fatihtahta~propiedades-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fatihtahta-propiedades-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/fatihtahta~propiedades-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fatihtahta-propiedades-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": {
          "location": {
            "title": "Add Search Areas (eg. Roma Norte, Napoles, San Pedro Garza Garcia)",
            "type": "array",
            "description": "Enter one specific search area per row. Use precise names shown on Propiedades, for example Roma Norte, Napoles, or San Pedro Garza Garcia. Avoid broad city names because Propiedades searches by smaller local areas.",
            "items": {
              "type": "string"
            }
          },
          "deal_type": {
            "title": "Choose Deal Type",
            "enum": [
              "all",
              "sale",
              "sale_infonavit",
              "sale_remate",
              "rent"
            ],
            "type": "string",
            "description": "Select which deal type should be included in the results. Choose All to keep sale, rent, and special sale categories in scope.",
            "default": "all"
          },
          "property_type": {
            "title": "Choose Property Type",
            "enum": [
              "house",
              "gated_community_house",
              "apartment",
              "residential_land",
              "ranch",
              "office",
              "industrial_warehouse",
              "commercial_land",
              "industrial_storage",
              "retail_space",
              "building",
              "room",
              "commercial_storage",
              "industrial_land"
            ],
            "type": "string",
            "description": "Select the property category to collect. The default focuses on apartments; choose a different type when you need houses, land, offices, warehouses, retail spaces, or other property segments.",
            "default": "apartment"
          },
          "min_bedroom": {
            "title": "Set Minimum Bedrooms",
            "enum": [
              "1",
              "2",
              "3",
              "4_plus"
            ],
            "type": "string",
            "description": "Choose the minimum number of bedrooms required. Leave unset when bedroom count should not restrict the results."
          },
          "min_bathroom": {
            "title": "Set Minimum Bathrooms",
            "enum": [
              "1",
              "1_5",
              "2",
              "2_5_plus"
            ],
            "type": "string",
            "description": "Choose the minimum number of bathrooms required. Leave unset to include listings regardless of bathroom count."
          },
          "min_parking": {
            "title": "Set Minimum Parking Spaces",
            "enum": [
              "1",
              "2",
              "3",
              "4_plus"
            ],
            "type": "string",
            "description": "Choose the minimum number of parking spaces required. Leave unset when parking availability should not narrow the dataset."
          },
          "amenity": {
            "title": "Choose Required Amenity",
            "enum": [
              "amenities",
              "pool",
              "furnished",
              "laundry_area",
              "fireplace",
              "garden",
              "basement",
              "terrace"
            ],
            "type": "string",
            "description": "Select an amenity to require in the results. Use the default option to keep the broader amenity category in scope.",
            "default": "amenities"
          },
          "min_price": {
            "title": "Set Minimum Price",
            "minimum": 1000,
            "type": "integer",
            "description": "Enter the lowest listing price to include, in Mexican pesos. Leave empty when lower-priced listings should remain in scope."
          },
          "max_price": {
            "title": "Set Maximum Price",
            "minimum": 1000,
            "type": "integer",
            "description": "Enter the highest listing price to include, in Mexican pesos. Leave empty when higher-priced listings should remain in scope."
          },
          "min_area": {
            "title": "Set Minimum Area",
            "type": "integer",
            "description": "Enter the minimum constructed area to include, in square meters. Leave empty to include smaller listings."
          },
          "max_area": {
            "title": "Set Maximum Area",
            "type": "integer",
            "description": "Enter the maximum constructed area to include, in square meters. Leave empty to include larger listings."
          },
          "limit": {
            "title": "Set Maximum Results per Input",
            "minimum": 1,
            "type": "integer",
            "description": "Set the maximum number of listings to save for each provided location or input. Leave empty to collect all available matching listings for the configured search."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}