# FastExpert Scraper - Real Estate Agent Leads & Reviews (`scrapesage/fastexpert-agent-scraper`) Actor

Scrape FastExpert real estate agents by city, state or profile URL. Get names, brokerages, emails, phones, license numbers, production stats, ratings, reviews, areas served & leads - plus optional website contact enrichment and monitoring. No login, no browser.

- **URL**: https://apify.com/scrapesage/fastexpert-agent-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Lead generation, Real estate, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 agent scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## FastExpert Scraper — Real Estate Agent Leads, Reviews & Production Stats (Emails & Phones)

Extract **complete real estate agent data from FastExpert** — the fields other agent scrapers leave empty: **real contact emails, direct cell phones, brokerage, state license numbers, production stats (recent transactions, sales volume, average sale price), ratings, reviews, areas served and the agent's own website + social links**. Every record is a ready-to-contact **agent lead**, scored 0–100.

No login, no cookies, no browser — fast JSON extraction with 99%+ reliability on clean US datacenter proxies.

### Why this FastExpert scraper?

Most real estate agent scrapers run on anti-bot-walled portals (Realtor.com, Zillow) that need residential proxies and CAPTCHA solvers — and still return `null` for the email. This actor reads FastExpert's clean server-rendered data and ships the **richest agent dataset in the category**, including the direct emails:

| Data | Typical scrapers | This actor |
|---|---|---|
| Agent **contact email** | ❌ null / extra fee | ✅ included on every record |
| Direct phone + cell phone | partial | ✅ both |
| Brokerage / company + license number | partial | ✅ |
| Production stats (recent transactions, sales, avg sale price) | ❌ | ✅ |
| Ratings + review count + full reviews | partial | ✅ |
| Years of experience, year licensed, agent ranking | ❌ | ✅ |
| Agent's own website + Facebook / LinkedIn / Zillow / Trulia | ❌ | ✅ |
| Areas served, designations, awards | ❌ | ✅ opt-in |
| Geo (lat/lng), full address | ❌ | ✅ |
| Lead score (0–100) per agent | ❌ | ✅ |
| Monitoring mode (only new agents) | ❌ | ✅ |
| Works on cheap datacenter proxies (no CAPTCHA) | ❌ | ✅ |

### Use cases

- **Lead generation** — real estate agents are active B2B buyers: they need CRMs, lead vendors, transaction tools, marketing, photography, staging, mortgage and title partners. Score agents by production (`recentTransactions`, `salesUploaded`, `averageSalePrice`) and reach them directly via `email`, `phone`/`cellPhone`, website and socials.
- **Recruiting & brokerage growth** — find top-producing agents in any market by transactions, reviews and rating, then recruit them to your brokerage or team.
- **Proptech & martech sales** — build targeted lists of active agents by city, state, specialization and performance for outbound and ABM.
- **Market & competitor intelligence** — track which agents and brokerages dominate a metro, their review velocity and average sale prices.
- **Mortgage, title & insurance partnerships** — agents drive referrals; build a partner pipeline with verified contact data.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **FastExpert Scraper**, enter locations (`Austin, TX`, or a whole state like `Texas`) or paste FastExpert URLs, and click **Start**.
3. Watch agent leads stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "locations": ["Austin, TX", "Miami, FL"],
    "maxAgentsPerCity": 75,
    "maxAgents": 200,
    "includeAgentDetails": true,
    "includeReviews": false,
    "minTransactions": 10,
    "withEmailOnly": true,
    "monitorMode": false
}
````

