# US Real Estate (`truefetch/us-real-estate`) Actor

Search US properties — for sale, rent, recently sold, foreclosed, and pre-foreclosure — price, MLS ID, agent contact, days on market, and 50+ fields. $1.30 per 1,000.

- **URL**: https://apify.com/truefetch/us-real-estate.md
- **Developed by:** [TrueFetch](https://apify.com/truefetch) (community)
- **Categories:** Real estate, Travel, News
- **Stats:** 17 total users, 5 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

> **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected.

[![US Real Estate](https://img.shields.io/badge/US%20Real%20Estate-2C5F8A?style=for-the-badge)](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi)
[![US Real Estate Scraper](https://img.shields.io/badge/US%20Real%20Estate%20Scraper-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi)
[![$0.0013 per Property](https://img.shields.io/badge/$0.0013%20per%20Property-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi)
[![Price, Status & Listing Details](https://img.shields.io/badge/Price%20%7C%20Status%20%7C%20Listing%20Details-555555?style=for-the-badge)](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi)
[![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi)
[![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor)

## US Real Estate — US Real Estate Scraper: Price, Status & Listing Details

**Provide a ZIP code, city, or address and scrape US real estate listings — with price, property type, address, beds/baths, sqft, year built, and listing status — in clean structured JSON.**

> **TL;DR (40-word answer):** US Real Estate is a no-login Apify Actor that scrapes US property listings at **$0.0013 per property**, returning price, address, beds/baths, sqft, year built, and listing status for up to 10,000 properties. Last verified 2026-05-02.

> **What it is NOT:** US Real Estate is _not_ a mortgage calculator, _not_ a legal title search tool, and _not_ a platform for submitting offers — it scrapes publicly listed property data from US real estate search results.

> **US Real Estate is an Apify Actor that scrapes US property listings by location and listing type, returning price, status, address, beds/baths, sqft, and listing details.** Maintained by TrueFetch on the Apify Store.

---

### 🏷️ Why choose US Real Estate

**US Real Estate is best for** real estate investors, agents, researchers, and AI agents who need structured US property listing data by location.

- **🏠 Rich property profiles** — price, status, address, beds, baths, sqft, year built, property type, cover image, and full nested listing details.
- **🔍 Flexible filtering** — filter by listing type (`for_sale`, `for_rent`, `sold`, `pending`, `off_market`, `new_community`, `ready_to_build`, `other`), property type (single family, condo, land, farm, mobile, etc.), and `listed_since`.
- **⚡ Pay-per-result pricing** — **$0.0013 per property**. Free Apify plan includes $5/month credits ≈ 3,846 free property listings.

---

### 🚀 Quick Start — run in 3 steps

#### Run in Apify Console

1. **Open the Actor** — go to [US Real Estate on Apify](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) and click **Try for free**.
2. **Configure inputs** — enter a location, choose a `listing_type`, set `max_results`, and optionally filter by `property_type` or `listed_since`.
3. **Click Start** — the Actor returns structured US property listings in the dataset.

#### Run via Apify API

```bash
curl -X POST "https://api.apify.com/v2/acts/TrueFetch~us-real-estate/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "location": "Austin, TX",
    "listing_type": "for_sale",
    "max_results": 100
  }'
````

#### Run via MCP (for AI agents)

US Real Estate is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/us-real-estate` and pass the same JSON input as above.

***

### ⚙️ Input parameters

| Parameter       | Type            | Required | Default | Description                                                                                                                                        | Example             |
| --------------- | --------------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| `location`      | string          |    ✅    | —       | ZIP code, city, city+state, address, neighborhood, county, or state name.                                                                          | `Austin, TX`        |
| `listing_type`  | string          |    ✅    | —       | Listing type: `for_sale`, `for_rent`, `sold`, `pending`, `off_market`, `new_community`, `ready_to_build`, `other`.                                 | `for_sale`          |
| `max_results`   | integer         |    ✅    | —       | Maximum number of properties to return (≥ 10, capped at 10,000).                                                                                   | `100`               |
| `property_type` | array of string |    ❌    | —       | Filter by type: `single_family`, `multi_family`, `apartment`, `condos`, `condo_townhome`, `townhomes`, `duplex_triplex`, `farm`, `land`, `mobile`. | `["single_family"]` |
| `listed_since`  | string          |    ❌    | —       | Only include listings since this date or relative offset (e.g. `"30 days"`, `"2026-01-01"`).                                                       | `30 days`           |

```json
{
  "location": "Austin, TX",
  "listing_type": "for_sale",
  "max_results": 100,
  "property_type": ["single_family"],
  "listed_since": "30 days"
}
```

***

### 📦 Output dataset

Each run writes one record per property to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. The output is a rich nested object — key top-level fields are listed below.

| Field             | Type   | Always present? | Description                                          | Example                                               |
| ----------------- | ------ | :-------------: | ---------------------------------------------------- | ----------------------------------------------------- |
| `processor`       | string |       ✅        | Apify Actor URL that produced this record.           | `https://apify.com/TrueFetch/us-real-estate`          |
| `processed_at`    | string |       ✅        | ISO 8601 UTC timestamp.                              | `2026-04-24T09:30:00+00:00`                           |
| `cover_image`     | string |    optional     | Primary listing photo URL.                           | `https://...`                                         |
| `list_price`      | number |    optional     | Listed price in USD.                                 | `475000`                                              |
| `status`          | string |    optional     | Listing status.                                      | `for_sale`                                            |
| `location`        | object |    optional     | Nested address object (line, city, state, zip, etc.) | `{"address": {"line": "...", "city": "Austin", ...}}` |
| `description`     | object |    optional     | Property details: beds, baths, sqft, type, etc.      | `{"beds": 3, "baths_full": 2, "sqft": 1800, ...}`     |
| `tags`            | array  |    optional     | Property feature tags.                               | `["garage_1_or_more"]`                                |
| `photos`          | array  |    optional     | All listing photo URLs.                              | `[{"href": "https://..."}]`                           |
| `open_houses`     | array  |    optional     | Upcoming open house dates/times.                     | `[{"start_date": "...", "end_date": "..."}]`          |
| `last_sold_price` | number |    optional     | Last sold price (if available).                      | `410000`                                              |

#### Sample output

```json
{
  "processor": "https://apify.com/TrueFetch/us-real-estate",
  "processed_at": "2026-04-24T09:30:00+00:00",
  "list_price": 475000,
  "status": "for_sale",
  "location": {
    "address": {
      "line": "1234 Elm St",
      "city": "Austin",
      "state_code": "TX",
      "postal_code": "78701"
    }
  },
  "description": {
    "beds": 3,
    "baths_full": 2,
    "sqft": 1800,
    "year_built": 2005,
    "type": "single_family"
  }
}
```

***

### 💡 Use cases

#### For real estate investors analyzing a market

- **Problem:** an investor wants 500 single-family homes for sale under $600k in Austin, TX listed in the last 30 days.
- **How US Real Estate solves it:** run with `location: "Austin, TX"`, `listing_type: "for_sale"`, `property_type: ["single_family"]`, `listed_since: "30 days"`, `max_results: 500`.
- **Outcome:** 500 structured listings at **$0.65 total** ($0.0013 × 500).

#### For agents building comparative market analyses

- **Problem:** a realtor needs recently sold comparables in a ZIP code.
- **How US Real Estate solves it:** run with `listing_type: "sold"` and the target ZIP as `location`.
- **Outcome:** structured sold-price data for CMA reports.

#### For AI agents answering real estate queries

- **Problem:** LLM agents asked "what homes are for rent in 10001?" need live listing data.
- **How US Real Estate solves it:** call the Actor over the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) with location and listing\_type.
- **Outcome:** real-time property data grounded in AI assistants.

***

### 💰 Pricing, limits, and performance

| Fact                        | Value                                                        |
| --------------------------- | ------------------------------------------------------------ |
| Pricing model               | Pay-per-result (event: `result`)                             |
| Per-property price          | **$0.0013 per property = $1.30 per 1,000**                   |
| Max results per run         | **10,000**                                                   |
| Min results per run         | 10                                                           |
| Free-tier monthly allowance | $5 Apify credits ≈ **~3,846 free property listings / month** |
| Output fields per property  | **11**                                                       |
| Login / cookies required    | **No** — works without a real estate account                 |
| Export formats              | JSON, JSONL, CSV, Excel, XML, RSS, dataset API               |

***

### ⚖️ Compared with alternatives

| Capability                                                |  **US Real Estate**  | Manual browsing |    Custom scraper    |
| --------------------------------------------------------- | :------------------: | :-------------: | :------------------: |
| Structured property listings (price, beds, sqft, address) |          ✅          |       ❌        |    you implement     |
| Flexible listing type + property type filtering           |          ✅          |     manual      | you build & maintain |
| Pay-per-result pricing                                    | **$0.0013/property** |       N/A       |   infra + dev cost   |
| Setup time to first result                                |   **< 60 seconds**   |     minutes     |      days–weeks      |

**Verdict.** US Real Estate is ideal for investors, agents, and AI teams who need structured US property data without building or maintaining a real estate scraper.

***

### ⚠️ Common mistakes to avoid

1. **Missing `location`.** This field is required — use a ZIP code, city, city+state, or address.
2. **Missing `listing_type`.** This field is required — choose from `for_sale`, `for_rent`, `sold`, `pending`, `off_market`, `new_community`, `ready_to_build`, or `other`.
3. **Setting `max_results` below 10.** Minimum is 10.
4. **Invalid `property_type` values.** Must be a list from the documented enum — e.g. `["single_family", "condos"]`.
5. **Expecting mortgage/legal data.** This Actor returns publicly listed property data only.

***

### 🛠️ Troubleshooting

| Problem                                  | Likely cause                              | Fix                                                                        |
| ---------------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------- |
| `Missing 'location' field`               | `location` not provided.                  | Add `"location": "Austin, TX"` to your input JSON.                         |
| `Missing 'listing_type' field`           | `listing_type` not provided.              | Add `"listing_type": "for_sale"` (or another valid type) to your input.    |
| `'max_results' must be an integer >= 10` | `max_results` too low or wrong type.      | Use an integer ≥ 10.                                                       |
| `Invalid listing_type value`             | Unrecognized listing type.                | Use one of: `for_sale`, `for_rent`, `sold`, `pending`, `off_market`, etc.  |
| `Invalid property_type values`           | Unrecognized property type.               | Use values from the documented list (e.g. `single_family`, `condos`).      |
| Empty dataset                            | No listings found for location + filters. | Try a broader location or remove `property_type` / `listed_since` filters. |

***

### ❓ FAQ

#### What data does US Real Estate return?

Price, status, full address (line, city, state, ZIP), beds, baths, sqft, year built, property type, cover image, photos, tags, and open house details — one record per property in a rich nested JSON object.

#### How much does US Real Estate cost?

**$0.0013 per property**. The Apify Free plan includes $5/month credits ≈ 3,846 free property listings.

#### What listing types are supported?

`for_sale`, `for_rent`, `sold`, `pending`, `off_market`, `new_community`, `ready_to_build`, `other`.

#### Does US Real Estate require a login?

No — the Actor scrapes publicly accessible listings without requiring any account or login.

***

### 🔌 Integrations

US Real Estate plugs straight into the Apify ecosystem:

- **Schedules** — run weekly to track price changes in your target markets ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)).
- **Webhooks** — POST results to your system on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)).
- **Apify API** — `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)).
- **MCP Server** — call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)).
- **No-code** — Make, Zapier, n8n, Pipedream, Google Sheets, Airtable.

***

### 🧱 Sister Actors from TrueFetch

#### Jobs

- [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi)
- [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi)
- [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi)
- [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi)
- [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi)
- [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi)
- [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi)
- [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi)
- [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi)
- [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi)

#### Shopping & Deals

- [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi)
- [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi)
- [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi)
- [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi)
- [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi)
- [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi)
- [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi)
- [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi)
- [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi)
- [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi)
- [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi)
- [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi)
- [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi)
- [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi)
- [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi)
- [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi)
- [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi)
- [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi)

#### Vehicles

- [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi)
- [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi)
- [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi)
- [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi)
- [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi)

#### Real Estate

- [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi)
- [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi)
- [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi)
- [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi)

#### Local Business & Food

- [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi)
- [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi)
- [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi)
- [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi)
- [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi)
- [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi)

#### Classifieds

- [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi)
- [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi)
- [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi)
- [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi)

#### Social Media

- [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi)
- [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi)
- [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi)
- [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi)
- [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi)
- [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi)
- [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi)
- [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi)
- [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi)
- [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi)
- [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi)
- [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi)
- [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi)
- [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi)
- [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi)
- [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi)

#### Videos & Text

- [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi)
- [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi)
- [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi)
- [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi)
- [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi)
- [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi)
- [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi)
- [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi)
- [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi)

#### Content & Articles

- [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi)
- [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi)

***

### 📞 Support, changelog, last updated

#### Support

- 💬 **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor)
- 📧 **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi)
- 📖 **Actor page & docs:** [apify.com/TrueFetch/us-real-estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi)

Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi).

> **Cost of doing nothing:** manually browsing US real estate listings and extracting data takes hours. US Real Estate delivers structured property listings at $0.0013/property via API. → [Try it free with $5 of Apify credits](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi).

#### Changelog

- **2026-05-02** — README rewritten for SEO + GEO; documented all filters, output structure, pricing, troubleshooting, and FAQ.
- **2026-03** — Added `property_type` and `listed_since` filters.
- **2026-02** — Initial release: US real estate listing scraper.

***

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "SoftwareApplication",
      "@id": "https://apify.com/TrueFetch/us-real-estate#software",
      "name": "US Real Estate",
      "description": "Apify Actor that scrapes US property listings at $0.0013 per property, returning price, address, beds/baths, sqft, year built, and listing status.",
      "applicationCategory": "BusinessApplication",
      "operatingSystem": "Web, Cloud",
      "url": "https://apify.com/TrueFetch/us-real-estate",
      "offers": {
        "@type": "Offer",
        "price": "0.0013",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      },
      "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" },
      "publisher": { "@id": "https://apify.com/TrueFetch#publisher" }
    },
    {
      "@type": "Organization",
      "@id": "https://apify.com/TrueFetch#publisher",
      "name": "TrueFetch",
      "url": "https://apify.com/TrueFetch",
      "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"]
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "What data does US Real Estate return?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "Price, status, full address, beds, baths, sqft, year built, property type, cover image, photos, tags, and open house details — one record per property."
          }
        },
        {
          "@type": "Question",
          "name": "How much does US Real Estate cost?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "$0.0013 per property. The Apify Free plan includes $5/month credits — enough for 3,846 free property listings."
          }
        },
        {
          "@type": "Question",
          "name": "What listing types does US Real Estate support?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "for_sale, for_rent, sold, pending, off_market, new_community, ready_to_build, and other."
          }
        }
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Apify",
          "item": "https://apify.com"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Real Estate",
          "item": "https://apify.com/store?category=REAL_ESTATE"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "US Real Estate",
          "item": "https://apify.com/TrueFetch/us-real-estate"
        }
      ]
    }
  ]
}
```

***

**Last Updated:** May 2, 2026
**Schema version:** 1.1
**Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) · 💬 [Telegram Group](https://t.me/Apify_Actor) · 📧 [Support](https://t.me/AiAgentApi)

# Actor input Schema

## `location` (type: `string`):

US location to search. Accepted formats:

- ZIP code: "10001"

- City: "Austin"

- City + state: "Austin, TX" or "Austin, Texas"

- Full address: "350 5th Ave, New York, NY 10118"

- Neighborhood: "South Beach"

- County: "Cook County"

- Full state name: "Texas" (use full name, not "TX")

## `listing_type` (type: `string`):

Choose one listing status to search: for\_sale, for\_rent, sold, pending, off\_market, new\_community, other, ready\_to\_build

## `listed_since` (type: `string`):

Filter properties listed or sold within this timeframe

## `property_type` (type: `array`):

Filter by property style. Leave empty to include all property types

## `max_results` (type: `integer`):

Maximum number of properties to return

## Actor input object example

```json
{
  "location": "Austin, TX",
  "listing_type": "for_sale",
  "listed_since": "1 year",
  "property_type": [
    "single_family",
    "multi_family"
  ],
  "max_results": 10
}
```

# Actor output Schema

## `results` (type: `string`):

All property listings with full details including price, location, specs, and agent info

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "location": "Austin, TX",
    "listing_type": "for_sale",
    "listed_since": "1 year",
    "property_type": [
        "single_family",
        "multi_family"
    ],
    "max_results": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("truefetch/us-real-estate").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "location": "Austin, TX",
    "listing_type": "for_sale",
    "listed_since": "1 year",
    "property_type": [
        "single_family",
        "multi_family",
    ],
    "max_results": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("truefetch/us-real-estate").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 '{
  "location": "Austin, TX",
  "listing_type": "for_sale",
  "listed_since": "1 year",
  "property_type": [
    "single_family",
    "multi_family"
  ],
  "max_results": 10
}' |
apify call truefetch/us-real-estate --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=truefetch/us-real-estate",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "US Real Estate",
        "description": "Search US properties — for sale, rent, recently sold, foreclosed, and pre-foreclosure — price, MLS ID, agent contact, days on market, and 50+ fields. $1.30 per 1,000.",
        "version": "1.0",
        "x-build-id": "K1tMCZwOpGhI2aVBE"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/truefetch~us-real-estate/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-truefetch-us-real-estate",
                "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/truefetch~us-real-estate/runs": {
            "post": {
                "operationId": "runs-sync-truefetch-us-real-estate",
                "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/truefetch~us-real-estate/run-sync": {
            "post": {
                "operationId": "run-sync-truefetch-us-real-estate",
                "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",
                    "listing_type",
                    "max_results"
                ],
                "properties": {
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "US location to search. Accepted formats:\n\n- ZIP code: \"10001\"\n\n- City: \"Austin\"\n\n- City + state: \"Austin, TX\" or \"Austin, Texas\"\n\n- Full address: \"350 5th Ave, New York, NY 10118\"\n\n- Neighborhood: \"South Beach\"\n\n- County: \"Cook County\"\n\n- Full state name: \"Texas\" (use full name, not \"TX\")"
                    },
                    "listing_type": {
                        "title": "Listing Type",
                        "enum": [
                            "for_sale",
                            "for_rent",
                            "sold",
                            "pending",
                            "off_market",
                            "new_community",
                            "other",
                            "ready_to_build"
                        ],
                        "type": "string",
                        "description": "Choose one listing status to search: for_sale, for_rent, sold, pending, off_market, new_community, other, ready_to_build"
                    },
                    "listed_since": {
                        "title": "Listed Since",
                        "type": "string",
                        "description": "Filter properties listed or sold within this timeframe"
                    },
                    "property_type": {
                        "title": "Property Type",
                        "type": "array",
                        "description": "Filter by property style. Leave empty to include all property types",
                        "items": {
                            "type": "string",
                            "enum": [
                                "single_family",
                                "multi_family",
                                "apartment",
                                "condos",
                                "condo_townhome",
                                "condo_townhome_rowhome_coop",
                                "townhomes",
                                "duplex_triplex",
                                "farm",
                                "land",
                                "mobile"
                            ]
                        }
                    },
                    "max_results": {
                        "title": "Max Results",
                        "minimum": 10,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of properties to return"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
