{ "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": "dVkzIWwroR6cY4r84" }, "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": "Select `sale` for homes listed to buy, or `rent` for homes listed to lease.", "default": "sale" }, "city": { "title": "Choose a City", "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": "Select the city where listings should be collected. The city also provides the context for any neighborhood name you enter below." }, "neighborhood": { "title": "Add a Neighborhood", "type": "string", "description": "Optionally enter a bairro or neighborhood name to narrow the search within the selected city. For example, choose Rio de Janeiro as the city and enter `Copacabana` to focus on that neighborhood." }, "sort_by": { "title": "Sort Listings By", "enum": [ "closest", "most_relevant", "most_recent", "lowest_price", "highest_price" ], "type": "string", "description": "Select the ordering strategy for matching listings. Relevance is a balanced default, while recency and price sorting are useful for market monitoring or budget-focused workflows.", "default": "most_relevant" }, "property_type": { "title": "Choose Property Types", "uniqueItems": true, "type": "array", "description": "Leave empty to include every supported property type. Select multiple values to keep only listings that match those categories.", "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 Minimum Bedrooms", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Choose the fewest bedrooms a listing must have. For example, `2+` keeps homes with at least 2 bedrooms." }, "min_bathroom": { "title": "Set Minimum Bathrooms", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Choose the fewest bathrooms a listing must have. For example, `2+` keeps homes with at least 2 bathrooms." }, "min_parking": { "title": "Set Minimum Parking Spaces", "enum": [ "0", "1", "2", "3" ], "type": "string", "description": "Choose the fewest parking spaces a listing must have. For example, `1+` keeps homes with at least 1 parking space." }, "min_price": { "title": "Set a Minimum Price", "minimum": 0, "type": "integer", "description": "Enter the lowest listing price to include. Use the same currency convention shown by QuintoAndar for the selected market." }, "max_price": { "title": "Set a Maximum Price", "minimum": 0, "type": "integer", "description": "Enter the highest listing price to include. Use this to cap expensive outliers or keep a sample focused on a target budget band." }, "min_sqm": { "title": "Set Minimum Area", "minimum": 0, "type": "integer", "description": "Enter the smallest usable area to include, in square meters. For example, `35` keeps listings with at least 35 sqm." }, "max_sqm": { "title": "Set Maximum Area", "minimum": 0, "type": "integer", "description": "Enter the largest usable area to include, in square meters. Use this when you want compact listings or a bounded comparison set." }, "amenities": { "title": "Choose Home Amenities", "uniqueItems": true, "type": "array", "description": "Leave empty to include all homes regardless of amenities. Select one or more options to keep listings that match the chosen in-home 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 empty to include buildings with any amenity set. Select one or more options to keep listings in buildings that include 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": "Choose 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": "Require Pet-Friendly Rentals", "type": "boolean", "description": "Enable this to keep only rental listings marked as allowing pets. It is intended for rental searches and should be left off when pet policy is not part of your criteria.", "default": false }, "near_transit": { "title": "Require Nearby Transit", "type": "boolean", "description": "Enable this to keep only listings marked as near public transit when that signal is available for the selected search.", "default": false }, "limit": { "title": "Set Maximum Saved Listings", "minimum": 1, "type": "integer", "description": "Enter the maximum number of listings to save. Leave empty when you want the run to collect all available matching results within the selected scope." }, "enrich_data": { "title": "Collect Richer Property Listing Details", "type": "boolean", "description": "Enable this when completeness matters more than speed. Leave it off for faster runs when the lightweight listing fields are sufficient for your workflow.", "default": false }, "maximize_coverage": { "title": "Maximize Coverage for Broad Searches", "type": "boolean", "description": "Enable this to collect a broader set of matching listings for large searches. Keep it on for comprehensive runs, or turn it off when you only need a faster sample from the selected criteria.", "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 } } } } } } } } } }