- **locations** — `City, ST` (e.g. `Austin, TX`, `San Antonio, TX`, `Miami, FL`) for a city, or a state name/abbreviation (`Texas`, `FL`) to auto-discover that state's cities.
- **startUrls** — FastExpert agent profiles (`/agents/<name>-<id>/`), city listings (`/top-real-estate-agents/austin-tx/`) or state hubs (`/top-real-estate-agents/texas/`).
- **maxAgentsPerCity / maxAgents / maxCitiesPerState** — limits.
- **minRating / minReviews / minTransactions / specialization / withEmailOnly / withPhoneOnly** — filters to target active, top-producing agents.
- **includeAgentDetails** *(default true)* — open each profile for license number, full bio, designations, awards, areas served, total sales last year and the full review list. Turn **off** for fast, low-cost bulk leads — the city listing already includes email, phone, brokerage, website, socials, geo, ratings and production stats.
- **includeReviews** *(default false)* — also output review records (`type: "review"`).
- **enrichContactEmails** *(default false)* — crawl the agent's own website (home + contact/about) for extra emails, phones and socials.
- **deduplicateAgents** *(default true)* — emit each agent once per run.
- **monitorMode** *(default false)* — emit only agents not seen in previous runs (pairs with Schedules to track new agents in a market).

### Output

One record per agent (`type: "agent"`), plus optional review records (`type: "review"`):

