# Zillow Mortgage Rates Scraper (`crawlerbros/zillow-mortgage-rates-scraper`) Actor Scrape Zillow's daily mortgage rate data by loan type. Returns current rate, APR, 30-day trend, and rate samples with points and fees. Optional lender-level quotes per state. - **URL**: https://apify.com/crawlerbros/zillow-mortgage-rates-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 20 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zillow Mortgage Rates Scraper Scrape Zillow's daily mortgage rate data by loan type. Returns current national average rate, APR, 30-day trend, and rate samples with points and fees. Optional lender-level quotes per state. ### What You Get #### Aggregate Rate Data (no proxy required) - **Current rate & APR** — live national average from Zillow's API (CONFORMING/Conventional types) - **30-day daily trend** — daily rate history for the past ~30 days - **Rate samples** — multiple rate snapshots per loan type with points (%), points ($), and monthly payment - One record per selected loan type #### Lender Quotes (opt-in, requires proxy) - **Individual lender names** with rate, APR, points, and monthly payment - Per state and loan type - Enable with `fetchLenderQuotes: true` ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `loanTypes` | array | all 7 | Loan types to scrape: `30yr-fixed`, `15yr-fixed`, `5/1-arm`, `7/1-arm`, `fha`, `va`, `jumbo` | | `states` | array | `["national"]` | States for lender quotes. `national` always included for aggregate data | | `fetchLenderQuotes` | boolean | `false` | Enable per-lender quotes via Playwright | | `maxLendersPerState` | integer | `10` | Max lender quotes per state × loan type (1–50) | ### Output Two record types in one dataset (use `recordType` field to distinguish): #### `aggregate` — National rate data ```json { "recordType": "aggregate", "loanType": "30yr-fixed", "productType": "CONFORMING", "scope": "national", "currentRate": 6.087, "currentApr": 6.101, "rateSamples": [ {"rate": 5.25, "apr": 5.66, "pointsPaid": 1.86, "pointsPaidDollar": 5123, "monthlyPayment": 2951, "datePriced": "2026-04-25T02:01:01Z"} ], "rateTrend": [ {"date": "2026-03-28", "rate": 6.446, "apr": 6.455} ], "scrapedAt": "2026-04-27T10:00:00Z" } ```` **Note on rate sources:** - `currentRate` / `currentApr` / `rateDate` / `rateTrend` come from Zillow's `getCurrentRates` and `getRates` APIs and are **per-loan-type** (e.g. 30yr-fixed=6.216%, 15yr-fixed=5.599%, VA=5.623%). API supports Fixed30Year, Fixed15Year, Fixed10Year, Fixed20Year × Conventional/FHA/VA/Jumbo. ARMs are **not** in the API enum so 5/1-arm and 7/1-arm records omit `currentRate`/`rateTrend`. - `rateSamples` come from Zillow's mortgage-rate article pages and represent **example marketplace rates** (with points, monthly payment, APR). They are not strictly term-segregated — Zillow's article HTML embeds general marketplace examples rather than per-loan-program quotes — so use `currentRate`/`rateTrend` for term-specific rate signals and `rateSamples` for sample marketplace context. #### `lenderQuote` — Per-lender rate (fetchLenderQuotes: true only) ```json { "recordType": "lenderQuote", "loanType": "30yr-fixed", "state": "CA", "lenderName": "Better Mortgage", "rate": 6.125, "apr": 6.341, "pointsPaid": 1.86, "pointsPaidDollar": 5115, "monthlyPayment": 3159, "scrapedAt": "2026-04-27T10:00:00Z" } ``` ### Use Cases - **Rate tracking** — schedule daily runs to monitor rate trends over time - **Finance apps** — display current rates and rate comparisons to users - **Market research** — compare rates across loan types and states - **Lender comparison** — use `fetchLenderQuotes` to compare individual lender offers ### Examples **National average for the popular loan types:** ```json { "loanTypes": ["30yr-fixed", "15yr-fixed", "fha", "va"], "states": ["national"] } ``` **Compare rates across all 50 states for a single loan type:** ```json { "loanTypes": ["30yr-fixed"], "states": ["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC"] } ``` **Pull individual lender quotes per state (uses Playwright):** ```json { "loanTypes": ["30yr-fixed"], "states": ["CA", "TX", "NY"], "fetchLenderQuotes": true, "maxLendersPerState": 10 } ``` ### FAQs **Why do FHA/VA/Jumbo records not have `currentRate` and `rateTrend`?** Zillow's public mortgage API only returns national aggregate data for CONFORMING (conventional) loans. FHA, VA, and Jumbo rate data comes from rate samples embedded in Zillow's article pages. **What does `rateSamples` contain?** Multiple rate snapshots scraped from Zillow's mortgage rate articles. Each sample represents a different rate offering with associated APR, points, and monthly payment estimate. **When should I use `fetchLenderQuotes`?** When you need individual lender names and state-specific rates. This mode uses Playwright with a residential proxy, adds cost and run time, and requires proxy credits. **How often does Zillow update its rates?** Rate samples in articles are updated daily. The API (`currentRate`, `rateTrend`) updates throughout the day. # Actor input Schema ## `loanTypes` (type: `array`): Which loan types to scrape. All types are scraped if omitted. ## `states` (type: `array`): States to include. 'national' returns national aggregate data. Individual states are used for lender quotes (requires fetchLenderQuotes: true). ## `fetchLenderQuotes` (type: `boolean`): Enable Playwright pass to fetch individual lender quotes per state. Requires residential proxy and takes longer. Off by default. ## `maxLendersPerState` (type: `integer`): Maximum number of lender quotes to extract per state per loan type (1–50). Only applies when fetchLenderQuotes is enabled. ## Actor input object example ```json { "loanTypes": [ "30yr-fixed", "fha", "va" ], "states": [ "national" ], "fetchLenderQuotes": false, "maxLendersPerState": 5 } ``` # Actor output Schema ## `rates` (type: `string`): Dataset of mortgage rate records (one per loan-type × state combination). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "loanTypes": [ "30yr-fixed", "fha", "va" ], "states": [ "national" ], "fetchLenderQuotes": false, "maxLendersPerState": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/zillow-mortgage-rates-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "loanTypes": [ "30yr-fixed", "fha", "va", ], "states": ["national"], "fetchLenderQuotes": False, "maxLendersPerState": 5, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/zillow-mortgage-rates-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "loanTypes": [ "30yr-fixed", "fha", "va" ], "states": [ "national" ], "fetchLenderQuotes": false, "maxLendersPerState": 5 }' | apify call crawlerbros/zillow-mortgage-rates-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/zillow-mortgage-rates-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Mortgage Rates Scraper", "description": "Scrape Zillow's daily mortgage rate data by loan type. Returns current rate, APR, 30-day trend, and rate samples with points and fees. Optional lender-level quotes per state.", "version": "0.1", "x-build-id": "u5jWJ7yDPzRScXYlz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~zillow-mortgage-rates-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-zillow-mortgage-rates-scraper", "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/crawlerbros~zillow-mortgage-rates-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-zillow-mortgage-rates-scraper", "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/crawlerbros~zillow-mortgage-rates-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-zillow-mortgage-rates-scraper", "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": { "loanTypes": { "title": "Loan Types", "type": "array", "description": "Which loan types to scrape. All types are scraped if omitted.", "items": { "type": "string", "enum": [ "30yr-fixed", "15yr-fixed", "5/1-arm", "7/1-arm", "fha", "va", "jumbo" ], "enumTitles": [ "30-Year Fixed", "15-Year Fixed", "5/1 ARM", "7/1 ARM", "FHA Loan", "VA Loan", "Jumbo Loan" ] } }, "states": { "title": "States", "type": "array", "description": "States to include. 'national' returns national aggregate data. Individual states are used for lender quotes (requires fetchLenderQuotes: true).", "items": { "type": "string", "enum": [ "national", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "National (all states)", "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Washington D.C.", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] }, "default": [ "national" ] }, "fetchLenderQuotes": { "title": "Fetch Lender Quotes", "type": "boolean", "description": "Enable Playwright pass to fetch individual lender quotes per state. Requires residential proxy and takes longer. Off by default.", "default": false }, "maxLendersPerState": { "title": "Max Lenders Per State", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of lender quotes to extract per state per loan type (1–50). Only applies when fetchLenderQuotes is enabled.", "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 } } }, "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 } } } } } } } } } } ```