{ "openapi": "3.0.1", "info": { "title": "Zap Imóveis Scraper | $1.5/1K — Listings, Prices, CRECI", "description": "Scrape Zap Imóveis for sale and rent by city or neighborhood: price, condo fee, IPTU, area, bedrooms, parking, address, coordinates, photos and the advertiser (name, CRECI, phone of agencies). $1.50 per 1,000 listings plus $0.005 per run, no proxy costs. Failed locations free. JSON, CSV, Excel, API.", "version": "0.1", "x-build-id": "t6mVxgQvqOfOpNFEd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gangary~zap-imoveis-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gangary-zap-imoveis-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/gangary~zap-imoveis-scraper/runs": { "post": { "operationId": "runs-sync-gangary-zap-imoveis-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/gangary~zap-imoveis-scraper/run-sync": { "post": { "operationId": "run-sync-gangary-zap-imoveis-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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "Neighborhoods or cities exactly as you would search them on Zap Imóveis, e.g. \"Pinheiros, São Paulo\", \"Campinas, SP\" or \"Curitiba\". Adding the city or state helps when a neighborhood name exists in several cities. Up to 20 per run.", "items": { "type": "string" } }, "business": { "title": "Business", "enum": [ "sale", "rent" ], "type": "string", "description": "Collect listings for sale or for rent.", "default": "sale" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Only these property types. Leave empty for all types. Each type runs as its own search on Zap Imóveis.", "items": { "type": "string", "enum": [ "apartment", "house", "condo_house", "two_story_house", "penthouse", "flat", "land", "office", "store" ], "enumTitles": [ "Apartment (incl. studio, loft, duplex)", "House (single-storey, village, kitnet)", "House in a gated community", "Two-story house (sobrado)", "Penthouse (cobertura)", "Flat / serviced apartment", "Land / residential lot", "Office / commercial room", "Store / commercial space" ] } }, "minPrice": { "title": "Minimum price (BRL)", "minimum": 0, "type": "integer", "description": "Sale price, or monthly rent when collecting rentals. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price (BRL)", "minimum": 0, "type": "integer", "description": "Sale price, or monthly rent when collecting rentals. Leave empty for no maximum." }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 4, "type": "integer", "description": "Listings with at least this many bedrooms (4 means 4 or more). Leave empty for any." }, "minArea": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Minimum usable area in square meters. Leave empty for no minimum." }, "maxArea": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Maximum usable area in square meters. Leave empty for no maximum." }, "minParkingSpaces": { "title": "Minimum parking spaces", "minimum": 0, "maximum": 4, "type": "integer", "description": "Listings with at least this many parking spaces (4 means 4 or more). Leave empty for any." }, "maxItemsPerLocation": { "title": "Max listings per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Collect up to this many listings per location, across all selected property types. Zap Imóveis exposes about 1,000 results per search, so split big areas by neighborhood or price range for more.", "default": 100 } } }, "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 } } } } } } } } } }