{ "openapi": "3.0.1", "info": { "title": "ZAP Imóveis Scraper [Only $1/1K💰] | Brazil Property Leads", "description": "Extract ZAP Imóveis (zapimoveis.com.br) sale and rental listings as structured JSON: BRL price, condomínio, IPTU, beds, baths, area in m², address and GPS, photos, and the agency plus CRECI. Filter by city, price and type. No login.", "version": "0.0", "x-build-id": "qFNE1whAcpctNH7Ag" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~zapimoveis-com-br-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-zapimoveis-com-br-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/ahmed_jasarevic~zapimoveis-com-br-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-zapimoveis-com-br-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/ahmed_jasarevic~zapimoveis-com-br-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-zapimoveis-com-br-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": { "searchUrl": { "title": "Search URL (optional)", "type": "string", "description": "Paste any ZAP Imóveis search results URL copied from your browser. When set, the URL defines the whole search - transaction (venda/aluguel), property type, city/neighborhood/zone, result page and any price/room filters it carries - and the filter fields below are ignored. Examples: https://www.zapimoveis.com.br/venda/apartamentos/sp+sao-paulo/ , https://www.zapimoveis.com.br/aluguel/casas/rj+rio-de-janeiro/?precoMaximo=5000&quartos=2 , https://www.zapimoveis.com.br/venda/cobertura/sp+sao-paulo+zona-sul+moema/" }, "business": { "title": "Business type", "type": "array", "description": "SALE = venda (for sale), RENTAL = aluguel (for rent).", "items": { "type": "string", "enum": [ "SALE", "RENTAL" ], "enumTitles": [ "For sale (Venda)", "For rent (Aluguel)" ] }, "default": [ "SALE" ] }, "listingType": { "title": "Listing type", "type": "array", "description": "USED = resale / standard rental, DEVELOPMENT = lançamentos (new developments).", "items": { "type": "string", "enum": [ "USED", "DEVELOPMENT" ], "enumTitles": [ "Standard listings (Padrão)", "New developments (Lançamentos)" ] }, "default": [ "USED" ] }, "usageTypes": { "title": "Usage type", "type": "array", "description": "RESIDENTIAL for homes and apartments, COMMERCIAL for offices, retail and warehouses. Commercial property types (office, store, warehouse, whole building, hotel, corporate floor...) return no results unless COMMERCIAL is selected.", "items": { "type": "string", "enum": [ "RESIDENTIAL", "COMMERCIAL" ], "enumTitles": [ "Residential", "Commercial (offices, retail, warehouses)" ] }, "default": [ "RESIDENTIAL" ] }, "unitTypes": { "title": "Property (unit) types", "type": "array", "description": "Optional filter. Pick one or more property types from the list, or leave empty for all types. Studio and corporate floor are handled as subtypes automatically.", "items": { "type": "string", "enum": [ "APARTMENT", "HOME", "CONDOMINIUM", "VILLAGE_HOUSE", "PENTHOUSE", "FLAT", "LOFT", "KITNET", "STUDIO", "TWO_STORY_HOUSE", "RESIDENTIAL_ALLOTMENT_LAND", "COMMERCIAL_ALLOTMENT_LAND", "FARM", "OFFICE", "COMMERCIAL_PROPERTY", "BUSINESS", "COMMERCIAL_BUILDING", "SHED_DEPOSIT_WAREHOUSE", "PARKING_SPACE", "HOTEL", "FLOOR" ], "enumTitles": [ "Apartment (Apartamento)", "House (Casa)", "House in gated community (Casa de condomínio)", "Village house (Casa de vila)", "Penthouse (Cobertura)", "Flat", "Loft", "Kitnet", "Studio", "Two-story house (Sobrado)", "Residential land / lot (Terreno / Lote)", "Commercial land / lot (Terreno comercial)", "Farm / country estate (Sítio / Fazenda / Chácara)", "Office room (Sala comercial)", "Commercial suite (Conjunto comercial)", "Store / business point (Loja / Ponto comercial)", "Whole commercial building (Prédio comercial)", "Warehouse / shed (Galpão)", "Garage / parking space (Vaga / Garagem)", "Hotel / inn (Hotel / Pousada)", "Corporate floor (Andar corporativo)" ] } }, "cities": { "title": "Cities", "type": "array", "description": "City names as the API expects them (accented full names work best), e.g. \"São Paulo\", \"Rio de Janeiro\", \"Belo Horizonte\". Ignored when a Search URL is set.", "items": { "type": "string" }, "default": [ "São Paulo" ] }, "state": { "title": "State (UF)", "enum": [ "", "SP", "RJ", "MG", "RS", "PR", "SC", "BA", "DF", "GO", "PE", "CE", "ES", "PA", "MA", "MT", "MS", "PB", "RN", "AL", "PI", "SE", "AM", "RO", "TO", "AC", "AP", "RR" ], "type": "string", "description": "Optional 2-letter state code to narrow the search. Leave as \"Any state\" to search the whole country for each city. Ignored when a Search URL is set." }, "maxListings": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Hard cap on the total number of listings pushed to the dataset. The Actor keeps paging through the results until it reaches this number, or until the search runs out of results.", "default": 100 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler. A Brazilian residential proxy is recommended for reliable results." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }