{ "openapi": "3.0.1", "info": { "title": "Zillow Scraper API: Property Details, Zestimate & Search", "description": "Scrape Zillow: homes for sale, for rent and recently sold by city, ZIP or Zillow search link, and property details with Zestimate, rent Zestimate, tax value, agent and photos by link, zpid or street address. No login; also via MCP. $2 per 1,000 properties.", "version": "0.1", "x-build-id": "0LzzHRRbcpidl8y82" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sauliusautomatesit~zillow-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sauliusautomatesit-zillow-scraper-api", "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/sauliusautomatesit~zillow-scraper-api/runs": { "post": { "operationId": "runs-sync-sauliusautomatesit-zillow-scraper-api", "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/sauliusautomatesit~zillow-scraper-api/run-sync": { "post": { "operationId": "run-sync-sauliusautomatesit-zillow-scraper-api", "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": { "locations": { "title": "Places to search", "type": "array", "description": "One place per line, as you would type it on Zillow: a city (`Austin, TX`), a ZIP code (`78704`), a neighborhood, a county or a state. Each gives up to `maxResultsPerSearch` homes with the status below.", "items": { "type": "string" } }, "status": { "title": "Homes that are", "enum": [ "forSale", "forRent", "sold" ], "type": "string", "description": "For `Places to search`: `forSale` (default), `forRent` or `sold` (recently sold). Search links keep their own filters.", "default": "forSale" }, "searchUrls": { "title": "Zillow search links", "type": "array", "description": "Searches set up on zillow.com with any filters (price, beds, home type, map area, keywords): copy the link from the address bar, one per line, for example `https://www.zillow.com/austin-tx/` or `https://www.zillow.com/homes/for_rent/`.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max homes per search", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Zillow shows at most about 820 homes per search; above that the map is split into smaller areas automatically, up to all the homes Zillow has.", "default": 100 }, "includeDetails": { "title": "Full details for search results", "type": "boolean", "description": "Opens each home found by a search for the full property row (description, Zestimate range, rent Zestimate, facts, agent, more photos). Charged as a property instead of a listing. Apartment buildings stay listings.", "default": false }, "properties": { "title": "Properties", "type": "array", "description": "Homes to look up, one per line: a Zillow link (`https://www.zillow.com/homedetails/2114-Bigelow-Ave-N-Seattle-WA-98109/48749425_zpid/`), a zpid (`48749425`) or a street address (`2114 Bigelow Ave N, Seattle, WA 98109`). Each gives one property row with Zestimate.", "items": { "type": "string" } }, "maxPhotos": { "title": "Max photos per home", "minimum": 0, "maximum": 200, "type": "integer", "description": "Photo links per row, largest size. 0 for none.", "default": 10 }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 30, "type": "integer", "description": "Requests to Zillow at once. The default suits most runs.", "default": 10 } } }, "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 } } } } } } } } } }