{ "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 } } } } } } } } } }