VivaReal Colombia Real Estate Listings by City & Price

Search VivaReal Colombia for properties for sale or rent by city, neighborhood, property type, price range, bedrooms, and area, and get back price, size, address, photo, and listing URL for each match.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	required	Search a Brazilian city for sale/rent listings, or fetch specific listings by URL or ID.
`city`	string	optional	Brazilian city to search, for example São Paulo, Rio de Janeiro, or Belo Horizonte. Use with State.
`state`	string	optional	Brazilian state (UF) that contains the city.

Show all input fields

Field	Type	Required	Description
`mode`	string	required	Search a Brazilian city for sale/rent listings, or fetch specific listings by URL or ID.
`city`	string	optional	Brazilian city to search, for example São Paulo, Rio de Janeiro, or Belo Horizonte. Use with State.
`state`	string	optional	Brazilian state (UF) that contains the city.
`neighborhood`	string	optional	Optional neighborhood within the city, for example Pinheiros or Copacabana.
`propertyType`	string	optional	Filter by property type. Legacy values TERRAIN and COMMERCIAL still work.
`usageType`	string	optional	Residential, commercial, or any usage.
`listingType`	string	optional	Used resale listings, new-development listings, or both.
`priceMin`	integer	optional	Minimum price in Brazilian reais. Not Colombian pesos.
`priceMax`	integer	optional	Maximum price in Brazilian reais. Not Colombian pesos.
`bedroomsMin`	integer	optional	Minimum number of bedrooms.
`bedroomsMax`	integer	optional	Maximum number of bedrooms.
`bathroomsMin`	integer	optional	Minimum number of bathrooms.
`bathroomsMax`	integer	optional	Maximum number of bathrooms.
`parkingMin`	integer	optional	Minimum number of parking spaces.
`areaMin`	integer	optional	Minimum usable area in square meters.
`areaMax`	integer	optional	Maximum usable area in square meters.
`amenities`	array	optional	Optional amenity codes the listing must have, for example POOL, GYM, ELEVATOR, BARBECUE_GRILL, or PETS_ALLOWED.
`listingUrls`	array	optional	VivaReal listing URLs or numeric IDs to fetch (mode=byUrls). Example: https://www.vivareal.com.br/imovel/2918839249/
`maxItems`	integer	optional	Maximum number of listings to return.

Download the published input schema

View complete JSON

