{ "openapi": "3.0.1", "info": { "title": "Zillow ZIP Code Search API: For Sale, Rent & Sold by ZIP", "description": "Zillow ZIP code search API and scraper: every home for sale, for rent or recently sold in your list of US ZIP codes, with price, Zestimate, beds, baths, area, broker and photos, past Zillow's 820 cap. Optional full details. No login; also via MCP. $1.50 per 1,000 homes.", "version": "0.1", "x-build-id": "um9EX8XN19ouFPPtd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sauliusautomatesit~zillow-zip-code-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sauliusautomatesit-zillow-zip-code-search-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-zip-code-search-api/runs": { "post": { "operationId": "runs-sync-sauliusautomatesit-zillow-zip-code-search-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-zip-code-search-api/run-sync": { "post": { "operationId": "run-sync-sauliusautomatesit-zillow-zip-code-search-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": { "zipCodes": { "title": "ZIP codes", "type": "array", "description": "US ZIP codes, one per line, for example `78704`. Each gives up to `Max homes per ZIP code` homes with the status below.", "items": { "type": "string" } }, "status": { "title": "Homes that are", "enum": [ "forSale", "forRent", "sold" ], "type": "string", "description": "`forSale` (the default when left empty), `forRent` or `sold` (recently sold)." }, "priceMin": { "title": "Min price", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Optional. Lowest list price in dollars (monthly rent for rentals). Same field name as maxcopell/zillow-zip-search, so its inputs run here as is." }, "priceMax": { "title": "Max price", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Optional. Highest list price in dollars (monthly rent for rentals)." }, "daysOnZillow": { "title": "Days on Zillow", "enum": [ "", "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m" ], "type": "string", "description": "Optional. Only homes listed within this time, for example `7` for new listings of the last week." }, "forSaleByAgent": { "title": "Agent listings", "type": "boolean", "description": "Homes for sale only: untick to leave out homes listed by an agent. Every other listing type stays in.", "default": true }, "forSaleByOwner": { "title": "For sale by owner (FSBO)", "type": "boolean", "description": "Homes for sale only: untick to leave out homes listed by their owner.", "default": true }, "maxResultsPerZip": { "title": "Max homes per ZIP code", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Zillow shows at most about 820 homes per search; above that the ZIP code's map is split into smaller areas automatically, up to all the homes Zillow has. Default 100." }, "includeDetails": { "title": "Full details for every home", "type": "boolean", "description": "Opens each home for the full property row (description, Zestimate range, rent Zestimate, facts, agent, more photos). Charged as a property ($2 per 1,000) instead of a listing ($1.50 per 1,000). Apartment buildings stay listings.", "default": false }, "maxPhotos": { "title": "Max photos per home", "minimum": 0, "maximum": 200, "type": "integer", "description": "Photo links per row, largest size. 0 for none.", "default": 5 }, "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 } } } } } } } } } }