QuintoAndar Scraper

Slug: fatihtahta/quintoandar-scraper

Overview

QuintoAndar Scraper collects structured property listing data from QuintoAndar, including listing identifiers, pricing, location details, room counts, amenities, building features, and media assets. It is designed for teams that need consistent listing records for analysis, enrichment, reporting, or operational workflows. https://www.quintoandar.com.br is one of Brazil's best-known real estate platforms, making it a valuable source for tracking rental and sale inventory across major cities. The actor automates repetitive collection work so you can avoid manual searches and exports. Each run is built to deliver repeatable, ready-to-use JSON output that saves time across research and data pipelines.

Why Use This Actor

• Market research and analytics: Track asking prices, listing mix, neighborhood coverage, and amenity trends across cities and segments.
• Product and content teams: Build localized pages, comparison content, or housing datasets with structured listing, pricing, and location information.
• Developers and data engineering pipelines: Feed warehouses, dashboards, ETL jobs, and downstream APIs with normalized JSON records.
• Lead generation and enrichment: Identify active listings that match target neighborhoods, price bands, property types, or lifestyle filters.
• Monitoring and competitive tracking: Watch market changes over time, including shifts in availability, furnishing preferences, transit proximity, and building features.

Input Parameters

Provide any combination of URLs, queries, and filters…

Parameter	Type	Description	Default
deal_type	string	Choose which market to collect from. Allowed values: sale, rent.	sale
sort_by	string	Controls result ordering before collection. Allowed values: closest, most_relevant, most_recent, lowest_price, highest_price.	most_relevant
city	string	City slug to search. Allowed values: sao-paulo-sp-brasil (Sao Paulo), rio-de-janeiro-rj-brasil (Rio de Janeiro), belo-horizonte-mg-brasil (Belo Horizonte), porto-alegre-rs-brasil (Porto Alegre), brasilia-df-brasil (Brasilia), curitiba-pr-brasil (Curitiba), goiania-go-brasil (Goiania), campinas-sp-brasil (Campinas), canoas-rs-brasil (Canoas), guarulhos-sp-brasil (Guarulhos), jundiai-sp-brasil (Jundiai), nova-lima-mg-brasil (Nova Lima), novo-hamburgo-rs-brasil (Novo Hamburgo), niteroi-rj-brasil (Niteroi), osasco-sp-brasil (Osasco), santo-andre-sp-brasil (Santo Andre), sao-bernardo-do-campo-sp-brasil (Sao Bernardo do Campo), sao-caetano-do-sul-sp-brasil (Sao Caetano do Sul), barueri-sp-brasil (Barueri), sao-leopoldo-rs-brasil (Sao Leopoldo), florianopolis-sc-brasil (Florianopolis), sao-jose-sc-brasil (Sao Jose), palhoca-sc-brasil (Palhoca), contagem-mg-brasil (Contagem), taboao-da-serra-sp-brasil (Taboao da Serra), diadema-sp-brasil (Diadema), sao-jose-dos-pinhais-pr-brasil (Sao Jose dos Pinhais), varzea-paulista-sp-brasil (Varzea Paulista), pinhais-pr-brasil (Pinhais), santana-de-parnaiba-sp-brasil (Santana de Parnaiba), santos-sp-brasil (Santos), recife-pe-brasil (Recife), salvador-ba-brasil (Salvador), mogi-das-cruzes-sp-brasil (Mogi das Cruzes), sao-jose-dos-campos-sp-brasil (Sao Jose dos Campos), cotia-sp-brasil (Cotia), vitoria-es-brasil (Vitoria), ribeirao-preto-sp-brasil (Ribeirao Preto), sorocaba-sp-brasil (Sorocaba), sao-jose-do-rio-preto-sp-brasil (Sao Jose do Rio Preto), uberlandia-mg-brasil (Uberlandia), maua-sp-brasil (Maua), belem-pa-brasil (Belem), fortaleza-ce-brasil (Fortaleza), manaus-am-brasil (Manaus), valinhos-sp-brasil (Valinhos), vinhedo-sp-brasil (Vinhedo), indaiatuba-sp-brasil (Indaiatuba), nova-iguacu-rj-brasil (Nova Iguacu), americana-sp-brasil (Americana), hortolandia-sp-brasil (Hortolandia), paulinia-sp-brasil (Paulinia), praia-grande-sp-brasil (Praia Grande), guaruja-sp-brasil (Guaruja), carapicuiba-sp-brasil (Carapicuiba), votorantim-sp-brasil (Votorantim), sao-vicente-sp-brasil (Sao Vicente), duque-de-caxias-rj-brasil (Duque de Caxias), sao-goncalo-rj-brasil (Sao Goncalo), vila-velha-es-brasil (Vila Velha), betim-mg-brasil (Betim), aparecida-de-goiania-go-brasil (Aparecida de Goiania), suzano-sp-brasil (Suzano), itaquaquecetuba-sp-brasil (Itaquaquecetuba), sumare-sp-brasil (Sumare), embu-das-artes-sp-brasil (Embu das Artes), ferraz-de-vasconcelos-sp-brasil (Ferraz de Vasconcelos), poa-sp-brasil (Poa), gravatai-rs-brasil (Gravatai), viamao-rs-brasil (Viamao), alvorada-rs-brasil (Alvorada), jaboatao-dos-guararapes-pe-brasil (Jaboatao dos Guararapes), belford-roxo-rj-brasil (Belford Roxo), nilopolis-rj-brasil (Nilopolis), mesquita-rj-brasil (Mesquita), taubate-sp-brasil (Taubate), jacarei-sp-brasil (Jacarei), ribeirao-das-neves-mg-brasil (Ribeirao das Neves), ribeirao-pires-sp-brasil (Ribeirao Pires), brumadinho-mg-brasil (Brumadinho), itabirito-mg-brasil (Itabirito), lagoa-santa-mg-brasil (Lagoa Santa), sabara-mg-brasil (Sabara), vespasiano-mg-brasil (Vespasiano), rio-acima-mg-brasil (Rio Acima), santa-luzia-mg-brasil (Santa Luzia), marica-rj-brasil (Marica), cabo-frio-rj-brasil (Cabo Frio).	–
neighborhood	string	Optional neighborhood name to narrow the search within the selected city, such as Pinheiros or Jardim Paulista.	–
property_type	array[string]	Property categories to include. Allowed values: apartment, house, condominium, studio. Leave empty to include all supported property types.	–
min_bedroom	string	Minimum bedroom count. Allowed values: 1, 2, 3, 4, meaning 1+ through 4+ bedrooms.	–
min_bathroom	string	Minimum bathroom count. Allowed values: 1, 2, 3, 4, meaning 1+ through 4+ bathrooms.	–
min_parking	string	Minimum parking spaces. Allowed values: 0, 1, 2, 3, meaning 0+ through 3+ spaces.	–
min_price	integer	Lowest price to include in the results.	–
max_price	integer	Highest price to include in the results.	–
min_sqm	integer	Minimum usable area in square meters.	–
max_sqm	integer	Maximum usable area in square meters.	–
amenities	array[string]	In-home features to require. Allowed values: penthouse_apartment, air_conditioning, bathtub, shower_enclosure, barbecue_grill, gas_shower, walk_in_closet, garden_private_outdoor_area, new_or_renovated, private_pool, single_house_on_the_property, laundry_sink, television, kitchen_utensils, ceiling_fan.	–
condo_amenities	array[string]	Shared building features to require. Allowed values: gym, green_area, playroom, barbecue_area, elevator, laundry_room, swimming_pool, playground, 24_hour_concierge, sports_court, party_room, game_room, sauna.	–
furnished	string	Furnishing preference. Allowed values: all, furnished, unfurnished.	all
pets_allowed	boolean	When enabled, keeps only pet-friendly rental listings. It does not change sale searches.	false
near_transit	boolean	When enabled, keeps only listings marked as near public transit.	false
limit	integer	Maximum number of listings to save. Leave empty to collect all matching results for the configured search.	–
maximize_coverage	boolean	When enabled, broad searches aim to collect a more complete set of matching listings.	true

Example Inputs

Scenario: Broad sale search in Sao Paulo

{
  "deal_type": "sale",
  "city": "sao-paulo-sp-brasil",
  "sort_by": "most_recent",
  "property_type": ["apartment"],
  "max_price": 1500000,
  "limit": 150
}

Scenario: Furnished rental near transit in Jardim Paulista

{
  "deal_type": "rent",
  "city": "sao-paulo-sp-brasil",
  "neighborhood": "Jardim Paulista",
  "furnished": "furnished",
  "near_transit": true,
  "pets_allowed": true,
  "condo_amenities": ["gym", "elevator"],
  "limit": 75
}

Scenario: Family-focused house search in Campinas

