{ "openapi": "3.0.1", "info": { "title": "Rental Deal Alerts — New Listings & Price Drops, No Login", "description": "Watch Zillow and Zumper rentals by city, ZIP, price and beds and get only NEW listings and PRICE DROPS since the last run, with previous price, days on market and specials. Schedule it every few hours. No login. MCP-ready. $10 per 1,000 alerts.", "version": "1.0", "x-build-id": "qZvwZjbhfj0QxUuf2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flamboyant_liner~rental-deal-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flamboyant_liner-rental-deal-alerts", "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/flamboyant_liner~rental-deal-alerts/runs": { "post": { "operationId": "runs-sync-flamboyant_liner-rental-deal-alerts", "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/flamboyant_liner~rental-deal-alerts/run-sync": { "post": { "operationId": "run-sync-flamboyant_liner-rental-deal-alerts", "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": "Locations", "type": "array", "description": "Cities, ZIP codes or neighborhoods to watch, e.g. \"Austin, TX\", \"78704\", \"Capitol Hill, Seattle, WA\". Each location is searched on every source.", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Rental sites to pull from.", "items": { "type": "string", "enum": [ "zillow", "zumper" ], "enumTitles": [ "Zillow", "Zumper" ] }, "default": [ "zillow", "zumper" ] }, "minPrice": { "title": "Min monthly rent", "minimum": 0, "type": "integer", "description": "Lowest rent to include, in USD per month. 0 = no minimum.", "default": 0 }, "maxPrice": { "title": "Max monthly rent", "minimum": 0, "type": "integer", "description": "Highest rent to include, in USD per month. 0 = no maximum.", "default": 3000 }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bedrooms. 0 includes studios.", "default": 1 }, "homeTypes": { "title": "Home types", "type": "array", "description": "Property types to include. Empty = all. Zillow supports every option; Zumper can filter houses, apartments and townhouses.", "items": { "type": "string", "enum": [ "house", "apartment", "townhouse", "condo", "multiFamily" ], "enumTitles": [ "Houses", "Apartments", "Townhomes", "Condos", "Multi-family" ] }, "default": [] }, "maxNewPerLocation": { "title": "Max new listings per location", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on NEW listings reported per location per run. Listings beyond the cap stay unseen and are reported on the next run. Price-change alerts are not capped by this.", "default": 5 }, "alertOnPriceDrops": { "title": "Alert on price drops", "type": "boolean", "description": "Emit a price_drop alert when a listing seen on an earlier run is now cheaper.", "default": true }, "alertOnPriceIncreases": { "title": "Alert on price increases", "type": "boolean", "description": "Also emit a price_increase alert when a listing seen earlier got more expensive.", "default": false }, "firstRunMode": { "title": "First run mode", "enum": [ "emitAll", "baseline" ], "type": "string", "description": "What to do when the monitor has no saved state yet. emitAll: report the current matches as new (good for a first test). baseline: silently record every current match and emit nothing, so the next scheduled run reports only what changed since.", "default": "emitAll" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. After each run a JSON summary {monitorId, runAt, newCount, priceDropCount, alerts[first 50]} is POSTed here (Slack/Zapier/Make/your API).", "default": "" }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of this watchlist. Each ID keeps its own seen-state in a key-value store named rental-alerts-, so you can run several profiles (e.g. \"austin-2br\", \"denver-houses\") side by side.", "default": "default" }, "maxItems": { "title": "Max alerts per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after emitting this many alerts in total (new listings plus price changes).", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Zillow blocks datacenter IPs. Residential proxy is required on the Apify platform and is the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "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 }, "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 } } } } } } } } } }