{
  "openapi": "3.0.1",
  "info": {
    "title": "FincaRaíz Property Scraper - Colombia Real Estate Data",
    "description": "Scrape FincaRaíz (Colombia) property listings by city, operation and type, or paste search & property URLs. One row per property: price in COP + USD, area, bedrooms, bathrooms, estrato, full location, amenities, images and the lister/agency. Optional detail enrichment. JSON/CSV/API.",
    "version": "0.1",
    "x-build-id": "Tq71mV3Ll8ZUmhZbR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~fincaraiz-property-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-fincaraiz-property-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/memo23~fincaraiz-property-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-fincaraiz-property-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/memo23~fincaraiz-property-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-fincaraiz-property-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": {
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Free-text queries in the form `<operation> <property-type> <city>`, e.g. `venta apartamentos bogota`, `arriendo casas medellin`, `venta lotes cali`. Operation defaults to `venta` and type to `apartamentos` if omitted. Each is paginated.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Search & property URLs",
            "type": "array",
            "description": "FincaRaíz listing/search URLs (e.g. `https://www.fincaraiz.com.co/venta/apartamentos/bogota`) and/or individual property detail URLs (e.g. `https://www.fincaraiz.com.co/apartamento-en-venta-en-chapinero-bogota/193084937`). Auto-classified.",
            "items": {
              "type": "string"
            }
          },
          "agencyDirectory": {
            "title": "Return agencies instead of properties",
            "type": "boolean",
            "description": "One row per FincaRaíz agency (inmobiliaria) or developer (constructora): name, contact email, phone and WhatsApp where the agency publishes them, office address, city, department, and how many sale and rent listings it has live. Turns on by itself when you fill any filter below. Each agency row is one paid `agency` event; free-plan users get the first 25.",
            "default": false
          },
          "agencyCity": {
            "title": "City",
            "type": "string",
            "description": "Only agencies whose office or listings are in this city, e.g. `Medellín`, `Cali`, `Bogotá`. Accents and capitals are optional."
          },
          "agencyDepartment": {
            "title": "Department",
            "type": "string",
            "description": "Only agencies in this department, e.g. `Antioquia`, `Valle del Cauca`, `Cundinamarca`, `Bogotá D.C.`."
          },
          "agencyType": {
            "title": "Agency type",
            "enum": [
              "all",
              "inmobiliaria",
              "desarrollador"
            ],
            "type": "string",
            "description": "Real-estate agencies, developers, or both.",
            "default": "all"
          },
          "agencyNameContains": {
            "title": "Name contains",
            "type": "string",
            "description": "Only agencies whose name contains this text, e.g. `Inmobiliaria`, `Propiedad Raíz`."
          },
          "agencyHasPhone": {
            "title": "Only agencies with a phone number",
            "type": "boolean",
            "description": "Only agencies that publish a phone or WhatsApp number (roughly 1 in 12 does). Nearly every agency has a contact email.",
            "default": false
          },
          "agencyMinListings": {
            "title": "Minimum live listings",
            "minimum": 0,
            "type": "integer",
            "description": "Only agencies with at least this many live sale and rent listings on FincaRaíz, e.g. `20` for established agencies."
          },
          "scrapeDetails": {
            "title": "Scrape property detail pages",
            "type": "boolean",
            "description": "For each property found in a search, also fetch its detail page to add the full description, complete amenities/facilities list and the full image gallery. Richer rows, but ~2× the requests. Off = the search-card fields (already ~40 per property). Property URLs you paste are always fully detailed.",
            "default": false
          },
          "maxItems": {
            "title": "Max results (whole run)",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on rows across the entire run. Each row is one paid `property` event (or one `agency` event in agency mode). Default 1000. Free-tier users are additionally capped at 100 properties or 25 agencies.",
            "default": 1000
          },
          "maxItemsPerSearch": {
            "title": "Max properties per search",
            "minimum": 1,
            "type": "integer",
            "description": "Cap per search query / URL. FincaRaíz returns 21 properties per page. Default 1000.",
            "default": 1000
          },
          "maxConcurrency": {
            "title": "Max parallel requests",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "Parallel HTTP requests. Keep this moderate (4–8) to stay under rate limits. Default 6.",
            "default": 6
          },
          "maxRequestRetries": {
            "title": "Max request retries",
            "minimum": 0,
            "type": "integer",
            "description": "Per-request retry budget on 403 / 429 / 5xx / network errors. Each retry rotates to a fresh Colombian residential IP. Default 12.",
            "default": 12
          },
          "proxy": {
            "title": "Proxy configuration (optional override)",
            "type": "object",
            "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}