{ "openapi": "3.0.1", "info": { "title": "Zillow Scraper: homes for sale, rentals, sold and details", "description": "Scrape Zillow by city, ZIP, county or search URL: homes for sale, for rent and sold, with price, beds, baths, area, Zestimate, days on Zillow, broker and photos, and with details, price and tax history, schools, agent and facts. Whole cities, past the 820 a search shows. No login.", "version": "0.1", "x-build-id": "g5PivL4Ko39hV1OHn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pikoulas~zillow/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pikoulas-zillow", "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/pikoulas~zillow/runs": { "post": { "operationId": "runs-sync-pikoulas-zillow", "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/pikoulas~zillow/run-sync": { "post": { "operationId": "run-sync-pikoulas-zillow", "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": { "searches": { "title": "Searches", "type": "array", "description": "Places as typed into Zillow's search (Austin, TX; 78704; Travis County, TX; Brooklyn, NY), or search URLs copied from zillow.com with their filters and map area. Each place is searched over its whole area, with the listing type and filters below.", "items": { "type": "string" } }, "listingType": { "title": "Listing type", "enum": [ "sale", "rent", "sold" ], "type": "string", "description": "Homes for sale, for rent or recently sold. A search URL keeps its own.", "default": "sale" }, "maxListingsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many homes to take from each search. A whole city can hold tens of thousands.", "default": 100 }, "includeDetails": { "title": "Include home details", "type": "boolean", "description": "Each home's price history, tax history, schools, description, the listing's facts (heating, parking, HOA, appliances...), agent and MLS, and all its photos. One more request per home, so slower, and priced as a listing with details. Apartment buildings come without them.", "default": false }, "homes": { "title": "Homes", "type": "array", "description": "Home URLs (zillow.com/homedetails/..._zpid/) or zpids. These always come with their details.", "items": { "type": "string" } }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "In US dollars; for rentals, the monthly rent." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "In US dollars; for rentals, the monthly rent." }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Only homes with at least this many bedrooms." }, "minBaths": { "title": "Min bathrooms", "minimum": 0, "type": "integer", "description": "Only homes with at least this many bathrooms." }, "homeTypes": { "title": "Home types", "type": "array", "description": "Only these types. Empty for all.", "items": { "type": "string", "enum": [ "houses", "townhomes", "multiFamily", "condos", "apartments", "manufactured", "land" ], "enumTitles": [ "Houses", "Townhomes", "Multi-family", "Condos/co-ops", "Apartments", "Manufactured", "Lots/land" ] } }, "daysOnZillow": { "title": "Days on Zillow", "enum": [ "any", "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m" ], "type": "string", "description": "Only homes listed, or for sold homes sold, within this time.", "default": "any" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for most runs. On the Apify platform, a run Zillow refuses switches to residential proxy by itself.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }