{
  "openapi": "3.0.1",
  "info": {
    "title": "Real Estate Agent Leads Scraper for FastExpert with Emails",
    "description": "Real estate agent leads from FastExpert by city, state or profile URL: brokerage email, cell phone, brokerage, state license record (type, status, expiry, discipline), sales volume, transactions, ratings, reviews, specialties. Monitor new agents. Not affiliated with FastExpert.",
    "version": "0.2",
    "x-build-id": "IOqE9lIlhIwT1XzcX"
  },
  "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": "How many agents to deliver per city listing, counting only agents that pass your filters below (each listing page shows about 25 agents in FastExpert's own ranking order; a filtered search reads further pages until it has this many or the listing ends). In monitoring mode, agents an earlier run already delivered keep their places, so the run watches the top of each listing.",
            "default": 75
          },
          "maxAgents": {
            "title": "Max agents (whole run)",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Global cap on the total number of agent records delivered 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. The state's largest cities come first (for Texas: Houston, San Antonio, Dallas, Austin, Fort Worth ...), then its other cities.",
            "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). FastExpert's listing card stops counting at 127; with profile details on, each agent's exact count from their profile decides (and is what the row shows), while with details off a minimum above 127 reads as 127. 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 with this specialty, matched as a whole word against the agent's specialization and the specialties list each row carries (for example Luxury Homes, Relocation, Lot/Land, Commercial Properties).",
            "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: full bio, professional designations, awards, managing broker, this year's transactions, Instagram / X / YouTube / Realtor.com links and the full review list. One extra request per agent. Turn OFF for fast bulk leads: the city listing already includes email, phones, brokerage, website, socials, geo, ratings, production stats, specialties, areas served and the state license record (number, type, status, expiry, discipline).",
            "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. Billed only when the crawl finds at least one contact. 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. The default is Apify Residential proxy in the US. A page FastExpert answers with a Cloudflare bot check is read through Apify's unblocking proxy instead, at no extra cost to you; a run that still cannot read FastExpert ends on a card that says so and bills nothing.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "US"
            }
          },
          "urlsFromFile": {
            "title": "Import URLs from a file",
            "type": "string",
            "description": "Paste a list of URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file containing them. Lets you import many Start URLs at once instead of typing each. Google Sheet/Drive share links are handled automatically."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}