{ "openapi": "3.0.1", "info": { "title": "Zillow Sold Comps Scraper | 26 Fields, Up to 730 Days Back", "description": "Scrape Zillow recently sold properties by city or zip for CMA reports, investment analysis, and market research. Filter by sold date range (30 to 365 days), price, beds, and property type. Extract sold price, date, address, beds, baths, sqft, Zestimate and listing URL.", "version": "0.1", "x-build-id": "iz6zkjMe1zGz7lTIm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~zillow-recently-sold/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-zillow-recently-sold", "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/themineworks~zillow-recently-sold/runs": { "post": { "operationId": "runs-sync-themineworks-zillow-recently-sold", "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/themineworks~zillow-recently-sold/run-sync": { "post": { "operationId": "run-sync-themineworks-zillow-recently-sold", "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": [ "location" ], "properties": { "location": { "title": "Location", "type": "string", "description": "City, zip code, or neighborhood (e.g. 'Phoenix, AZ', '85016', 'Palo Alto, CA'). Texas, Utah and other non-disclosure states have no public sale prices: see 'Sales with no public sale price' below." }, "maxItems": { "title": "Max properties to scrape", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of recently sold properties to return. Zillow serves roughly the first 1,000 results of any one search, so a larger value stops there.", "default": 100 }, "soldInLast": { "title": "Sold within (days)", "minimum": 1, "maximum": 730, "type": "integer", "description": "Only return homes sold within the last N days. Common values: 30, 90, 180, 365.", "default": 90 }, "minPrice": { "title": "Min sold price ($)", "type": "integer", "description": "Minimum sale price in USD, to exclude cheaper closings from the results, e.g. 300000." }, "maxPrice": { "title": "Max sold price ($)", "type": "integer", "description": "Maximum sale price in USD, to exclude pricier closings from the results, e.g. 800000." }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bedrooms a sold property must have to be included, e.g. 3." }, "minBaths": { "title": "Min bathrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bathrooms a sold property must have to be included, e.g. 2." }, "propertyType": { "title": "Property type", "type": "string", "description": "Filter by property type: SINGLE_FAMILY, CONDO, TOWNHOUSE, MULTI_FAMILY, MANUFACTURED or LOT (LAND also works and means LOT). Not case sensitive. Leave blank for all types.", "default": "" }, "rowsWithoutSalePrice": { "title": "Sales with no public sale price", "enum": [ "deliverFree", "skip" ], "type": "string", "description": "Texas, Utah and other non-disclosure states keep sale prices private, so Zillow shows none. These sales are never charged. 'Deliver free' keeps them in the results, labelled priceDisclosed false, with sold date, address and home facts. 'Skip' leaves them out so you get only sales with a price.", "default": "deliverFree" }, "monitorMode": { "title": "Monitor mode (only new listings)", "type": "boolean", "description": "Run this on a schedule and get ONLY sales not delivered in a previous run, so a daily comps watch bills you for new closings instead of the whole history every morning. You are never charged twice for the same property. Keep the location and filters the same across runs.", "default": 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 } } } } } } } } } }