# Find US States With Falling Home Values on Zillow

**Use case:** 

Rank US states and DC by six-month home value decline using Zillow Research data. Review latestValue, latestDate, change6mPct, change12mPct, and rank to screen markets for weakening prices. Change sortBy to adjust the ranking.

## Input

```json
{
  "mode": "stateTrends",
  "homeType": "allHomesMidTier",
  "state": "all",
  "regionIds": [],
  "historyGeography": "county",
  "sortBy": "decline6mPct",
  "maxItems": 51
}
```

## Output

```json
{
  "countyName": {
    "label": "County name"
  },
  "stateCode": {
    "label": "State code"
  },
  "stateName": {
    "label": "State name"
  },
  "metro": {
    "label": "Metro"
  },
  "homeType": {
    "label": "Home type"
  },
  "latestValue": {
    "label": "Latest value"
  },
  "latestDate": {
    "label": "Latest date"
  },
  "change6mPct": {
    "label": "Change6m pct"
  },
  "change12mPct": {
    "label": "Change12m pct"
  },
  "vsBenchmark6mPct": {
    "label": "Vs benchmark6m pct"
  },
  "rank": {
    "label": "Rank"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Zillow Research County Home Value Trend Scraper Actor is ready to run with the inputs already set for "Find US States With Falling Home Values on Zillow". [Sign up or log in](https://console.apify.com/create-task-from-example/ggeCxEn3kqoLbpQHR) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Find US States With Falling Home Values on Zillow" task

The Zillow Research County Home Value Trend Scraper Actor will start running based on the input automatically. You can also change all the input fields, like mode, housing cut, and more, to match your specific use case.

### 3. Receive the "Find US States With Falling Home Values on Zillow" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as county name, state code, state name, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Find US States With Falling Home Values on Zillow" task via API](https://apify.com/dataspryva/zillow-research-county-home-value-trend-scraper.md).

## FAQ

### Which US states have the biggest home value declines over the past 6 months?

The state home value task ranks state and DC trends by six-month decline using Zillow Research data. Each row includes the value date, six- and twelve-month changes, and rank.

### What home value data does the state home value task include?

For each state and DC, the state home value task returns the latest typical home value and date, six- and twelve-month changes, and rank, with comparisons to the United States.

### How do I change how states are ranked by home value decline?

Choose a different sort option in the state home value task to order results by name, value, or a change period. Rankings are assigned before the result limit is applied.

### How many state home value records can one run return?

The state home value task is capped at 51 results in this setup. Its maxItems limit can be set from 1 to 10,000, with ranking calculated before the cap.

### Can I schedule state home value data or run it through an API?

You can run the state home value task on a schedule, through the Apify API, or from integrations such as Zapier, Make, and n8n.

### Is it legal to use state home value data from Zillow Research?

The state home value task uses public research data, but whether a use is lawful depends on its purpose, the site's terms, and data-protection laws such as GDPR or CCPA. The person running it is responsible.

## About this Actor

This example demonstrates how to use [Zillow Research County Home Value Trend Scraper](https://apify.com/dataspryva/zillow-research-county-home-value-trend-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/dataspryva/zillow-research-county-home-value-trend-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/dataspryva/zillow-research-county-home-value-trend-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).