{
"openapi": "3.0.1",
"info": {
"title": "Zillow Scraper 🏠 (for sale, rent and sold, all-in price)",
"description": "Every Zillow search result for a city or ZIP in clean JSON: price, beds, baths, square feet, Zestimate, rent Zestimate, status, days on Zillow, address and coordinates. For sale, for rent or sold, with the filters you would set on the site. One flat price per listing, platform usage included.",
"version": "0.1",
"x-build-id": "CR6xEtwwbCd8k4bDz"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~zillow-listings-search/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-zillow-listings-search",
"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/tagadanar~zillow-listings-search/runs": {
"post": {
"operationId": "runs-sync-tagadanar-zillow-listings-search",
"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/tagadanar~zillow-listings-search/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-zillow-listings-search",
"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": [
"locations"
],
"properties": {
"locations": {
"title": "Cities, ZIP codes or Zillow search URLs",
"minItems": 1,
"maxItems": 25,
"type": "array",
"description": "One per line. A city with its state (Austin, TX), a ZIP code (78704), a neighbourhood slug, or a Zillow search URL you pasted from your browser (map-drawn searches keep their boundary). Mix them freely.",
"items": {
"type": "string"
}
},
"listingType": {
"title": "For sale, for rent, or sold",
"enum": [
"forSale",
"forRent",
"sold"
],
"type": "string",
"description": "Which market to read. Ignored for a pasted URL that already says /rentals/ or /sold/.",
"default": "forSale"
},
"minPrice": {
"title": "Minimum price",
"minimum": 0,
"type": "integer",
"description": "In dollars. For rentals this is monthly rent. Leave empty for no minimum."
},
"maxPrice": {
"title": "Maximum price",
"minimum": 0,
"type": "integer",
"description": "In dollars. For rentals this is monthly rent. Leave empty for no maximum."
},
"minBeds": {
"title": "Minimum bedrooms",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Leave empty for any."
},
"maxBeds": {
"title": "Maximum bedrooms",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Leave empty for any. Useful for keeping the 6-bed houses out of a starter-home search."
},
"minBaths": {
"title": "Minimum bathrooms",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Leave empty for any."
},
"minSqft": {
"title": "Minimum living area (sq ft)",
"minimum": 0,
"type": "integer",
"description": "Interior floor area, in square feet. Leave empty for no minimum. Tiles that do not publish a size are kept."
},
"maxSqft": {
"title": "Maximum living area (sq ft)",
"minimum": 0,
"type": "integer",
"description": "Interior floor area, in square feet. Leave empty for no maximum. Tiles that do not publish a size are kept."
},
"minYearBuilt": {
"title": "Built no earlier than",
"minimum": 1800,
"maximum": 2100,
"type": "integer",
"description": "Year of construction, for example 1990. Zillow applies this one on its side: search tiles do not carry a build year, so the actor cannot re-check it on the row the way it does for size, beds and price."
},
"homeTypes": {
"title": "Home types",
"type": "array",
"description": "Leave empty for every type Zillow shows by default.",
"items": {
"type": "string",
"enum": [
"houses",
"condos",
"townhomes",
"multiFamily",
"apartments",
"lotsLand",
"manufactured"
],
"enumTitles": [
"Houses",
"Condos/Co-ops",
"Townhomes",
"Multi-family",
"Apartments",
"Lots/Land",
"Manufactured"
]
}
},
"sortBy": {
"title": "Sort",
"enum": [
"relevance",
"newest",
"priceAsc",
"priceDesc",
"sqft",
"lotSize"
],
"type": "string",
"description": "Which listings you get first, and therefore which ones you get at all when you cap the results.",
"default": "relevance"
},
"maxListingsPerSearch": {
"title": "Max listings per search",
"minimum": 1,
"maximum": 820,
"type": "integer",
"description": "Stop each city / ZIP after this many listings. Zillow itself never paginates past 820 results for one search, so narrow the filters if you need more than that from one place. You are only charged for listings actually delivered. Note that up to 25 locations fit in one run: each one walks its own pages, and a run that would outlast its timeout stops early and says so.",
"default": 100
}
}
},
"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
}
}
}
}
}
}
}
}
}
}