{ "openapi": "3.0.1", "info": { "title": "Zillow Scraper - $0.80 per 1,000, Search & Details", "description": "Zillow scraper at $0.0008 per property ($0.80 per 1,000) plus a $0.001 run-start fee. Search results AND full listing details from one Actor: price, beds, baths, sqft, address, photos, price history, tax history and schools, at no surcharge. No login, no API key. Screen entire markets in seconds.", "version": "0.1", "x-build-id": "HobGdgdjGDRRuHgkC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~zillow-property-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-zillow-property-details-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/dami_studio~zillow-property-details-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-zillow-property-details-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/dami_studio~zillow-property-details-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-zillow-property-details-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": { "propertyUrls": { "title": "Zillow property URLs", "minItems": 0, "maxItems": 10, "type": "array", "description": "Public Zillow /homedetails/ listing URLs to enrich. Empty input returns one clearly labelled, uncharged sample row.", "items": { "type": "string" }, "default": [] }, "searchUrls": { "title": "Zillow search-result URLs", "maxItems": 5, "type": "array", "description": "Public Zillow result-page URLs copied from your browser after selecting a location and any public filters. Each URL is fetched once; no hidden or private Zillow endpoint is used.", "items": { "type": "string" }, "default": [] }, "maxSearchResultsPerUrl": { "title": "Maximum search listings per URL", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap public listing rows emitted from each supplied result page. Lower limits reduce traffic and cost.", "default": 10 }, "includePhotoUrls": { "title": "Include public photo URLs", "type": "boolean", "description": "Include public listing photo URLs when Zillow renders them in the current property data.", "default": true }, "includeHistory": { "title": "Include public history", "type": "boolean", "description": "Include publicly rendered price and tax history when Zillow provides it for the property.", "default": true }, "includeSchools": { "title": "Include nearby schools", "type": "boolean", "description": "Include publicly rendered nearby-school summaries when Zillow provides them for the property.", "default": true }, "enableResidentialFallback": { "title": "Retry a blocked URL once through a proxy", "type": "boolean", "description": "The actor always attempts direct browser traffic first. Enable this to retry each blocked URL once through the proxy below. Metered proxy groups (Residential, SERP) are not offered by this actor and are replaced with rotating datacenter addresses; your own proxy servers are used exactly as supplied.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration for the retry", "type": "object", "description": "Used only after a direct browser block, when the retry option above is enabled. The default is a rotating United States Apify datacenter proxy. Requests for the Residential or SERP groups are replaced with datacenter addresses; a custom proxy server list is honoured verbatim.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "BUYPROXIES94952" ], "countryCode": "US" } } } }, "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 } } } } } } } } } }