# QuintoAndar Scraper | $1.5 / 1k | Fast & Reliable (`fatihtahta/quintoandar-scraper`) Actor Extract structured Brazil property listings from QuintoAndar Imoveis with pricing, locations, seller details, media assets, and contact data. Built for enterprise-grade Brazil real estate intelligence, listing monitoring, lead enrichment and automated analytics pipelines. - **URL**: https://apify.com/fatihtahta/quintoandar-scraper.md - **Developed by:** [Fatih Tahta](https://apify.com/fatihtahta) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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](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 ```json { "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 ```json { "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 ```json { "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 record should be treated as having these stable identifiers for downstream normalization and storage: - **type** *(string, required)*: Listing category. Typical values are `sale_listing` and `rental_listing`. - **id** *(number, required)*: Numeric listing identifier. - **url** *(string, required)*: Public listing URL. Recommended idempotency key: `type + ":" + id` If the same listing appears in multiple runs or search combinations, use this key for deduplication and upserts. #### 6.3 Examples ##### Example: sale listing (`type = "sale_listing"`) ```json { "type": "sale_listing", "id": 893287484, "url": "https://www.quintoandar.com.br/imovel/893287484", "identity": { "id": "893287484", "fingerprint": "b2f43b05bbc118511247" }, "source_context": { "source_url": "https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil", "page_index": 1, "seed": { "id": "c0cb59c07f0d", "type": "location", "value": "sao-paulo-sp-brasil" } }, "content": { "title": "Comprar apartamento na Vila Andrade com 3 quartos, piscina e churrasqueira no condominio.", "description": "Comprar apartamento na Vila Andrade com 3 quartos, piscina e churrasqueira no condominio.", "short_sale_description": "Comprar apartamento na Vila Andrade com 3 quartos, piscina e churrasqueira no condominio." }, "pricing": { "amount": 1200000, "currency": "BRL", "rent_amount": 4112, "sale_amount": 1200000, "total_cost": 8138, "iptu_plus_condominium": 3867, "yield": 0.0023, "yield_strategy": "calculator" }, "availability": { "visit_status": "accept_new", "for_rent": true, "for_sale": false, "is_primary_market": false, "is_secondary_house": false }, "location": { "label": "Vila Andrade, Sao Paulo, SP", "street": "Rua Germano Ulbrich", "neighborhood": "Vila Andrade", "city": "Sao Paulo", "state_code": "SP", "region_name": "Panamby" }, "media": { "cover_image": { "url": "893287484-156.7189085278339WhatsAppImage20210407at17.34.5211.jpeg", "cover": true }, "images": [ { "url": "893287484-156.7189085278339WhatsAppImage20210407at17.34.5211.jpeg", "cover": true }, { "url": "893287484-785.2715333777837WhatsAppImage20210407at17.37.548.jpeg", "caption": "Cozinha" }, { "url": "893287484-994.551529881029WhatsAppImage20210407at17.34.5224.jpeg", "caption": "Sacada" } ] }, "attributes": { "business": "sale", "property_type": "apartamento", "amenities": [ "vista_livre", "tomadas_novas", "cortinas_black_out", "espelho_no_banheiro", "armarios_nos_banheiros", "varal_de_roupas", "box", "fogao_incluso", "sol_da_tarde", "chuveiro_a_gas", "pode_ter_animais_de_estimacao", "tanque", "apartamento_cobertura", "energia", "varanda", "rua_silenciosa", "armarios_embutidos_no_quarto", "banheiro_de_servico", "sol_da_manha", "armarios_na_cozinha", "luminosidade_natural", "quarto_de_servico", "varanda_gourmet" ], "installations": [ "SALAO_DE_FESTAS", "ACADEMIA", "CHURRASQUEIRA", "GAS_ENCANADO", "QUADRA_ESPORTIVA", "PISCINA", "PERTO_DE_METRO_OU_TREM", "PLAYGROUND" ], "listing_tags": [ "NEW_AD", "SALE_GOOD_PRICE" ], "is_furnished": false, "score_match_tags": [ "SAME_CITY_MATCH" ], "matched_queries": [ "GEO_LOCATION_EXACT_MATCH_CITY_0" ], "rooms": { "bedrooms": 3, "bathrooms": 5, "suites": 3, "parking_spaces": 3 }, "area": { "usable_area": 403 } } } ``` ##### Example: rental listing (`type = "rental_listing"`) ```json { "type": "rental_listing", "id": 893885607, "url": "https://www.quintoandar.com.br/imovel/893885607", "identity": { "id": "893885607", "fingerprint": "582629d6b5adafe6d59e" }, "source_context": { "source_url": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil", "page_index": 1, "seed": { "id": "c0cb59c07f0d", "type": "location", "value": "sao-paulo-sp-brasil" } }, "content": { "title": "Apartamento mobiliado com 3 quartos para alugar no Jardim Paulista.", "description": "Apartamento mobiliado com 3 quartos para alugar no Jardim Paulista.", "short_rent_description": "Apartamento mobiliado com 3 quartos para alugar no Jardim Paulista." }, "pricing": { "amount": 21000, "currency": "BRL", "rent_amount": 21000, "sale_amount": 3800000, "total_cost": 25377, "iptu_plus_condominium": 3567, "yield": 0.0042, "yield_strategy": "contract" }, "availability": { "visit_status": "accept_new", "for_rent": true, "for_sale": false, "is_primary_market": false, "is_secondary_house": false, "active_special_conditions": [ "Exclusivity" ] }, "location": { "label": "Jardim Paulista, Sao Paulo, SP", "street": "Alameda Jau", "neighborhood": "Jardim Paulista", "city": "Sao Paulo", "state_code": "SP", "region_name": "Jardim Paulista" }, "media": { "cover_image": { "url": "893885607-134.05138198451237AlamedaJau18172.jpg", "cover": true }, "images": [ { "url": "893885607-134.05138198451237AlamedaJau18172.jpg", "cover": true }, { "url": "893885607-972.835934512894AlamedaJau18173.jpg", "caption": "Sala" }, { "url": "893885607-452.22429938328355AlamedaJau181733.jpg", "caption": "Cozinha" } ] }, "attributes": { "business": "rent", "property_type": "apartamento", "amenities": [ "vista_livre", "cooktop", "quartos_e_corredores_com_portas_amplas", "armarios_nos_banheiros", "cozinha_americana", "ar_condicionado", "box", "cama_de_casal", "chuveiro_a_gas", "area_de_servico", "pode_ter_animais_de_estimacao", "tanque", "closet", "rua_silenciosa", "armarios_embutidos_no_quarto", "geladeira_incluso", "sol_da_manha", "armarios_na_cozinha", "luminosidade_natural" ], "installations": [ "SALAO_DE_FESTAS", "CORRIMAO", "ACADEMIA", "AREA_VERDE", "VAGA_DE_GARAGEM_ACESSIVEL", "PERTO_DE_METRO_OU_TREM", "PLAYGROUND", "RAMPAS_DE_ACESSO" ], "listing_tags": [ "RENT_ON_TERMINATION", "RENT_ON_TERMINATION_RENTFLOW_ENABLED" ], "is_furnished": true, "score_match_tags": [ "SAME_CITY_MATCH" ], "matched_queries": [ "GEO_LOCATION_EXACT_MATCH_CITY_0" ], "rooms": { "bedrooms": 3, "bathrooms": 3, "suites": 3, "parking_spaces": 2 }, "area": { "usable_area": 250 } } } ``` ### Field reference #### Sale listing fields (`type = "sale_listing"`) - **type** *(string, required)*: Normalized record type for sale listings. - **id** *(number, required)*: Numeric listing identifier. - **url** *(string, required)*: Public listing URL. - **identity.id** *(string, required)*: Source listing identifier as provided by the platform. - **identity.fingerprint** *(string, optional)*: Stable fingerprint for record matching. - **source\_context.source\_url** *(string, required)*: Search page where the record was discovered. - **source\_context.page\_index** *(number, optional)*: Results page number. - **source\_context.seed.id** *(string, optional)*: Seed identifier for the originating search. - **source\_context.seed.type** *(string, optional)*: Seed category, such as `location`. - **source\_context.seed.value** *(string, optional)*: Seed value used for the run. - **content.title** *(string, required)*: Listing title. - **content.description** *(string, optional)*: Full listing description. - **content.short\_sale\_description** *(string, optional)*: Short sale-oriented summary. - **pricing.amount** *(number, optional)*: Primary displayed price. - **pricing.currency** *(string, optional)*: Currency code. - **pricing.rent\_amount** *(number, optional)*: Rental amount when shown alongside sale information. - **pricing.sale\_amount** *(number, optional)*: Sale amount. - **pricing.total\_cost** *(number, optional)*: Total monthly cost when available. - **pricing.iptu\_plus\_condominium** *(number, optional)*: Combined tax and condominium cost. - **pricing.yield** *(number, optional)*: Yield metric when available. - **pricing.yield\_strategy** *(string, optional)*: Yield calculation label. - **availability.visit\_status** *(string, optional)*: Visit booking status. - **availability.for\_rent** *(boolean, optional)*: Whether the listing is available for rent. - **availability.for\_sale** *(boolean, optional)*: Whether the listing is available for sale. - **availability.is\_primary\_market** *(boolean, optional)*: Whether the property is a primary-market listing. - **availability.is\_secondary\_house** *(boolean, optional)*: Whether the property is flagged as a secondary house. - **location.label** *(string, optional)*: Full location label. - **location.street** *(string, optional)*: Street name. - **location.neighborhood** *(string, optional)*: Neighborhood name. - **location.city** *(string, optional)*: City name. - **location.state\_code** *(string, optional)*: State abbreviation. - **location.region\_name** *(string, optional)*: Broader local region label. - **media.cover\_image.url** *(string, optional)*: Cover image URL or asset name. - **media.cover\_image.cover** *(boolean, optional)*: Whether the image is the cover image. - **media.images\[]** *(array, optional)*: Listing image collection. - **media.images\[].url** *(string, optional)*: Image URL or asset name. - **media.images\[].cover** *(boolean, optional)*: Whether the image is marked as the cover. - **media.images\[].caption** *(string, optional)*: Image caption. - **attributes.business** *(string, required)*: Business mode. For this record type, typically `sale`. - **attributes.property\_type** *(string, optional)*: Property category label. - **attributes.amenities\[]** *(array\[string], optional)*: In-home features. - **attributes.installations\[]** *(array\[string], optional)*: Shared building features. - **attributes.listing\_tags\[]** *(array\[string], optional)*: Listing-level tags. - **attributes.is\_furnished** *(boolean, optional)*: Furnishing flag. - **attributes.score\_match\_tags\[]** *(array\[string], optional)*: Match-scoring tags. - **attributes.matched\_queries\[]** *(array\[string], optional)*: Query or seed matches recorded for the listing. - **attributes.rooms.bedrooms** *(number, optional)*: Bedroom count. - **attributes.rooms.bathrooms** *(number, optional)*: Bathroom count. - **attributes.rooms.suites** *(number, optional)*: Suite count. - **attributes.rooms.parking\_spaces** *(number, optional)*: Parking space count. - **attributes.area.usable\_area** *(number, optional)*: Usable area in square meters. #### Rental listing fields (`type = "rental_listing"`) Rental records may also include the shared fields documented for `sale_listing`. - **type** *(string, required)*: Normalized record type for rental listings. - **id** *(number, required)*: Numeric listing identifier. - **url** *(string, required)*: Public listing URL. - **content.short\_rent\_description** *(string, optional)*: Short rental-oriented summary. - **availability.active\_special\_conditions\[]** *(array\[string], optional)*: Special rental conditions or badges shown on the listing. - **attributes.business** *(string, required)*: Business mode. For this record type, typically `rent`. ### 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 `type + ":" + 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 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. # Actor input Schema ## `deal_type` (type: `string`): Pick `sale` to see homes you can buy, or `rent` to see homes available for rent. ## `sort_by` (type: `string`): Choose whether to sort by distance, relevance, recency, or price. ## `city` (type: `string`): Pick the city for your search. The scraper will use this choice to pull listings from that location. ## `neighborhood` (type: `string`): Enter a neighborhood name to focus the search on that area. If the actor has a close match for the selected city, it will be used automatically. ## `property_type` (type: `array`): Leave this empty to include every supported property type, or choose one or more options to narrow the results. ## `min_bedroom` (type: `string`): Choose the fewest bedrooms a listing must have. For example, `2+` keeps homes with 2 or more bedrooms. ## `min_bathroom` (type: `string`): Choose the fewest bathrooms a listing must have. For example, `2+` keeps homes with 2 or more bathrooms. ## `min_parking` (type: `string`): Choose the fewest parking spaces a listing must have. For example, `1+` keeps homes with 1 or more parking spaces. ## `min_price` (type: `integer`): Enter the lowest price you want to include. For example, `400000` keeps listings priced at 400,000 and above. ## `max_price` (type: `integer`): Enter the highest price you want to include. For example, `3000000` keeps listings priced at 3,000,000 and below. ## `min_sqm` (type: `integer`): Enter the smallest usable area you want in square meters. For example, `35` keeps listings with 35 sqm or more. ## `max_sqm` (type: `integer`): Enter the largest usable area you want in square meters. For example, `100` keeps listings with 100 sqm or less. ## `amenities` (type: `array`): Leave this empty to include all homes, or choose one or more amenities to keep only listings with those features. ## `condo_amenities` (type: `array`): Leave this empty to include all buildings, or choose one or more amenities to keep only listings in buildings with those facilities. ## `furnished` (type: `string`): Select `all` to include every listing, `furnished` to keep only furnished homes, or `unfurnished` to keep only unfurnished homes. ## `pets_allowed` (type: `boolean`): Enable this to keep only rental listings that allow pets. This setting does not affect sale searches. ## `near_transit` (type: `boolean`): Enable this to keep only listings marked as being near public transit, when that option is available for the search. ## `limit` (type: `integer`): Enter the maximum number of listings to save from this run. Leave it empty to collect all available results for your search. ## `maximize_coverage` (type: `boolean`): Enable this to help the scraper gather more complete results when your search matches a large number of listings. ## Actor input object example ```json { "deal_type": "sale", "sort_by": "most_relevant", "city": "sao-paulo-sp-brasil", "furnished": "all", "pets_allowed": false, "near_transit": false, "limit": 100, "maximize_coverage": true } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "city": "sao-paulo-sp-brasil", "limit": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("fatihtahta/quintoandar-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "city": "sao-paulo-sp-brasil", "limit": 100, } # Run the Actor and wait for it to finish run = client.actor("fatihtahta/quintoandar-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "city": "sao-paulo-sp-brasil", "limit": 100 }' | apify call fatihtahta/quintoandar-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fatihtahta/quintoandar-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "QuintoAndar Scraper | $1.5 / 1k | Fast & Reliable", "description": "Extract structured Brazil property listings from QuintoAndar Imoveis with pricing, locations, seller details, media assets, and contact data. Built for enterprise-grade Brazil real estate intelligence, listing monitoring, lead enrichment and automated analytics pipelines.", "version": "1.0", "x-build-id": "pDt7US2juQqBt1Tci" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~quintoandar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-quintoandar-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~quintoandar-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-quintoandar-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~quintoandar-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-quintoandar-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": { "deal_type": { "title": "Choose Sale or Rental Listings", "enum": [ "sale", "rent" ], "type": "string", "description": "Pick `sale` to see homes you can buy, or `rent` to see homes available for rent.", "default": "sale" }, "sort_by": { "title": "Sort Results By", "enum": [ "closest", "most_relevant", "most_recent", "lowest_price", "highest_price" ], "type": "string", "description": "Choose whether to sort by distance, relevance, recency, or price.", "default": "most_relevant" }, "city": { "title": "Select a City to Search", "enum": [ "sao-paulo-sp-brasil", "rio-de-janeiro-rj-brasil", "belo-horizonte-mg-brasil", "porto-alegre-rs-brasil", "brasilia-df-brasil", "curitiba-pr-brasil", "goiania-go-brasil", "campinas-sp-brasil", "canoas-rs-brasil", "guarulhos-sp-brasil", "jundiai-sp-brasil", "nova-lima-mg-brasil", "novo-hamburgo-rs-brasil", "niteroi-rj-brasil", "osasco-sp-brasil", "santo-andre-sp-brasil", "sao-bernardo-do-campo-sp-brasil", "sao-caetano-do-sul-sp-brasil", "barueri-sp-brasil", "sao-leopoldo-rs-brasil", "florianopolis-sc-brasil", "sao-jose-sc-brasil", "palhoca-sc-brasil", "contagem-mg-brasil", "taboao-da-serra-sp-brasil", "diadema-sp-brasil", "sao-jose-dos-pinhais-pr-brasil", "varzea-paulista-sp-brasil", "pinhais-pr-brasil", "santana-de-parnaiba-sp-brasil", "santos-sp-brasil", "recife-pe-brasil", "salvador-ba-brasil", "mogi-das-cruzes-sp-brasil", "sao-jose-dos-campos-sp-brasil", "cotia-sp-brasil", "vitoria-es-brasil", "ribeirao-preto-sp-brasil", "sorocaba-sp-brasil", "sao-jose-do-rio-preto-sp-brasil", "uberlandia-mg-brasil", "maua-sp-brasil", "belem-pa-brasil", "fortaleza-ce-brasil", "manaus-am-brasil", "valinhos-sp-brasil", "vinhedo-sp-brasil", "indaiatuba-sp-brasil", "nova-iguacu-rj-brasil", "americana-sp-brasil", "hortolandia-sp-brasil", "paulinia-sp-brasil", "praia-grande-sp-brasil", "guaruja-sp-brasil", "carapicuiba-sp-brasil", "votorantim-sp-brasil", "sao-vicente-sp-brasil", "duque-de-caxias-rj-brasil", "sao-goncalo-rj-brasil", "vila-velha-es-brasil", "betim-mg-brasil", "aparecida-de-goiania-go-brasil", "suzano-sp-brasil", "itaquaquecetuba-sp-brasil", "sumare-sp-brasil", "embu-das-artes-sp-brasil", "ferraz-de-vasconcelos-sp-brasil", "poa-sp-brasil", "gravatai-rs-brasil", "viamao-rs-brasil", "alvorada-rs-brasil", "jaboatao-dos-guararapes-pe-brasil", "belford-roxo-rj-brasil", "nilopolis-rj-brasil", "mesquita-rj-brasil", "taubate-sp-brasil", "jacarei-sp-brasil", "ribeirao-das-neves-mg-brasil", "ribeirao-pires-sp-brasil", "brumadinho-mg-brasil", "itabirito-mg-brasil", "lagoa-santa-mg-brasil", "sabara-mg-brasil", "vespasiano-mg-brasil", "rio-acima-mg-brasil", "santa-luzia-mg-brasil", "marica-rj-brasil", "cabo-frio-rj-brasil" ], "type": "string", "description": "Pick the city for your search. The scraper will use this choice to pull listings from that location." }, "neighborhood": { "title": "(Optional) Add a neighborhood (bairro) if you want to narrow the search within the selected city. (eg. if you've selected Rio De Janeiro, you can write Copacabana)", "type": "string", "description": "Enter a neighborhood name to focus the search on that area. If the actor has a close match for the selected city, it will be used automatically." }, "property_type": { "title": "Select Property Types", "uniqueItems": true, "type": "array", "description": "Leave this empty to include every supported property type, or choose one or more options to narrow the results.", "items": { "type": "string", "enum": [ "apartment", "house", "condominium", "studio" ], "enumTitles": [ "🏠 Apartamento | Apartment", "🏠 Casa | House", "🏠 Casa de Condomínio | Condominium", "🏠 Kitnet/Studio | Studio apartment" ] } }, "min_bedroom": { "title": "Set a Minimum Bedroom Count", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Choose the fewest bedrooms a listing must have. For example, `2+` keeps homes with 2 or more bedrooms." }, "min_bathroom": { "title": "Set a Minimum Bathroom Count", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Choose the fewest bathrooms a listing must have. For example, `2+` keeps homes with 2 or more bathrooms." }, "min_parking": { "title": "Set a Minimum Parking Space Count", "enum": [ "0", "1", "2", "3" ], "type": "string", "description": "Choose the fewest parking spaces a listing must have. For example, `1+` keeps homes with 1 or more parking spaces." }, "min_price": { "title": "Set a Minimum Price", "minimum": 0, "type": "integer", "description": "Enter the lowest price you want to include. For example, `400000` keeps listings priced at 400,000 and above." }, "max_price": { "title": "Set a Maximum Price", "minimum": 0, "type": "integer", "description": "Enter the highest price you want to include. For example, `3000000` keeps listings priced at 3,000,000 and below." }, "min_sqm": { "title": "Set a Minimum Area (sqm)", "minimum": 0, "type": "integer", "description": "Enter the smallest usable area you want in square meters. For example, `35` keeps listings with 35 sqm or more." }, "max_sqm": { "title": "Set a Maximum Area (sqm)", "minimum": 0, "type": "integer", "description": "Enter the largest usable area you want in square meters. For example, `100` keeps listings with 100 sqm or less." }, "amenities": { "title": "Choose In-Home Amenities", "uniqueItems": true, "type": "array", "description": "Leave this empty to include all homes, or choose one or more amenities to keep only listings with those features.", "items": { "type": "string", "enum": [ "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" ], "enumTitles": [ "Apartamento cobertura | Penthouse apartment", "Ar condicionado | Air conditioning", "Banheira | Bathtub", "Box | Shower enclosure", "Churrasqueira | Barbecue grill", "Chuveiro a gás | Gas shower", "Closet | Walk-in closet", "Garden/Área privativa | Garden / Private outdoor area", "Novos ou reformados | New or renovated", "Piscina privativa | Private pool", "Somente uma casa no terreno | Single house on the property", "Tanque | Laundry sink", "Televisão | Television", "Utensílios de cozinha | Kitchen utensils", "Ventilador de teto | Ceiling fan" ] } }, "condo_amenities": { "title": "Choose Building Amenities", "uniqueItems": true, "type": "array", "description": "Leave this empty to include all buildings, or choose one or more amenities to keep only listings in buildings with those facilities.", "items": { "type": "string", "enum": [ "gym", "green_area", "playroom", "barbecue_area", "elevator", "laundry_room", "swimming_pool", "playground", "24_hour_concierge", "sports_court", "party_room", "game_room", "sauna" ], "enumTitles": [ "Academia | Gym", "Área verde | Green area", "Brinquedoteca | Playroom", "Churrasqueira | Barbecue area", "Elevador | Elevator", "Lavanderia | Laundry room", "Piscina | Swimming pool", "Playground | Playground", "Portaria 24h | 24-hour concierge", "Quadra esportiva | Sports court", "Salão de festas | Party room", "Salão de jogos | Game room", "Sauna | Sauna" ] } }, "furnished": { "title": "Select a Furnishing Preference", "enum": [ "all", "furnished", "unfurnished" ], "type": "string", "description": "Select `all` to include every listing, `furnished` to keep only furnished homes, or `unfurnished` to keep only unfurnished homes.", "default": "all" }, "pets_allowed": { "title": "Only Show Pet-Friendly Rentals", "type": "boolean", "description": "Enable this to keep only rental listings that allow pets. This setting does not affect sale searches.", "default": false }, "near_transit": { "title": "Only Show Listings Near Transit", "type": "boolean", "description": "Enable this to keep only listings marked as being near public transit, when that option is available for the search.", "default": false }, "limit": { "title": "Limit the Number of Saved Results", "minimum": 1, "type": "integer", "description": "Enter the maximum number of listings to save from this run. Leave it empty to collect all available results for your search." }, "maximize_coverage": { "title": "Maximize Coverage for Broad Searches", "type": "boolean", "description": "Enable this to help the scraper gather more complete results when your search matches a large number of listings.", "default": true } } }, "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 } } } } } } } } } } ```