{
  "openapi": "3.0.1",
  "info": {
    "title": "Fincaraiz Scraper | Real Estate Listings and Prices",
    "description": "FincaRaíz scraper for Colombia real estate: search any city or barrio, for sale or rent, and get 100 listings in 2 seconds, 43 fields each. Price in COP and USD, admin fee, estrato, areas, bedrooms, address, GPS, photos, amenities, lister and publication date, filtered by budget and estrato.",
    "version": "1.0",
    "x-build-id": "BD8fg1sdq4eglvLhf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~fincaraiz-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-fincaraiz-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/silentflow~fincaraiz-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-fincaraiz-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/silentflow~fincaraiz-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-fincaraiz-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": "📍 Locations",
            "type": "array",
            "description": "Cities, neighborhoods, zones or departments, typed like in the Fincaraiz search box: <code>Medellín</code>, <code>El Poblado</code>, <code>Chapinero, Bogotá</code>, <code>Antioquia</code>. Add the city after a comma when a neighborhood name exists in several cities. Leave empty (and add no link) to search all of Colombia.",
            "items": {
              "type": "string"
            }
          },
          "operationType": {
            "title": "🏷️ Sale or rent",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Listings for sale (venta) or for rent (arriendo). Rental prices are monthly rents.",
            "default": "sale"
          },
          "propertyTypes": {
            "title": "🏠 Property types",
            "type": "array",
            "description": "Keep only these types. Leave empty for every type: apartments, houses, lots, offices, shops and more.",
            "items": {
              "type": "string",
              "enum": [
                "apartment",
                "house",
                "studio",
                "country_house",
                "house_lot",
                "cabin",
                "farm",
                "room",
                "lot",
                "office",
                "commercial",
                "medical_office",
                "warehouse",
                "parking",
                "building"
              ],
              "enumTitles": [
                "Apartment (apartamento)",
                "House (casa)",
                "Studio (apartaestudio)",
                "Country house (casa campestre)",
                "House with lot (casa lote)",
                "Cabin (cabaña)",
                "Farm (finca)",
                "Room (habitación)",
                "Lot (lote)",
                "Office (oficina)",
                "Shop (local)",
                "Medical office (consultorio)",
                "Warehouse (bodega)",
                "Parking (parqueadero)",
                "Building (edificio)"
              ]
            }
          },
          "startUrls": {
            "title": "🔗 Fincaraiz links",
            "type": "array",
            "description": "Paste results pages with the filters you set on fincaraiz.com.co (<code>https://www.fincaraiz.com.co/arriendo/casas/cali/valle-del-cauca</code>) or single listings (<code>https://www.fincaraiz.com.co/apartamento-en-venta-en-laureles-medellin/194547438</code>). A results page keeps its own filters and is read to the end, every page.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "🔢 Max listings",
            "minimum": 1,
            "type": "integer",
            "description": "Most listings saved for the whole run. Each search returns about 100 listings per second; a city like Bogotá holds tens of thousands.",
            "default": 100
          },
          "sortBy": {
            "title": "↕️ Sort by",
            "enum": [
              "newest",
              "relevance",
              "price_asc",
              "price_desc",
              "area_asc",
              "area_desc"
            ],
            "type": "string",
            "description": "Newest first suits daily monitoring of new supply. The other orders match the site's own: most relevant, price and area, up or down.",
            "default": "newest"
          },
          "stratum": {
            "title": "🏘️ Estrato",
            "type": "array",
            "description": "Keep only listings in these socioeconomic strata, from 1 (lowest) to 6 (highest). Estrato drives utility rates and is the first segment buyers use. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6"
              ],
              "enumTitles": [
                "Estrato 1",
                "Estrato 2",
                "Estrato 3",
                "Estrato 4",
                "Estrato 5",
                "Estrato 6"
              ]
            }
          },
          "minPrice": {
            "title": "💰 Min price (COP)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest asking price in Colombian pesos, for example <code>300000000</code> for a sale or <code>2000000</code> for a monthly rent. Empty for no floor."
          },
          "maxPrice": {
            "title": "💰 Max price (COP)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest asking price in Colombian pesos, for example <code>800000000</code> for a sale or <code>5000000</code> for a monthly rent. Empty for no ceiling."
          },
          "minBedrooms": {
            "title": "🛏️ Min bedrooms",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Keep listings with at least this many bedrooms, for example <code>3</code>. Empty for any."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}