{
  "deal_type": "sale",
  "city": "campinas-sp-brasil",
  "property_type": ["house", "condominium"],
  "min_bedroom": "3",
  "min_bathroom": "2",
  "min_parking": "2",
  "min_sqm": 120,
  "limit": 100
}

Output

6.1 Output destination

The actor writes results to an Apify dataset as JSON records. And the dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs without post-processing.

6.2 Record envelope (all items)

Each saved item is a normalized real estate listing record:

• record_type (string, required): Stable discriminator. Current value: property_listing.
• record_id (string, required): Stable QuintoAndar listing identifier.
• source_context (object, required): Source URL, source domain, seed, page, and external IDs.
• entity (object, required): Main listing title, description, public URL, and source identifiers.
• listing (object, required): Deal type, listing status, publication history, and short source descriptions.

Recommended idempotency key: record_type + ":" + record_id

If the same listing appears in multiple runs or search combinations, use this key for deduplication and upserts.

6.3 Example

{
  "record_type": "property_listing",
  "record_id": "895116186",
  "source_context": {
    "source_url": "https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil",
    "source_name": "QuintoAndar",
    "source_domain": "quintoandar.com.br",
    "page_index": 1,
    "seed": {
      "id": "c0cb59c07f0d",
      "type": "location",
      "value": "sao-paulo-sp-brasil"
    },
    "external_ids": {
      "listing_id": "895116186"
    }
  },
  "entity": {
    "title": "Casa na Lapa com 6 quartos disponível para compra.",
    "description": "Casa na Lapa com 6 quartos disponível para compra.",
    "url": "https://www.quintoandar.com.br/imovel/895116186",
    "external_ids": {
      "listing_id": "895116186"
    }
  },
  "listing": {
    "listing_id": "895116186",
    "deal_type": "sale",
    "transaction_type": "sale",
    "short_descriptions": {
      "sale": "Casa na Lapa com 6 quartos disponível para compra."
    }
  },
  "pricing": {
    "primary_price": 2300000,
    "currency": "BRL",
    "rent_price": 9942,
    "sale_price": 2300000,
    "total_cost": 12281,
    "iptu_plus_condo_fee": 1917,
    "estimated_yield": 0.0034,
    "yield_strategy": "calculator"
  },
  "availability": {
    "visit_status": "accept_new",
    "for_rent": true,
    "for_sale": true,
    "is_primary_market": false,
    "is_secondary_house": false,
    "active_special_conditions": [
      "Exclusivity"
    ]
  },
  "location": {
    "label": "Lapa, São Paulo, SP",
    "street": "Rua Guararapes",
    "neighborhood": "Lapa",
    "city": "São Paulo",
    "state_code": "SP",
    "region_name": "Lapa"
  },
  "media": {
    "cover_image": {
      "url": "original895116186-722.86017859647941000485522.jpg",
      "cover": true
    },
    "images": [
      {
        "url": "original895116186-722.86017859647941000485522.jpg",
        "cover": true
      },
      {
        "url": "original895116186-295.9663141414039IMG8196.JPG",
        "caption": "Cozinha"
      }
    ]
  },
  "property": {
    "property_type": "casa",
    "rooms": {
      "bedrooms": 6,
      "bathrooms": 4,
      "suites": 1,
      "parking_spaces": 6
    },
    "area": {
      "usable_area": 521
    },
    "features": {
      "amenities": [
        "vista_livre",
        "banheira_de_hidromassagem",
        "quintal"
      ],
      "building_installations": [
        "SALAO_DE_FESTAS",
        "AREA_VERDE",
        "PERTO_DE_METRO_OU_TREM"
      ],
      "listing_tags": [
        "BUY_RENTED"
      ],
      "score_match_tags": [
        "SAME_CITY_MATCH"
      ]
    },
    "is_furnished": false
  },
  "attributes": {
    "source_specific": {
      "quintoandar": {
        "detail": {
          "url": "https://www.quintoandar.com.br/imovel/895116186/comprar/casa-6-quartos-lapa-sao-paulo",
          "display_id": "2416186",
          "places_nearby": [
            {
              "name": "Colégio Adventista da Lapa",
              "type": "SCHOOL",
              "slug": "colegio-adventista-da-lapa-lapa-sao-paulo-sp"
            }
          ]
        }
      }
    }
  }
}

Field reference

