{ "openapi": "3.0.1", "info": { "title": "Zillow Scraper — FSBO, New Listings & Price Reduced", "description": "Extract every new Zillow listing posted in the last 24 hours by ZIP code. Get price, agent contact, beds, baths, FSBO flags, price history and more. Built for real estate agents, wholesalers and investors.", "version": "0.0", "x-build-id": "S560Og6vlcwTXlg3Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yka_6789~zilliow/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yka_6789-zilliow", "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/yka_6789~zilliow/runs": { "post": { "operationId": "runs-sync-yka_6789-zilliow", "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/yka_6789~zilliow/run-sync": { "post": { "operationId": "run-sync-yka_6789-zilliow", "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": [ "zipCodes" ], "properties": { "zipCodes": { "title": "ZIP Codes to Scrape", "type": "array", "description": "List of US ZIP codes to search for new listings. Example: [\"90210\", \"10001\"]", "default": [ "10001" ], "items": { "type": "string" } }, "listingTypes": { "title": "Listing Types", "type": "array", "description": "Types of listings to collect: forSale, forRent, fsbo", "default": [ "forSale", "fsbo" ], "items": { "type": "string" } }, "maxHoursOld": { "title": "Max Listing Age (hours)", "minimum": 1, "maximum": 720, "type": "integer", "description": "Only collect listings posted within this many hours. Default = 24. Max = 168 (7 days).", "default": 24 }, "maxListingsPerZip": { "title": "Max Listings per ZIP", "minimum": 0, "type": "integer", "description": "Hard cap per ZIP code per run. Set to 0 for unlimited.", "default": 200 }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Residential proxies are required for Zillow.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST new leads to this URL in real time as they are found. Leave blank to disable.", "default": "" }, "notifyEmail": { "title": "Notification Email", "type": "string", "description": "Send a summary email when the run finishes. Leave blank to disable.", "default": "" }, "deduplicateResults": { "title": "Deduplicate Results", "type": "boolean", "description": "Skip listings already captured in a previous run. Uses Zillow ZPID as the unique key.", "default": true }, "debug": { "title": "Debug Mode", "type": "boolean", "description": "Enable verbose logging and save raw HTML snapshots for troubleshooting.", "default": false } } }, "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 } } } } } } } } } }