{ "openapi": "3.0.1", "info": { "title": "Zillow Property Scraper", "description": "Scrapes Zillow property listings across all US states — FSBO, recently sold, and agent listings. Extracts prices, addresses, lot sizes, agent contacts, images, and property history. Filter by state, property type, lot size, and days on market.", "version": "1.0", "x-build-id": "ybNWgL7wwJHYxemqp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyspider~zillow-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyspider-zillow-property-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/scrapyspider~zillow-property-scraper/runs": { "post": { "operationId": "runs-sync-scrapyspider-zillow-property-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/scrapyspider~zillow-property-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyspider-zillow-property-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": [ "runConfig", "stateCodes" ], "properties": { "runConfig": { "title": "Scrape Mode", "uniqueItems": true, "type": "array", "description": "Select which listing types to scrape. FSBO = For Sale By Owner, AgentSold = Recently Sold (agent listings), FSBA = For Sale By Agent (active MLS listings).", "items": { "type": "string", "enum": [ "FSBO", "AgentSold", "FSBA" ], "enumTitles": [ "For Sale By Owner (FSBO)", "Recently Sold (AgentSold)", "For Sale By Agent (FSBA)" ] }, "default": [ "FSBO" ] }, "stateCodes": { "title": "US States", "uniqueItems": true, "type": "array", "description": "Select US states to scrape properties from. Each state will generate separate search requests by county.", "items": { "type": "string", "enum": [ "ak", "al", "ar", "az", "ca", "co", "ct", "de", "fl", "ga", "hi", "ia", "id", "il", "in", "ks", "ky", "la", "ma", "md", "me", "mi", "mn", "mo", "ms", "mt", "nc", "nd", "ne", "nh", "nj", "nm", "nv", "ny", "oh", "ok", "or", "pa", "ri", "sc", "sd", "tn", "tx", "ut", "va", "vt", "wa", "dc", "wi", "wv", "wy" ], "enumTitles": [ "Alaska", "Alabama", "Arkansas", "Arizona", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Iowa", "Idaho", "Illinois", "Indiana", "Kansas", "Kentucky", "Louisiana", "Massachusetts", "Maryland", "Maine", "Michigan", "Minnesota", "Missouri", "Mississippi", "Montana", "North Carolina", "North Dakota", "Nebraska", "New Hampshire", "New Jersey", "New Mexico", "Nevada", "New York", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Virginia", "Vermont", "Washington", "Washington DC", "Wisconsin", "West Virginia", "Wyoming" ] }, "default": [ "ca", "tx", "fl" ] }, "propertyType": { "title": "Property Type", "uniqueItems": true, "type": "array", "description": "Filter by property type. Select one or more types to include in the search results.", "items": { "type": "string", "enum": [ "sf", "apa", "land", "tow", "mf", "con", "manu" ], "enumTitles": [ "Houses/Single Family", "Apartments", "Lots/Land", "Townhomes", "Multi-family", "Condos/Co-ops", "Manufactured" ] }, "default": [ "sf" ] }, "daysOnZillow": { "title": "Days on Zillow (Max)", "enum": [ "any", "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m" ], "type": "string", "description": "Filter properties by maximum days they have been listed on Zillow. Select 'Any' for no restriction.", "default": "any" }, "daysOnZillowMin": { "title": "Days on Zillow (Min)", "enum": [ "0", "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m" ], "type": "string", "description": "Filter properties that have been listed for at least this many days. Useful for finding stale listings that may indicate motivated sellers.", "default": "0" }, "lotSizeMin": { "title": "Lot Size (Min)", "enum": [ "", "1000", "2000", "3000", "4000", "5000", "7500", "10890", "21780", "43560", "87120", "217800", "435600", "871200", "2178000" ], "type": "string", "description": "Minimum lot size filter in square feet.", "default": "" }, "lotSizeMax": { "title": "Lot Size (Max)", "enum": [ "1000", "2000", "3000", "4000", "5000", "7500", "10890", "21780", "43560", "87120", "217800", "435600", "871200", "2178000", "4356000", "" ], "type": "string", "description": "Maximum lot size filter in square feet.", "default": "" }, "keywordSearch": { "title": "Keyword Search", "type": "string", "description": "Optional keyword to search for in property descriptions. Examples: 'motivated', 'fixer-upper', 'waterfront', 'pool', 'acreage'." }, "soldYearsAgo": { "title": "Sold Years Ago (Threshold)", "minimum": 0, "maximum": 50, "type": "integer", "description": "For AgentSold mode: only include properties where the previous sale was at least this many years ago. Set to 0 to disable this filter.", "default": 0 } } }, "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 } } } } } } } } } }