```json
{
    "type": "agent",
    "agentId": "68958",
    "slug": "meryl-hawk-68958",
    "profileUrl": "https://www.fastexpert.com/agents/meryl-hawk-68958/",
    "fullName": "Meryl Hawk",
    "firstName": "Meryl",
    "lastName": "Hawk",
    "title": "Real Estate Agent",
    "email": "meryl.hawk@cbrealty.com",
    "phone": "(512) 937-7056",
    "cellPhone": "(512) 937-7056",
    "website": "https://www.merylhawk.com",
    "socialLinks": {
        "facebook": "https://www.facebook.com/MerylHawkRealtor",
        "linkedin": "https://www.linkedin.com/in/merylhawkrealtor/",
        "zillow": "https://www.zillow.com/profile/merylhawk"
    },
    "brokerage": "Coldwell Banker United Realtors",
    "brokerageUrl": "https://www.fastexpert.com/real-estate-company/coldwell-banker-united-realtors-austin-tx-11136/",
    "address": "609 Castle Ridge Rd. Suite 440",
    "city": "Austin",
    "state": "TX",
    "zipCode": "78746",
    "latitude": 30.29729,
    "longitude": -97.81054,
    "specialization": "Residential",
    "licenseNumber": "609315",
    "licenseName": "Texas Real Estate License",
    "rating": 5,
    "reviewCount": 230,
    "reviewTags": ["Professional", "Responsive", "Communicative", "Knowledgeable"],
    "agentRanking": 489,
    "yearsExperience": 15,
    "yearLicensed": 2011,
    "recentTransactions": 124,
    "salesUploaded": 157,
    "averageSalePrice": "$896.7K",
    "totalSalesLastYear": "$12M",
    "designations": ["CRS", "RENE", "ABR", "GRI", "CLHMS"],
    "awards": ["2026 Top 25 Agent – Texas", "2026 Top Agent – Austin, TX"],
    "areasServed": ["Austin", "Dripping Springs", "Pflugerville"],
    "languages": ["English"],
    "imageUrl": "https://assets.fastexpert.com/.../68958_thumb_300.jpg",
    "leadScore": 96,
    "searchLocation": "Austin, TX",
    "scrapedAt": "2026-06-15T21:00:00.000Z"
}
```

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly with `monitorMode` to capture only new agents in a city or state; perfect for recruiting and lead pipelines.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/fastexpert-agent-scraper').call({
    locations: ['Austin, TX'],
    maxAgents: 200,
    minTransactions: 10,
    withEmailOnly: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} agent leads`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new agent leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored market gets new agents.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find the top-producing real estate agents in Austin and list their contact details" and let it run this scraper for you.

### More scrapers from scrapesage

Build a complete **local-business & B2B lead-gen stack**:

- **[Rent.com Scraper](https://apify.com/scrapesage/rent-com-scraper)** — US rental listings, property managers & contacts.
- **[Healthgrades Scraper](https://apify.com/scrapesage/healthgrades-scraper)** — doctors, reviews & provider leads.
- **[FindLaw Scraper](https://apify.com/scrapesage/findlaw-scraper)** — lawyers, law firms & leads.
- **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — CPAs, accountants & tax-preparer leads.
- **[Insurance Agent Scraper](https://apify.com/scrapesage/insurance-agent-scraper)** — State Farm & Farmers agent leads.
- **[Houzz Scraper](https://apify.com/scrapesage/houzz-scraper)** — home pros, contacts & reviews.
- **[Bark Listing Scraper](https://apify.com/scrapesage/bark-listing-scraper)** — local service-provider leads.
- **[DesignRush Scraper](https://apify.com/scrapesage/designrush-scraper)** — agencies, services & B2B leads.

### Tips

- **Whole states**: put a state in `locations` (e.g. `Texas`) and set `maxCitiesPerState` to scrape its largest cities; raise `maxAgents` to go wide.
- **Top producers only**: set `minTransactions` (e.g. 10) and/or `minReviews` to focus on active, high-volume agents.
- **Cheapest bulk leads**: turn `includeAgentDetails` off — the city listing already carries email, phone, brokerage, website, socials, geo, ratings and production stats, so you get rich leads with one request per page.
- **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to capture only newly listed agents.
- **Proxies**: keep the default Apify datacenter proxy (US) — FastExpert serves clean pages, no residential or CAPTCHA needed.

### FAQ

**How do I scrape real estate agents for a specific city?** Put the city in `locations` as `City, ST` (e.g. `Austin, TX`). For a whole state, use the state name (`Texas`) and set `maxCitiesPerState`.

**Where do the emails come from?** FastExpert publishes each agent's brokerage contact email on their listing — this actor reads the same public data a visitor sees, so most agent records include an email with no extra step. With `enrichContactEmails` on, it also crawls the agent's own website for additional contacts.

**Can I get only top-producing agents?** Yes — use `minTransactions`, `minReviews` and `minRating` to keep only active, well-reviewed agents.

**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**How do I monitor new agents automatically?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules) (e.g. weekly). The actor remembers agents from earlier runs and emits only new ones — independent of the scheduler, which just decides when to run.

**Is scraping FastExpert legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and FastExpert's terms.

**A field is null — why?** Some agents genuinely don't publish a website, second phone or every stat. Fields are `null` only when the data doesn't exist, not because the scraper skipped them.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.

# Actor input Schema

## `locations` (type: `array`):

Where to find agents on FastExpert. Use `City, ST` (e.g. `Austin, TX`, `Miami, FL`, `San Antonio, TX`) for a city listing, or a state name/abbreviation (`Texas`, `FL`) to auto-discover that state's cities. Leave empty if you only use Start URLs.

## `startUrls` (type: `array`):

Paste FastExpert URLs: agent profiles (`/agents/<name>-<id>/`), city listings (`/top-real-estate-agents/austin-tx/`) or state hubs (`/top-real-estate-agents/texas/`). Processed in addition to any locations above.

## `maxAgentsPerCity` (type: `integer`):

Cap the number of agents collected per city listing (each listing page has ~25 agents).

## `maxAgents` (type: `integer`):

Global cap on the total number of agent records emitted in this run, across all locations and Start URLs.

## `maxCitiesPerState` (type: `integer`):

When a location is a whole state (or a state-hub Start URL), how many of its city listings to scrape (largest cities first).

## `minRating` (type: `integer`):

Keep only agents with an overall star rating at or above this value (0 = no filter). Rated 1-5.

## `minReviews` (type: `integer`):

Keep only agents with at least this many reviews (0 = no filter).

## `minTransactions` (type: `integer`):

Keep only agents with at least this many recent closed transactions (0 = no filter). Great for targeting active, top-producing agents.

## `specialization` (type: `string`):

Optionally keep only agents matching a specialization (matched against the agent's specialization label).

## `withEmailOnly` (type: `boolean`):

Keep only agents that have a contact email (the lead wedge — most agents on FastExpert do).

## `withPhoneOnly` (type: `boolean`):

Keep only agents that have a phone or cell number.

## `includeAgentDetails` (type: `boolean`):

Visit each agent's profile page to add the deep fields: license number & type, full bio, professional designations, awards, areas served, total sales last year and the full review list. One extra request per agent. Turn OFF for fast, low-cost bulk leads — the city listing already includes email, phone, brokerage, website, socials, geo, ratings and production stats.

## `includeReviews` (type: `boolean`):

Also output review records (type `review`) from each agent's profile — star rating, review text, author and date. Requires opening profiles.

## `maxReviewsPerAgent` (type: `integer`):

How many reviews to emit per agent when 'Include agent reviews' is on.

## `enrichContactEmails` (type: `boolean`):

Opt-in: when an agent lists their own website, visit it (home + a contact/about page) and extract additional contact emails, phone numbers and social links. Secondary — the agent's brokerage email is already on the listing card. Only runs when a website exists.

## `deduplicateAgents` (type: `boolean`):

Emit each agent only once per run (keyed by agent id / profile URL), even if they appear in multiple cities or locations.

## `monitorMode` (type: `boolean`):

Remember agents already returned and emit ONLY agents not seen in previous runs (new agents in a city or state). Pairs with Apify Schedules to track new or newly-listed agents over time. Independent of the scheduler — it dedupes records, the schedule decides when to run.

## `monitorStoreName` (type: `string`):

Named key-value store that holds the 'already seen' agent ids for monitoring mode. Use a different name per tracked search to keep their histories separate.

## `maxConcurrency` (type: `integer`):

Maximum parallel requests. Lower it if you hit rate limits on very large runs.

## `proxyConfiguration` (type: `object`):

Proxy settings. FastExpert serves clean pages to US IPs, so the default Apify datacenter proxy is enough; switch to residential for very large or high-frequency runs.

## Actor input object example

```json
{
  "locations": [
    "Austin, TX"
  ],
  "maxAgentsPerCity": 75,
  "maxAgents": 200,
  "maxCitiesPerState": 10,
  "minRating": 0,
  "minReviews": 0,
  "minTransactions": 0,
  "specialization": "any",
  "withEmailOnly": false,
  "withPhoneOnly": false,
  "includeAgentDetails": true,
  "includeReviews": false,
  "maxReviewsPerAgent": 25,
  "enrichContactEmails": false,
  "deduplicateAgents": true,
  "monitorMode": false,
  "monitorStoreName": "fastexpert-monitor",
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

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

All scraped records in the default dataset. Agent rows carry the full profile, contact details, brokerage, license, production stats, ratings, areas served and lead data; review rows carry their own fields.

# 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 = {
    "locations": [
        "Austin, TX"
    ]
};

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