{
  "description": "Search VivaReal Brazil by city, state, neighborhood, price, area, rooms, property type, and amenities, or look up specific listing URLs/IDs.",
  "properties": {
    "amenities": {
      "description": "Optional amenity codes the listing must have, for example POOL, GYM, ELEVATOR, BARBECUE_GRILL, or PETS_ALLOWED.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Amenities",
      "type": "array"
    },
    "areaMax": {
      "description": "Maximum usable area in square meters.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Max Usable Area (m²)",
      "type": "integer"
    },
    "areaMin": {
      "description": "Minimum usable area in square meters.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Min Usable Area (m²)",
      "type": "integer"
    },
    "bathroomsMax": {
      "description": "Maximum number of bathrooms.",
      "maximum": 20,
      "minimum": 0,
      "title": "Max Bathrooms",
      "type": "integer"
    },
    "bathroomsMin": {
      "description": "Minimum number of bathrooms.",
      "maximum": 20,
      "minimum": 0,
      "title": "Min Bathrooms",
      "type": "integer"
    },
    "bedroomsMax": {
      "description": "Maximum number of bedrooms.",
      "maximum": 20,
      "minimum": 0,
      "title": "Max Bedrooms",
      "type": "integer"
    },
    "bedroomsMin": {
      "description": "Minimum number of bedrooms.",
      "maximum": 20,
      "minimum": 0,
      "title": "Min Bedrooms",
      "type": "integer"
    },
    "city": {
      "default": "São Paulo",
      "description": "Brazilian city to search, for example São Paulo, Rio de Janeiro, or Belo Horizonte. Use with State.",
      "editor": "textfield",
      "prefill": "São Paulo",
      "title": "City",
      "type": "string"
    },
    "listingType": {
      "default": "USED",
      "description": "Used resale listings, new-development listings, or both.",
      "editor": "select",
      "enum": [
        "USED",
        "DEVELOPMENT",
        "ALL"
      ],
      "enumTitles": [
        "Used / resale",
        "New development",
        "Both"
      ],
      "prefill": "USED",
      "title": "Listing Type",
      "type": "string"
    },
    "listingUrls": {
      "description": "VivaReal listing URLs or numeric IDs to fetch (mode=byUrls). Example: https://www.vivareal.com.br/imovel/2918839249/",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Listing URLs or IDs",
      "type": "array"
    },
    "maxItems": {
      "default": 50,
      "description": "Maximum number of listings to return.",
      "maximum": 1000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max Items",
      "type": "integer"
    },
    "mode": {
      "default": "sale",
      "description": "Search a Brazilian city for sale/rent listings, or fetch specific listings by URL or ID.",
      "editor": "select",
      "enum": [
        "sale",
        "rent",
        "byUrls",
        "searchForSale",
        "searchForRent"
      ],
      "enumTitles": [
        "Properties for sale",
        "Properties for rent",
        "Look up listings by URL or ID",
        "Properties for sale (legacy saved task)",
        "Properties for rent (legacy saved task)"
      ],
      "prefill": "sale",
      "title": "Mode",
      "type": "string"
    },
    "neighborhood": {
      "description": "Optional neighborhood within the city, for example Pinheiros or Copacabana.",
      "editor": "textfield",
      "title": "Neighborhood",
      "type": "string"
    },
    "parkingMin": {
      "description": "Minimum number of parking spaces.",
      "maximum": 20,
      "minimum": 0,
      "title": "Min Parking Spaces",
      "type": "integer"
    },
    "priceMax": {
      "description": "Maximum price in Brazilian reais. Not Colombian pesos.",
      "maximum": 10000000000,
      "minimum": 0,
      "title": "Max Price (BRL)",
      "type": "integer"
    },
    "priceMin": {
      "description": "Minimum price in Brazilian reais. Not Colombian pesos.",
      "maximum": 10000000000,
      "minimum": 0,
      "title": "Min Price (BRL)",
      "type": "integer"
    },
    "propertyType": {
      "default": "ANY",
      "description": "Filter by property type. Legacy values TERRAIN and COMMERCIAL still work.",
      "editor": "select",
      "enum": [
        "ANY",
        "APARTMENT",
        "HOME",
        "PENTHOUSE",
        "FLAT",
        "KITNET",
        "OFFICE",
        "ALLOTMENT_LAND",
        "COMMERCIAL_PROPERTY",
        "COMMERCIAL_BUILDING",
        "WAREHOUSE",
        "GARAGE",
        "FARM",
        "HOTEL",
        "TERRAIN",
        "COMMERCIAL"
      ],
      "enumTitles": [
        "Any type",
        "Apartment",
        "House",
        "Penthouse",
        "Flat",
        "Kitnet / studio",
        "Office",
        "Land / lot",
        "Commercial property",
        "Commercial building",
        "Warehouse",
        "Garage",
        "Farm",
        "Hotel",
        "Land (legacy alias)",
        "Commercial (legacy alias)"
      ],
      "prefill": "ANY",
      "title": "Property Type",
      "type": "string"
    },
    "state": {
      "default": "SP",
      "description": "Brazilian state (UF) that contains the city.",
      "editor": "select",
      "enum": [
        "AC",
        "AL",
        "AP",
        "AM",
        "BA",
        "CE",
        "DF",
        "ES",
        "GO",
        "MA",
        "MT",
        "MS",
        "MG",
        "PA",
        "PB",
        "PR",
        "PE",
        "PI",
        "RJ",
        "RN",
        "RS",
        "RO",
        "RR",
        "SC",
        "SP",
        "SE",
        "TO"
      ],
      "enumTitles": [
        "Acre",
        "Alagoas",
        "Amapá",
        "Amazonas",
        "Bahia",
        "Ceará",
        "Distrito Federal",
        "Espírito Santo",
        "Goiás",
        "Maranhão",
        "Mato Grosso",
        "Mato Grosso do Sul",
        "Minas Gerais",
        "Pará",
        "Paraíba",
        "Paraná",
        "Pernambuco",
        "Piauí",
        "Rio de Janeiro",
        "Rio Grande do Norte",
        "Rio Grande do Sul",
        "Rondônia",
        "Roraima",
        "Santa Catarina",
        "São Paulo",
        "Sergipe",
        "Tocantins"
      ],
      "prefill": "SP",
      "title": "State",
      "type": "string"
    },
    "usageType": {
      "default": "ANY",
      "description": "Residential, commercial, or any usage.",
      "editor": "select",
      "enum": [
        "ANY",
        "RESIDENTIAL",
        "COMMERCIAL"
      ],
      "enumTitles": [
        "Any usage",
        "Residential",
        "Commercial"
      ],
      "prefill": "ANY",
      "title": "Usage",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "VivaReal Brazil Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`listings`	string	optional	Dataset containing all scraped property listings from VivaReal Brazil.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "One record per VivaReal Brazil listing, with BRL price, condo fee, IPTU, areas, rooms, address and coordinates, amenities, photos, advertiser contacts, and listing URL.",
  "properties": {
    "listings": {
      "description": "Dataset containing all scraped property listings from VivaReal Brazil.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "VivaReal Brazil listings",
      "type": "string"
    }
  },
  "title": "VivaReal Brazil Real Estate Listings by City & Price Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Properties",
      "transformation": {
        "fields": [
          "title",
          "price",
          "currency",
          "condoFee",
          "area",
          "totalArea",
          "bedrooms",
          "bathrooms",
          "parkingSpaces",
          "city",
          "neighborhood",
          "propertyType",
          "listingUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

VivaReal Brazil Real Estate Listings by City & Price

Scrape VivaReal Brazil (vivareal.com.br) for homes for sale or rent in any Brazilian city. Records carry the BRL price, condo fee, IPTU, usable and total area, room counts, street address and coordinates, amenities, every listing photo, the advertiser's public contact details, and a working listing URL whenever VivaReal publishes them. Search by city, state, and neighborhood, or paste specific listing URLs/IDs to get full titles, descriptions, and detail-fresh fields. Search records come from VivaReal's search index; byUrls reads the detail endpoint and is the freshest source for descriptions, images, contact details, and timestamps.

VivaReal Colombia (vivareal.com.co) has been offline since 2024 and returns HTTP 410. The live VivaReal marketplace is the Brazilian one. This actor's historical slug still says "Colombia", but it now scrapes VivaReal Brazil only. Bogotá or other Colombian inputs return zero records with a clear status message — no invented data.

What this actor does

Three modes: sale, rent, and byUrls (VivaReal listing URLs or numeric IDs).
City searches: combine city + state, optionally narrow to a neighborhood.
Server + client filters: price, usable area, bedrooms, bathrooms, parking, property type, usage type, listing type (USED, DEVELOPMENT, or both), and amenities.
Complete property record: condo fee, IPTU with period, usable and total area, suites, coordinates, amenities, all photos, advertiser name/licence/phones, WhatsApp, and timestamps (createdAt in search; createdAt + updatedAt in byUrls).
Deep pagination: up to 1,000 listings per run, deduplicated by listing ID.
Empty fields are omitted — a missing value is never emitted as null, "", or [].

Output per listing

Field	Description
`listingId`	VivaReal listing identifier
`title`	Portal title when available (`byUrls`, or the search `h2Tag`); otherwise a composed title
`titleSource`	`portal` when the title came from VivaReal, `generated` when composed
`description`	Full description (mode=`byUrls` only; search results do not include it)
`price`, `currency`	Asking price and `BRL`
`condoFee`	Monthly condo fee in BRL, when published
`iptu`, `iptuPeriod`	IPTU value and period (`yearly` or `monthly`)
`area`	Usable area in m²
`totalArea`	Total area in m², when published
`bedrooms`, `bathrooms`, `suites`, `parkingSpaces`	Room and parking counts
`propertyType`, `propertyTypeLabel`	VivaReal code and Portuguese label (`APARTMENT` / `Apartamento`, etc.)
`usageType`	`RESIDENTIAL` or `COMMERCIAL`
`transactionType`	`sale` or `rental` from the listing's pricing block
`listingType`	`used` or `development`
`street`, `streetNumber`, `neighborhood`, `city`, `state`, `stateCode`, `zipCode`	Address parts
`address`	Readable address string built from the available parts
`latitude`, `longitude`	Exact map coordinates when available; approximate-location listings may omit them
`amenities`	Amenity codes such as `POOL`, `GYM`, `ELEVATOR`, `BARBECUE_GRILL`
`images`	Every listing photo, in source order
`imageUrl`	First photo
`advertiserName`, `advertiserLicense`	Advertiser/agency name and licence number
`advertiserPhones`	Public phone numbers
`whatsapp`	Public WhatsApp number, when published
`createdAt`, `updatedAt`	Listing timestamps; `updatedAt` is returned in `byUrls` and omitted in search (the search API does not return it)
`listingUrl`	`https://www.vivareal.com.br/imovel/<id>/`
`mode`	`sale`, `rent`, or `byUrls`
`recordType`	Always `property`
`scrapedAt`	ISO 8601 timestamp of the scrape

Input

Field	Type	Default	Description
`mode`	string	`sale`	`sale`, `rent`, or `byUrls`
`city`	string	`São Paulo`	Brazilian city to search
`state`	string	`SP`	Brazilian state (UF)
`neighborhood`	string	–	Optional neighborhood within the city
`propertyType`	string	`ANY`	Any type, apartment, house, penthouse, flat, kitnet, office, land, commercial, warehouse, garage, farm, or hotel
`usageType`	string	`ANY`	`ANY`, `RESIDENTIAL`, or `COMMERCIAL`
`listingType`	string	`USED`	`USED`, `DEVELOPMENT`, or `ALL`
`priceMin`, `priceMax`	integer	–	Price range in BRL
`bedroomsMin`, `bedroomsMax`	integer	–	Bedroom range
`bathroomsMin`, `bathroomsMax`	integer	–	Bathroom range
`parkingMin`	integer	–	Minimum parking spaces (search currently applies this as an exact match; see Limitations)
`areaMin`, `areaMax`	integer	–	Usable area range in m²
`amenities`	array	–	Required amenity codes (all must match)
`listingUrls`	array	–	VivaReal URLs or numeric IDs (mode=`byUrls`)
`maxItems`	integer	`50`	Maximum records to return (1–1000)

Legacy saved tasks still work: mode values searchForSale / searchForRent are treated as sale / rent, and propertyType values TERRAIN / COMMERCIAL are treated as land / commercial property.

Example: apartments for sale in São Paulo

{
  "mode": "sale",
  "city": "São Paulo",
  "state": "SP",
  "propertyType": "APARTMENT",
  "priceMin": 400000,
  "priceMax": 900000,
  "bedroomsMin": 2,
  "areaMin": 60,
  "maxItems": 100
}

Example: houses for rent in Rio de Janeiro

{
  "mode": "rent",
  "city": "Rio de Janeiro",
  "state": "RJ",
  "neighborhood": "Copacabana",
  "propertyType": "HOME",
  "parkingMin": 1,
  "maxItems": 50
}

Example: listing lookup by URL

{
  "mode": "byUrls",
  "listingUrls": [
    "https://www.vivareal.com.br/imovel/2918839249/",
    "2918720977"
  ]
}

Example: amenities and area in Belo Horizonte

{
  "mode": "sale",
  "city": "Belo Horizonte",
  "state": "MG",
  "amenities": ["POOL", "GYM", "ELEVATOR"],
  "areaMin": 80,
  "areaMax": 200,
  "listingType": "USED",
  "maxItems": 30
}

Use cases

Market research — compare asking prices, condo fees, and IPTU across Brazilian cities and neighborhoods.
Lead generation — build a current list of active listings with advertiser phone and WhatsApp contacts.
Investment screening — filter by price, area, rooms, and amenities to shortlist candidate properties.
Rental monitoring — track rent asking prices and availability in a target neighborhood.
Proptech data feeds — power a search, valuation, or comparison product with live VivaReal inventory.

FAQ

Which cities can I search? Any Brazilian city covered by VivaReal, including São Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Salvador, Recife, Fortaleza, and Brasília. Pass the city name in city and its state in state.

What currency are prices in? Brazilian reais (BRL). VivaReal Brazil lists prices in BRL. The actor does not convert values or apply legacy COP amounts.

Why does the title look generated in search results? VivaReal's search API does not return a title for most listings, and some of the h2Tag titles it does return are truncated. The actor uses the portal title when one exists, otherwise it composes a readable title from the property type, bedroom count, neighborhood, and city, and marks it with titleSource: "generated". Use byUrls for the full portal title.

Why is description missing from search results? Descriptions are not part of VivaReal's search response. Use mode: "byUrls" with listing URLs or IDs to fetch full titles, descriptions, and updated timestamps.

What does iptuPeriod mean? It tells you whether the IPTU value is yearly or monthly. Search mode follows the search API's yearlyIptu field; the detail response (and byUrls) can mark the same value monthly. The actor preserves the period from the response it used instead of silently converting it, so use byUrls for detail-consistent periods.

How many listings can I get in one run? Up to 1,000 via maxItems. The actor pages through VivaReal at 30 listings per page. A very broad, rarity-filtered search can hit the 5,000-row scan limit; narrow the city, neighborhood, price, or property type for deeper coverage.

Why are some fields missing from individual records? VivaReal does not publish every field for every listing, and approximate-location listings can lack a street number or exact coordinates. The actor omits a missing field rather than guessing or filling it with a placeholder. Search records can also lag the live detail page; use byUrls for the freshest values.

Can I search VivaReal Colombia or Bogotá? No. VivaReal Colombia is offline. Colombian city names return zero records with a status message explaining that the actor now covers Brazil.

Do I need a VivaReal account, login, or proxy? No. The actor reads public VivaReal listings and chooses a working connection automatically. Just fill in the input and run it.

Is this affiliated with VivaReal? No. This is an independent, third-party actor that reads VivaReal's public listing data and is not operated by or affiliated with VivaReal.

Limitations

No descriptions in search: only byUrls returns the full description.
Composed titles: most search records use a generated title because the search API omits the portal title.
Search-index freshness: sale/rent records come from VivaReal's search index. Area, room counts, neighborhood, and IPTU period can differ from the live listing page; byUrls returns detail-fresh values. In the 2026-10-24 25-listing check, 2/15 sale records had stale area/room/parking values, 6/15 had a different neighborhood, and 7/10 rent records reported a yearly IPTU period that the page marked monthly.
Parking filter: in search, parkingMin currently acts as an exact parkingSpaces match, so listings with more spaces can be missed. The intended minimum semantics require a code fix; use byUrls or omit the filter until then.
Approximate locations: listings whose map point is approximate can omit streetNumber, latitude, and longitude, even though the page shows a neighborhood-level pin.
Truncated search titles: some search h2Tag titles are truncated; byUrls returns the full portal title.
IPTU period ambiguity: search mode follows the search API's yearlyIptu; the detail response (and byUrls) can mark the same value monthly. Use byUrls for detail-consistent periods.
Source caps: VivaReal returns at most 30 listings per page. A run scans at most 5,000 rows before reporting a shortfall.
Photo quality: images are requested at 1024×768 and may be unavailable if VivaReal removed them.
Brazil only: there is no Colombian inventory, no ZAP Imóveis data, and no virtual tours or videos.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build qV2ux6HuxEezQno99. Documentation is regenerated from the default published build; private drafts are not included.