• record_type (string, required): Stable discriminator. Current value is property_listing.
• record_id (string, required): Stable QuintoAndar listing identifier.
• source_context.source_url (string, required): Search or listing URL where the record was discovered.
• source_context.source_name (string, optional): Source label, usually QuintoAndar.
• source_context.source_domain (string, optional): Source domain.
• source_context.page_index (number, optional): Results page number.
• source_context.seed (object, optional): Originating seed id, type, and value.
• source_context.external_ids (object, optional): Listing, external, legacy, source, and provider IDs when available.
• entity.title (string, optional): Listing title.
• entity.description (string, optional): Listing description.
• entity.url (string, optional): Public listing URL.
• entity.external_ids (object, optional): Listing identifiers repeated with the entity for downstream joins.
• listing.listing_id (string, optional): Source listing ID.
• listing.deal_type (string, optional): Deal mode, such as sale or rent.
• listing.transaction_type (string, optional): Transaction mode from the source.
• listing.listing_type (string, optional): Source listing type when provided.
• listing.listing_status (string, optional): Source listing status when provided.
• listing.property_status (string, optional): Construction or property status.
• listing.history (object, optional): Published, created, and updated timestamps when available.
• listing.short_descriptions (object, optional): Short sale or rent descriptions from QuintoAndar.
• pricing (object, optional): Primary price, rent, sale price, fees, tax, guarantee, yield, and source offer details.
• availability (object, optional): Visit status, price display, rent/sale flags, exchange, resale, and special conditions.
• location (object, optional): Address, neighborhood, city, state, postal code, coordinates, and geocoding context.
• property (object, optional): Property type, rooms, area, amenities, building features, furnishing, condominium, development, and unit options.
• media (object, optional): Cover image, images, videos, logos, and related media metadata.
• relationships (object, optional): Seller, advertiser, developer, and linked entity details.
• contact_details (object, optional): Public phones, WhatsApp, and contact fields exposed by the source.
• attributes.source_specific (object, optional): Rich QuintoAndar detail objects, enrichment-only fields, and source-specific structures.
• attributes.source_data (object, optional): Meaningful source fields that were not already mapped into a normalized group.
• attributes.additional_attributes (object, optional): Additional normalized values retained when they do not fit a stronger group.

Data guarantees & handling

• Best-effort extraction: fields may vary by region, session, availability, and site experiments.
• Optional fields: null-check in downstream code.
• Deduplication: recommend record_type + ":" + record_id.

How to Run on Apify

1. Open the Actor in Apify Console.
2. Configure your search parameters, including deal type, city, and any optional filters such as neighborhood, price, size, or amenities.
3. Set the maximum number of outputs to collect.
4. Click Start and wait for the run to finish.
5. Download results in JSON, CSV, Excel, or other supported formats.

Scheduling & Automation

Scheduling

Automated Data Collection

Schedule recurring runs to keep your QuintoAndar dataset current without manual work. This is useful for market tracking, recurring exports, and any workflow that depends on fresh listing data.

• Navigate to Schedules in Apify Console
• Create a new schedule (daily, weekly, or custom cron)
• Configure input parameters
• Enable notifications for run completion
• Optional: add webhooks for automated processing

Integration Options

• Webhooks: Trigger downstream actions when a run completes
• Zapier: Connect to 5,000+ apps without coding
• Make (Integromat): Build multi-step automation workflows
• Google Sheets: Export results to a spreadsheet
• Slack/Discord: Receive notifications and summaries
• Email: Send automated reports via email

Performance

• Small runs (< 1,000 outputs): ~2-3 minutes
• Medium runs (1,000-5,000 outputs): ~5-15 minutes
• Large runs (5,000+ outputs): ~15-30 minutes

Execution time varies based on filters, result volume, and how much information is returned per record.

Compliance & Ethics

Responsible Data Collection

This actor collects publicly available property listing information from https://www.quintoandar.com.br for legitimate business purposes, including:

• Real estate research and market analysis
• Listing monitoring and reporting
• Data enrichment and internal analytics

You are responsible for ensuring your use of the collected data complies with applicable laws, regulations, platform terms, and internal policies. This section is informational and not legal advice.

Best Practices

• Use collected data in accordance with applicable laws, regulations, and the target site's terms
• Respect individual privacy and personal information
• Use data responsibly and avoid disruptive or excessive collection
• Do not use this actor for spamming, harassment, or other harmful purposes
• Follow relevant data protection requirements where applicable (e.g., GDPR, CCPA)

Support

For help, use the Issues tab or support section on the actor page in Apify Console. Include the input you used with sensitive values redacted, the run ID, a short description of expected versus actual behavior, and, if helpful, a small output sample.