# Prepare the Actor input
run_input = { "locations": ["Austin, TX"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/fastexpert-agent-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 '{
  "locations": [
    "Austin, TX"
  ]
}' |
apify call scrapesage/fastexpert-agent-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapesage/fastexpert-agent-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "FastExpert Scraper - Real Estate Agent Leads & Reviews",
        "description": "Scrape FastExpert real estate agents by city, state or profile URL. Get names, brokerages, emails, phones, license numbers, production stats, ratings, reviews, areas served & leads - plus optional website contact enrichment and monitoring. No login, no browser.",
        "version": "0.1",
        "x-build-id": "paydc5jVZPcpfp9au"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapesage~fastexpert-agent-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapesage-fastexpert-agent-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/scrapesage~fastexpert-agent-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapesage-fastexpert-agent-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/scrapesage~fastexpert-agent-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapesage-fastexpert-agent-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": {
                    "locations": {
                        "title": "Locations (City, ST or State)",
                        "type": "array",
                        "description": "Where to find agents on FastExpert. Use `City, ST` (e.g. `Austin, TX`, `Miami, FL`, `San Antonio, TX`) for a city listing, or a state name/abbreviation (`Texas`, `FL`) to auto-discover that state's cities. Leave empty if you only use Start URLs.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "startUrls": {
                        "title": "Start URLs (agent profiles, city listings or state hubs)",
                        "type": "array",
                        "description": "Paste FastExpert URLs: agent profiles (`/agents/<name>-<id>/`), city listings (`/top-real-estate-agents/austin-tx/`) or state hubs (`/top-real-estate-agents/texas/`). Processed in addition to any locations above.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxAgentsPerCity": {
                        "title": "Max agents per city",
                        "minimum": 1,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Cap the number of agents collected per city listing (each listing page has ~25 agents).",
                        "default": 75
                    },
                    "maxAgents": {
                        "title": "Max agents (whole run)",
                        "minimum": 1,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Global cap on the total number of agent records emitted in this run, across all locations and Start URLs.",
                        "default": 200
                    },
                    "maxCitiesPerState": {
                        "title": "Max cities per state",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "When a location is a whole state (or a state-hub Start URL), how many of its city listings to scrape (largest cities first).",
                        "default": 10
                    },
                    "minRating": {
                        "title": "Minimum star rating",
                        "minimum": 0,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Keep only agents with an overall star rating at or above this value (0 = no filter). Rated 1-5.",
                        "default": 0
                    },
                    "minReviews": {
                        "title": "Minimum review count",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Keep only agents with at least this many reviews (0 = no filter).",
                        "default": 0
                    },
                    "minTransactions": {
                        "title": "Minimum recent transactions",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Keep only agents with at least this many recent closed transactions (0 = no filter). Great for targeting active, top-producing agents.",
                        "default": 0
                    },
                    "specialization": {
                        "title": "Specialization",
                        "enum": [
                            "any",
                            "residential",
                            "commercial",
                            "luxury",
                            "land",
                            "farm",
                            "relocation"
                        ],
                        "type": "string",
                        "description": "Optionally keep only agents matching a specialization (matched against the agent's specialization label).",
                        "default": "any"
                    },
                    "withEmailOnly": {
                        "title": "Only agents with an email",
                        "type": "boolean",
                        "description": "Keep only agents that have a contact email (the lead wedge — most agents on FastExpert do).",
                        "default": false
                    },
                    "withPhoneOnly": {
                        "title": "Only agents with a phone",
                        "type": "boolean",
                        "description": "Keep only agents that have a phone or cell number.",
                        "default": false
                    },
                    "includeAgentDetails": {
                        "title": "Open each profile for full details",
                        "type": "boolean",
                        "description": "Visit each agent's profile page to add the deep fields: license number & type, full bio, professional designations, awards, areas served, total sales last year and the full review list. One extra request per agent. Turn OFF for fast, low-cost bulk leads — the city listing already includes email, phone, brokerage, website, socials, geo, ratings and production stats.",
                        "default": true
                    },
                    "includeReviews": {
                        "title": "Include agent reviews",
                        "type": "boolean",
                        "description": "Also output review records (type `review`) from each agent's profile — star rating, review text, author and date. Requires opening profiles.",
                        "default": false
                    },
                    "maxReviewsPerAgent": {
                        "title": "Max reviews per agent",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "How many reviews to emit per agent when 'Include agent reviews' is on.",
                        "default": 25
                    },
                    "enrichContactEmails": {
                        "title": "Enrich contacts (crawl the agent's website for extra emails, phones, socials)",
                        "type": "boolean",
                        "description": "Opt-in: when an agent lists their own website, visit it (home + a contact/about page) and extract additional contact emails, phone numbers and social links. Secondary — the agent's brokerage email is already on the listing card. Only runs when a website exists.",
                        "default": false
                    },
                    "deduplicateAgents": {
                        "title": "Deduplicate agents",
                        "type": "boolean",
                        "description": "Emit each agent only once per run (keyed by agent id / profile URL), even if they appear in multiple cities or locations.",
                        "default": true
                    },
                    "monitorMode": {
                        "title": "Monitoring mode — only new agents",
                        "type": "boolean",
                        "description": "Remember agents already returned and emit ONLY agents not seen in previous runs (new agents in a city or state). Pairs with Apify Schedules to track new or newly-listed agents over time. Independent of the scheduler — it dedupes records, the schedule decides when to run.",
                        "default": false
                    },
                    "monitorStoreName": {
                        "title": "Monitor store name",
                        "type": "string",
                        "description": "Named key-value store that holds the 'already seen' agent ids for monitoring mode. Use a different name per tracked search to keep their histories separate.",
                        "default": "fastexpert-monitor"
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Maximum parallel requests. Lower it if you hit rate limits on very large runs.",
                        "default": 5
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. FastExpert serves clean pages to US IPs, so the default Apify datacenter proxy is enough; switch to residential for very large or high-frequency runs.",
                        "default": {
                            "useApifyProxy": true,
                            "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
