{ "openapi": "3.0.1", "info": { "title": "Zillow Open Houses [From $1.4💰] Exact Dates & Times | Any City", "description": "[From $1.4💰] Every upcoming Zillow open house in any US city or ZIP, with the exact dates and times of each showing. Returns price, beds, baths, sq ft, listing agent, coordinates and the full property record. Filter by price, beds or home type. Residential proxies included. JSON, CSV or Excel.", "version": "0.0", "x-build-id": "kcBUionToXGkfSCbW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~zillow-open-houses-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-zillow-open-houses-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/memo23~zillow-open-houses-scraper/runs": { "post": { "operationId": "runs-sync-memo23-zillow-open-houses-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/memo23~zillow-open-houses-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-zillow-open-houses-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": { "searchLocation": { "title": "Search location(s)", "type": "array", "description": "City, neighborhood, or ZIP code — e.g. \"Austin, TX\", \"Brooklyn, NY\", or \"78704\". One per line; each becomes its own open-house search.", "items": { "type": "string" } }, "startUrls": { "title": "Zillow search URLs (optional)", "type": "array", "description": "Alternative to Search location(s): paste any Zillow search URL (map area, drawn region, filtered search). The open-house filter is applied automatically on top of whatever the URL already filters.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max open houses to scrape", "type": "integer", "description": "Maximum number of open-house listings to return.", "default": 100 }, "priceMin": { "title": "Price: minimum ($)", "type": "integer", "description": "Minimum listing price. Leave blank for no minimum." }, "priceMax": { "title": "Price: maximum ($)", "type": "integer", "description": "Maximum listing price. Leave blank for no maximum." }, "bedsMin": { "title": "Bedrooms: minimum", "type": "integer", "description": "Minimum bedrooms." }, "bathsMin": { "title": "Bathrooms: minimum", "type": "integer", "description": "Minimum bathrooms." }, "homeTypes": { "title": "Home types", "type": "array", "description": "Limit to specific property types. Leave empty for all.", "items": { "type": "string", "enum": [ "house", "townhouse", "condo", "apartment", "manufactured", "lotLand", "multiFamily" ], "enumTitles": [ "Houses", "Townhomes", "Condos/Co-ops", "Apartments", "Manufactured", "Lots/Land", "Multi-family" ] } }, "includePropertyDetails": { "title": "Include full property details", "type": "boolean", "description": "Fetch each listing's detail page for the exact open-house dates & times (openHouseSchedules), full description, photos, price & tax history, schools, and agent info. Recommended — without it rows only mark that a listing HAS an open house, not when.", "default": true }, "flatOutput": { "title": "Flattened output (spreadsheet-friendly)", "type": "boolean", "description": "Each row becomes a simple flat object with \"Open House Times\" and \"Open House Count\" columns plus the most requested property columns — ideal for CSV/Excel. When off, rows carry the raw openHouseSchedules array and the full details object.", "default": false }, "enrichEmails": { "title": "Enrich with the listing agent's contact email (billed per email found)", "type": "boolean", "description": "Adds the listing agent's email and phone to each open-house row — matched from our database of 420,000+ U.S. agents. Only charged when an email is actually returned.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "maximum": 50, "type": "integer", "description": "Maximum number of pages processed in parallel.", "default": 20 }, "maxRequestRetries": { "title": "Max request retries", "maximum": 20, "type": "integer", "description": "Number of times a failed request is retried before giving up.", "default": 5 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies." }, "openHousesOnly": { "title": "Open houses only", "type": "boolean", "description": "Always on for this actor — every returned listing has an upcoming open house.", "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 } } } } } } } } } }