# Realtor Scraper โ€” US Real Estate Listings & Property Data (`blackfalcondata/realtor-scraper`) Actor Scrape US real estate from realtor.com โ€” for-sale, for-rent & recently-sold listings with price & tax history, schools, flood risk, value estimates (AVM), mortgage breakdown, agent contacts, photos, GPS, full filters, radius search, and incremental NEW/UPDATED/EXPIRED tracking. - **URL**: https://apify.com/blackfalcondata/realtor-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ### What does Realtor Scraper do? Realtor Scraper extracts structured US real-estate listings from realtor.com โ€” for sale, for rent, and recently sold. Every listing carries price, beds/baths, square footage, lot size, address with GPS, photos, and the listing agent. Detail enrichment (on by default) adds price history, tax history with assessments, assigned schools, flood risk, independent value estimates (AVM), and a mortgage breakdown. Filter by price, beds, baths, sqft, property type, and an optional lat/long radius; paste any realtor.com search or property URL; and run incrementally to capture only new, changed, or expired listings. **New to Apify?** [Sign up free](https://console.apify.com/sign-up?fpr=1h3gvi&fp_sid=ctaplain) and use the included $5 monthly platform credit to test this actor. ### Key features - **๐Ÿ“‹ Deep property detail** โ€” every listing is enriched (on by default) with the full detail payload: price history, tax history with assessments, assigned schools and ratings, flood risk (FEMA zone + flood-factor score), value estimates (AVM low/mid/high plus the estimate flagged as best), neighborhood market intel (median list price and days-on-market per neighborhood), a mortgage breakdown, and the full description โ€” not just the search-card summary. Turn it off for faster, cheaper search-only records. - **๐Ÿ’ต Price, valuation & history** โ€” structured list price, price-per-sqft, price-reduced amount, last-sold price/date, and a full price-history timeline. Detail mode adds independent value estimates (AVM) โ€” including the source's best-flagged estimate and neighborhood median pricing โ€” so you can rank listings against their estimated market value. - **๐Ÿ“‡ Agent & office contacts** โ€” every listing carries the listing agent, office, phone, and (opt-in) email, plus the full advertiser list โ€” structured fields ready for outreach or CRM import. - **๐Ÿง‘โ€๐Ÿ’ผ Listings + Agents in one actor** โ€” two modes from one actor. Default mode scrapes property listings; switch to Agents mode to scrape the real-estate agent directory for any location โ€” name, broker, office, star rating, recommendations, review count, and for-sale / recently-sold production stats per agent. Contact enrichment (on by default) adds each agent's direct & office phone, website, office address, license number, and social-media profiles. Ideal for B2B agent lead-gen. - **๐ŸŽฏ Multi-location search** โ€” pass several locations (city + state, ZIP codes, neighborhoods) in one run with a single shared dedup state. Filter by price, beds, baths, square footage, and property type โ€” and optionally a precise lat/long radius. - **โ™ป๏ธ Incremental mode** โ€” recurring runs emit and charge only for listings that are new or whose tracked content changed. First run builds the baseline; subsequent runs emit only NEW / UPDATED / REAPPEARED records (UNCHANGED + EXPIRED opt-in). Saves 80โ€“95% on daily monitoring. - **๐Ÿ”” Notifications** โ€” Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook out of the box. Pair with incremental for daily new-listing alerts without pipeline glue. - **๐Ÿ”— Paste-mode** โ€” build the search you want on realtor.com, copy the result-page URL, and paste it โ€” each URL's location and mode (for sale / sold / rent) are read from the URL. Mix in individual property URLs too; results dedupe by listing id. - **๐Ÿ“ฆ Compact mode** โ€” AI-agent and MCP-friendly payloads with core fields only. - **๐Ÿ“ค Export anywhere** โ€” Download the dataset as JSON, CSV, or Excel from the Apify Console, or stream live via the Apify API and integrations (Make, Zapier, Google Sheets, n8n, โ€ฆ). - **๐Ÿ”Œ MCP connectors** โ€” export your results into Notion via Apify's MCP connectors โ€” a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows. ### What data can you extract from Realtor.com? Each result includes Core listing fields (`listingId`, `propertyId`, `listingKey`, `title`, `url`, `portalUrl`, `permalink`, and `status`, and more), detail fields when enrichment is enabled (`description`, `descriptionHtml`, `descriptionMarkdown`, `descriptionLength`, and `details`), and contact information (`agentEmail`, `agentPhone`, `extractedEmails`, and `extractedPhones`). In standard mode, all fields are always present โ€” unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned. Enable detail enrichment in the input to get richer fields such as full descriptions and contact information where the source provides them. ### Input The main inputs are a search keyword and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`searchMode`** โ€” Which listings to scrape. (default: `"for_sale"`) - **`searchLocations`** โ€” One or more locations: "City, ST" (e.g. "Austin, TX"), a ZIP code (e.g. "78704"), or a neighborhood. Each is searched independently. Leave empty if you only use Start URLs. - **`propertyTypes`** โ€” Restrict to one or more property types. Leave empty for all types. (default: `[]`) - **`searchStatuses`** โ€” Include additional statuses alongside active for-sale listings. - **`keyword`** โ€” Optional text that must appear in the listing (e.g. "pool", "waterfront"). - **`startUrls`** โ€” Paste realtor.com search-result URLs (e.g. https://www.realtor.com/realestateandhomes-search/Austin_TX) or individual property URLs. Search URLs read their location + mode from the URL; the filters below still apply. - **`maxResults`** โ€” Maximum listings to return (0 = full coverage). Full coverage works even for very large markets. (default: `100`) - **`mode`** โ€” Listings (default) or Agents โ€” scrape the real-estate agent directory (name, broker, office, ratings, sales stats) for a location. (default: `"listings"`) - **`agentLocations`** โ€” Agents mode only: locations to find agents in โ€” "City, ST" (e.g. "Austin, TX") or a ZIP code. Each is searched independently. - **`agentType`** โ€” Agents mode: which side the agent represents. (default: `"BUYER"`) - **`agentLanguages`** โ€” Agents mode: filter by spoken language (e.g. "spanish"). - **`enrichAgentContacts`** โ€” Agents mode: fetch each agent's full contact profile โ€” direct & office phone, website, office address, license number, and social media. On by default. (default: `true`) - ...and 34 more parameters ### Input examples **Homes for sale in a city** โ€” Search one or more locations (city + state, ZIP code, or neighborhood). Detail enrichment is on by default. โ†’ Full listing records with price, beds/baths, sqft, address + GPS, photos, agent, plus price/tax history, schools, flood risk, value estimates, and mortgage. ```json { "searchMode": "for_sale", "searchLocations": [ "Austin, TX" ], "includeDetails": true, "maxResults": 100 } ```` **Condos for rent with a price ceiling** โ€” Filter by mode, property type, location, and a maximum monthly rent. โ†’ Rental listings within the price band, each with beds/baths, sqft, address, and agent contact. ```json { "searchMode": "for_rent", "searchLocations": [ "Miami, FL" ], "propertyTypes": [ "condo" ], "priceMax": 3000, "maxResults": 100 } ``` **Daily monitoring of a ZIP code** โ€” Re-run on a schedule to capture only new and changed listings in a ZIP code. โ†’ Records tagged NEW / UPDATED / EXPIRED against the previous run. ```json { "searchMode": "for_sale", "searchLocations": [ "78704" ], "incrementalMode": true, "stateKey": "austin-78704-for-sale", "maxResults": 500 } ``` **Compact output for AI pipelines** โ€” Return only the core comparison fields for a smaller, faster export โ€” detail enrichment off. โ†’ Core fields only (id, URL, status, price, beds/baths, sqft, address, GPS) โ€” ideal for large exports and LLM context. ```json { "searchMode": "for_sale", "searchLocations": [ "Dallas, TX" ], "includeDetails": false, "compact": true, "maxResults": 100 } ``` **Paste a search URL** โ€” Build the search you want on realtor.com, copy the result-page URL, and paste it. The location and mode are read from the URL. โ†’ The listings from exactly that search, merged and deduplicated. ```json { "startUrls": [ "https://www.realtor.com/realestateandhomes-search/Seattle_WA" ], "maxResults": 100 } ``` ### Output Each run produces a dataset of structured property records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. ### Example property record ```json { "listingId": "a6751a0df5a4aedb2550b276f01b5d191f753d0103ce629c9ae6f1567db8c532", "propertyId": "9806965207", "listingKey": "2997508304", "title": "610 Davis St Unit 4304, Austin, TX", "url": "https://www.realtor.com/realestateandhomes-detail/610-Davis-St-Unit-4304_Austin_TX_78701_M98069-65207", "portalUrl": "https://www.realtor.com/realestateandhomes-detail/610-Davis-St-Unit-4304_Austin_TX_78701_M98069-65207", "permalink": "610-Davis-St-Unit-4304_Austin_TX_78701_M98069-65207", "status": "for_sale", "statusDisplay": "for sale", "addressLine": "610 Davis St Unit 4304", "addressUnit": "Unit 4304", "streetNumber": "610", "streetName": "Davis", "streetSuffix": "St", "city": "Austin", "stateCode": "TX", "state": "Texas", "postalCode": "78701", "county": "Travis", "countyFips": "48453", "latitude": 30.260347, "longitude": -97.738564, "propertyType": "condos", "propertySubType": "condo", "beds": 3, "bathsTotal": 3.5, "bathsFull": 3, "bathsHalf": 1, "sqft": 2324, "stories": 1, "yearBuilt": 2025, "garage": 2, "listPrice": 3240000, "priceCurrency": "USD", "pricePerSqft": 1394, "daysOnMarket": 0, "listDate": "2026-06-20T16:18:01.000000Z", "lastUpdateDate": "2026-06-20T16:37:10Z", "hoaFee": 1789, "isNewListing": true, "isNewConstruction": true, "description": "This expansive northwest corner residence with 3 bedrooms, 3.5 baths + study on the 43rd floor of The Modern Austin Residences offers over 2,300 sqft of refined interior living space and a 222 sqft pr...", "descriptionLength": 1769, "tags": [ "central_air", "central_heat", "city_view", "community_clubhouse", "community_outdoor_space", "community_park", "community_security_features", "community_spa_or_hot_tub", "dishwasher", "hardwood_floors", "lake_view", "laundry_room", "new_construction", "recreation_facilities", "view", "water_view", "community_swimming_pool", "single_story", "garage_1_or_more", "garage_2_or_more", "ensuite", "views", "lake", "trails", "wet_bar", "chefs_kitchen", "open_concept", "walk_in_closet", "balcony", "den", "soaking_tub", "park" ], "thumbnail": "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2176693882s.jpg", "photoCount": 36, "photos": [ "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2176693882s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m4140371794s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m351204148s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3202454114s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3961784523s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3569491785s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3180779946s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m485634804s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m932408458s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1603310279s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m943501060s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2750382660s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m335343491s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3793766494s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1863649859s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3051565870s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1682035501s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2196877312s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2873801781s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3131301532s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3319765654s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2655586575s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1405807763s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1401728886s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1099678592s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3247927459s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2816601268s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m4021581508s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1526240031s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2435422604s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3239679010s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m3038094640s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m594926591s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m308205670s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m1130865802s.jpg", "http://ap.rdcpix.com/b014f7f5aeb7d0eced97a5b97e1be2a0l-m2220489755s.jpg" ], "agentName": "Kevin Burns", "agentEmail": "kevin@urbanspacerealtors.com", "agentPhone": "5128488722", "agentHref": "http://www.urbanspacerealtors.com", "officeName": "Urbanspace", "advertisers": [ { "type": "seller", "name": "Kevin Burns", "email": "kevin@urbanspacerealtors.com", "phones": [ "5128488722" ], "officeName": "Urbanspace", "href": "http://www.urbanspacerealtors.com" }, { "type": "co_seller", "name": "Joanie Preston", "email": "ea@urbanspacelifestyle.com", "phones": [ "5126261427" ], "officeName": "Urbanspace" } ], "propertyHistory": [ { "date": "2026-06-20", "event": "Listed", "price": 3240000, "pricePerSqft": 1394.1480206540448, "sourceName": "UnlockMLS" }, { "date": "2026-05-16", "event": "Listing removed", "price": 0, "sourceName": "UnlockMLS" }, { "date": "2025-12-18", "event": "Price Changed", "price": 3085000, "pricePerSqft": 1327.4526678141135, "sourceName": "UnlockMLS" }, { "date": "2025-11-25", "event": "Price Changed", "price": 3500000, "pricePerSqft": 1506.0240963855422, "sourceName": "UnlockMLS" }, { "date": "2025-11-06", "event": "Listed", "price": 3630000, "pricePerSqft": 1561.962134251291, "sourceName": "UnlockMLS" } ], "estimateCurrent": 3465000, "estimateHigh": 4123400, "estimateLow": 2806700, "estimateBest": 3465000, "estimateBestSource": "Collateral Analytics", "estimates": [ { "source": "Collateral Analytics", "estimate": 3465000, "estimateHigh": 4123400, "estimateLow": 2806700, "date": "2026-05-15" }, { "source": "Quantarium", "estimate": 2876794, "estimateHigh": 3078169, "estimateLow": 2675418, "date": "2026-06-17" } ], "mortgageMonthlyPayment": 25122, "mortgagePropertyTaxRate": 0.0196, "neighborhoods": [ { "name": "Central Austin", "slug": "Central-Austin_Austin_TX", "medianListingPrice": 642500, "medianDaysOnMarket": 66 }, { "name": "Downtown Austin", "slug": "Downtown-Austin_Austin_TX", "medianListingPrice": 792000, "medianDaysOnMarket": 80 }, { "name": "Rainey Street District", "slug": "Rainey-Street-District_Austin_TX", "medianListingPrice": 1093300, "medianDaysOnMarket": 97 } ], "schools": [ { "name": "Mathews Elementary School", "rating": 10, "fundingType": "public", "educationLevels": [ "elementary" ], "distanceMiles": 1.8 }, { "name": "Austin High School", "rating": 7, "fundingType": "public", "educationLevels": [ "high" ], "distanceMiles": 1.9 }, { "name": "O Henry Middle School", "rating": 6, "fundingType": "public", "educationLevels": [ "middle" ], "distanceMiles": 2.8 }, { "name": "Austin City Academy", "fundingType": "private", "educationLevels": [ "elementary", "middle", "high" ], "distanceMiles": 0.5 } ], "details": { "Bedrooms": [ "Bedrooms: 3", "Bedrooms On Main Level: 3" ], "Bathrooms": [ "Total Bathrooms: 4", "Full Bathrooms: 3", "1/2 Bathrooms: 1" ], "Interior Features": [ "Two Primary Baths", "Two Primary Suties", "Bar", "Quartz Counters", "Double Vanity", "High Speed Internet", "Kitchen Island", "Multiple Living Areas", "No Interior Steps", "Walk-In Closet(s)", "Wet Bar", "Flooring: Tile, Wood" ], "Appliances": [ "Cooktop", "Dishwasher", "Oven", "Refrigerator", "Wine Refrigerator", "Laundry Features: Laundry Room" ], "Heating and Cooling": [ "Cooling Features: Central Air", "Heating Features: Central", "Heating: Yes", "Number of Fireplaces: 0" ], "Exterior and Lot Features": [ "Balcony" ], "Garage and Parking": [ "Covered Spaces: 2", "Garage Spaces: 2", "Parking Features: Garage, Gated, Reserved", "Parking Total: 2" ], "Land Info": [ "Lot Description: City Lot" ], "Home Features": [ "View: City, Hill Country, Lake, Panoramic, Skyline, Water", "Security Features: Fire Alarm, Key Card Entry, Secured Garage/Parking, Smoke Detector(s)" ], "Homeowners Association": [ "Association: Yes", "Association Fee: 1789", "Association Fee Frequency: Monthly", "Association Fee Includes: Common Area Maintenance, Maintenance Structure, Sewer, Trash", "Calculated Total Monthly Association Fees: 1789", "Association Name: The Modern Austin Residences" ], "School Information": [ "Elementary School: Mathews", "High School: Austin", "High School District: Austin ISD", "Middle School: O Henry", "School District: Austin ISD" ], "Amenities and Community Features": [ "Community Features: BBQ Pit/Grill, Bike Storage/Locker, Cluster Mailbox, Common Grounds, Concierge, Conference/Meeting Room, Controlled Access, Dog Park, Fitness Center, Garage Parking, High Speed Int..." ], "Other Property Info": [ "Source Listing Status: Active", "County: Travis", "Directions: From Mopac exit Cesar Chavez, right on Red River, left on Davis.", "Tax Year: 2025", "Restrictions: Lease", "Source Property Type: Residential", "Area: DT", "Property Subtype: condo", "Source Neighborhood: The Modern Austin Residences", "Ownership Type: Common", "Parcel Number: 1001933", "Subdivision: The Modern Austin Residences", "Property Subtype: Condominium" ], "Building and Construction": [ "Total Square Feet Living: 2324", "Year Built: 2025", "Builder Name: Flintco", "Direction Faces: Northwest", "Levels: One", "Living Area Source: Builder", "New Construction: Yes", "Property Age: 1", "Property Condition: New Construction", "Levels or Stories: One", "House Style: Single level Floor Plan, Tower (14+ Stories)", "Total Area Sqft: 2324", "Year Built Source: Builder" ], "Utilities": [ "Sewer: Public Sewer", "Cable Available", "Electricity Available", "High Speed Internet", "Phone Available", "Sewer Available", "Water Available", "Water Source: Public" ] }, "sourceName": "AUTX", "sourceListingId": "2997508304", "sourceType": "mls", "sourceDomain": "realtor.com", "searchLocation": "Austin, TX", "scrapedAt": "2026-06-20T18:06:42.635Z", "contentQuality": "full", "contentHash": "48ff9cec1db3cc807a037efb082c654ffce87ed86c359ca9ca50deb5c3c84843", "trackedHash": "d1e0b223a06de4c96bec0331a56ae5999549cc8434404703483d3ae5b7d0b3b1" } ``` ### Incremental fields When incremental mode is on, each record also carries: - `changeType` โ€” one of `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, `EXPIRED`. Default output covers `NEW` / `UPDATED` / `REAPPEARED`; set `emitUnchanged: true` or `emitExpired: true` to opt into the others. - `firstSeenAt`, `lastSeenAt` โ€” ISO-8601 timestamps tracking the listing across runs. - `isRepost`, `repostOfId`, `repostDetectedAt` โ€” populated when a new listing matches the tracked content of a previously expired one. Set `skipReposts: true` to drop detected reposts from the output. ### How to scrape Realtor.com 1. Go to [Realtor Scraper](https://apify.com/blackfalcondata/realtor-scraper?fpr=1h3gvi) in Apify Console. 2. Enter a search keyword. 3. Set `maxResults` to control how many results you need. 4. Enable `includeDetails` if you need full descriptions, contact info. 5. Click **Start** and wait for the run to finish. 6. Export the dataset as JSON, CSV, or Excel. ### Use cases - Extract property data from Realtor.com for market research and competitive analysis. - Track pricing trends across regions and categories over time. - Monitor new and changed listings on scheduled runs without processing the full dataset every time. - Use structured location data for regional analysis, mapping, and geo-targeting. - Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode. - Export clean, structured data to dashboards, spreadsheets, or data warehouses. ### How much does it cost to scrape Realtor.com? Realtor Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced. - **Run start:** $0.003 per run - **Per property (primary event):** $0.0012 You are billed only for the events your run actually triggers. Prices below are the Free plan tier. | Event | Price (Free tier) | Charged when | |---|---|---| | Actor Start | $0.003 (one-time) | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). | | Result (primary) | $0.0012 | Single listing in the default dataset. | | Detail enrichment | $0.0008 | Charged per listing enriched with full detail (price/tax history, schools, flood risk, value estimates, mortgage). Only when Include Detail Enrichment is on. | | Email match | $0.002 | Charged per listing where a contact email was discovered. Only when Discover Contact Emails is on. | Example costs (primary event only โ€” other events above add cost when they fire): - 10 results: **$0.015** - 25 results: **$0.033** - 100 results: **$0.12** - 200 results: **$0.24** - 500 results: **$0.6** #### Example: recurring monitoring savings These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of listings that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency โ€” the scenarios below are examples, not predictions. Example setup: 250 results per run, daily polling (30 runs/month). Event-pricing examples scale linearly with result count. Numbers below are for the primary **Result** event. Other events (**Detail enrichment**, **Email match**) are billed separately when they fire. | Churn rate | Full re-scrape run cost | Incremental run cost | Savings vs full re-scrape | Monthly cost after baseline | |---|---:|---:|---:|---:| | 5% โ€” stable niche query | $0.30 | $0.02 | $0.28 (94%) | $0.54 | | 15% โ€” moderate broad query | $0.30 | $0.05 | $0.26 (84%) | $1.44 | | 30% โ€” high-volume aggregator | $0.30 | $0.09 | $0.21 (69%) | $2.79 | Full re-scrape monthly cost at daily polling: $9.09. First month with incremental costs $0.82 / $1.70 / $3.00 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply. Platform usage (compute and proxies) is billed separately by Apify based on actual consumption. Incremental runs consume less on result processing, though fixed per-run overhead stays the same. ### FAQ #### How many results can I get from Realtor.com? The number of results depends on the search query and available listings on Realtor.com. Use the `maxResults` parameter to control how many results are returned per run. #### Does Realtor Scraper support recurring monitoring? Yes. Enable incremental mode to only receive new or changed listings on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset. #### Can I integrate Realtor Scraper with other apps? Yes. Realtor Scraper works with Apify's [integrations](https://apify.com/integrations?fpr=1h3gvi) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes. #### Can I use Realtor Scraper with the Apify API? Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages. #### Can I use Realtor Scraper through an MCP Server? Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server?fpr=1h3gvi) that lets AI assistants and agents call this actor directly. Use compact mode, `descriptionMaxLength`, a single `descriptionFormat`, and `excludeEmptyFields` to keep payloads manageable for LLM context windows. #### Is it legal to scrape Realtor.com? This actor extracts publicly available data from Realtor.com. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant. #### Your feedback If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/realtor-scraper/issues?fpr=1h3gvi) on the actor's page in Apify Console. Your feedback helps us improve. ### You might also like - [Idealista Scraper โ€” Spain, Portugal & Italy](https://apify.com/blackfalcondata/idealista-scraper?fpr=1h3gvi) โ€” Scrape idealista.com / .pt / .it property listings with prices, photos, GPS, agent phone numbers. - [Immowelt Scraper โ€” German Real Estate Listings](https://apify.com/blackfalcondata/immowelt-scraper?fpr=1h3gvi) โ€” Scrape immowelt.de โ€” one of Germany's largest residential property portals โ€” and pull every active. - [Metrocuadrado Scraper โ€” Colombia Real Estate Listings](https://apify.com/blackfalcondata/metrocuadrado-scraper?fpr=1h3gvi) โ€” Scrape Metrocuadrado property listings across Colombia with full pricing, price-per-mยฒ, area,. - [Realtor.com Agents Scraper โ€” Agent Directory & Leads](https://apify.com/blackfalcondata/realtor-agents-scraper?fpr=1h3gvi) โ€” Scrape realtor.com's real-estate agent directory for any US city or ZIP โ€” name, broker, office,. ### Getting started with Apify New to Apify? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=1h3gvi\&fp_sid=ctaplain) โ€” no credit card required. 1. Sign up โ€” $5 platform credit included 2. Open this actor and configure your input 3. Click **Start** โ€” export results as JSON, CSV, or Excel Need more later? [See Apify pricing](https://apify.com/pricing?fpr=1h3gvi). # Actor input Schema ## `searchMode` (type: `string`): Which listings to scrape. ## `searchLocations` (type: `array`): One or more locations: "City, ST" (e.g. "Austin, TX"), a ZIP code (e.g. "78704"), or a neighborhood. Each is searched independently. Leave empty if you only use Start URLs. ## `propertyTypes` (type: `array`): Restrict to one or more property types. Leave empty for all types. ## `searchStatuses` (type: `array`): Include additional statuses alongside active for-sale listings. ## `keyword` (type: `string`): Optional text that must appear in the listing (e.g. "pool", "waterfront"). ## `startUrls` (type: `array`): Paste realtor.com search-result URLs (e.g. https://www.realtor.com/realestateandhomes-search/Austin\_TX) or individual property URLs. Search URLs read their location + mode from the URL; the filters below still apply. ## `maxResults` (type: `integer`): Maximum listings to return (0 = full coverage). Full coverage works even for very large markets. ## `mode` (type: `string`): Listings (default) or Agents โ€” scrape the real-estate agent directory (name, broker, office, ratings, sales stats) for a location. ## `agentLocations` (type: `array`): Agents mode only: locations to find agents in โ€” "City, ST" (e.g. "Austin, TX") or a ZIP code. Each is searched independently. ## `agentType` (type: `string`): Agents mode: which side the agent represents. ## `agentLanguages` (type: `array`): Agents mode: filter by spoken language (e.g. "spanish"). ## `enrichAgentContacts` (type: `boolean`): Agents mode: fetch each agent's full contact profile โ€” direct & office phone, website, office address, license number, and social media. On by default. ## `priceMin` (type: `integer`): Minimum listing price. ## `priceMax` (type: `integer`): Maximum listing price. ## `bedsMin` (type: `integer`): Minimum number of bedrooms. ## `bedsMax` (type: `integer`): Maximum number of bedrooms. ## `bathsMin` (type: `integer`): Minimum number of bathrooms. ## `sqftMin` (type: `integer`): Minimum interior square footage. ## `sqftMax` (type: `integer`): Maximum interior square footage. ## `centerLat` (type: `string`): Optional radius filter โ€” center latitude (decimal, e.g. 30.2672). Combine with Center Longitude + Radius to keep only listings within the radius. ## `centerLng` (type: `string`): Radius filter โ€” center longitude (decimal, e.g. -97.7431). ## `radiusKm` (type: `integer`): Keep only listings within this many kilometres of the center point. ## `includeDetails` (type: `boolean`): Fetch each listing's full detail: price history, tax history, schools, flood risk, value estimates (AVM), mortgage breakdown, and full description. On by default. Turn off for faster, cheaper search-only records. ## `enrichEmails` (type: `boolean`): Best-effort agent/advertiser email discovery (billed per listing with a match). ## `descriptionMaxLength` (type: `integer`): Truncate description to this many characters. 0 = no truncation. ## `descriptionFormat` (type: `string`): Keep one description representation and drop the others to shrink payload. ## `excludeEmptyFields` (type: `boolean`): Drop null / empty-string / empty-array fields from each record. ## `compact` (type: `boolean`): Output only core comparison fields (for AI-agent / MCP workflows). ## `incrementalMode` (type: `boolean`): Track new/changed/expired listings across runs. Requires a State Key. ## `stateKey` (type: `string`): Stable identifier for this tracking universe (e.g. "austin-tx-for-sale"). ## `emitUnchanged` (type: `boolean`): When incremental, also emit listings that have not changed. ## `emitExpired` (type: `boolean`): When incremental, also emit listings no longer found (now off-market). These off-market markers are always included so change tracking stays complete โ€” they are not subject to Max Results. ## `skipReposts` (type: `boolean`): When incremental, skip listings that are reposts of previously seen (now expired) listings. ## `telegramToken` (type: `string`): Telegram bot token (from @BotFather). Required for Telegram notifications. ## `telegramChatId` (type: `string`): Telegram chat or channel ID where alerts are sent. ## `discordWebhookUrl` (type: `string`): Discord incoming webhook URL. ## `slackWebhookUrl` (type: `string`): Slack incoming webhook URL. ## `whatsappPhoneNumberId` (type: `string`): WhatsApp Business phone number ID from Meta Business Manager. ## `whatsappAccessToken` (type: `string`): Meta Cloud API access token with whatsapp\_business\_messaging scope. ## `whatsappTo` (type: `string`): Recipient phone number in E.164 format (e.g. +14155551234). ## `webhookUrl` (type: `string`): Universal escape hatch for n8n / Make / Zapier / custom HTTP backends. Receives a JSON POST per run. ## `webhookHeaders` (type: `object`): Additional HTTP headers sent with the generic webhook POST. ## `notificationLimit` (type: `integer`): Maximum number of listings included in each notification message (1โ€“20). ## `notifyOnlyChanges` (type: `boolean`): When Incremental Mode is on, only notify for NEW and UPDATED listings. ## `appConnector` (type: `string`): Optional. Pick a connected app under Settings โ†’ API & Integrations to receive your results (including contact details where available). A run-summary is written to the connected app; support is best-effort as Apify expands its connector catalog. ## `mcpIssueTeam` (type: `string`): Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one. ## Actor input object example ```json { "searchMode": "for_sale", "searchLocations": [ "Austin, TX" ], "propertyTypes": [], "startUrls": [], "maxResults": 10, "mode": "listings", "agentLocations": [], "agentType": "BUYER", "agentLanguages": [], "enrichAgentContacts": true, "includeDetails": true, "enrichEmails": false, "descriptionMaxLength": 0, "descriptionFormat": "text", "excludeEmptyFields": false, "compact": false, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "skipReposts": false, "notificationLimit": 5, "notifyOnlyChanges": false } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchLocations": [ "Austin, TX" ], "propertyTypes": [], "startUrls": [], "maxResults": 10, "agentLocations": [], "agentLanguages": [], "includeDetails": false }; // Run the Actor and wait for it to finish const run = await client.actor("blackfalcondata/realtor-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchLocations": ["Austin, TX"], "propertyTypes": [], "startUrls": [], "maxResults": 10, "agentLocations": [], "agentLanguages": [], "includeDetails": False, } # Run the Actor and wait for it to finish run = client.actor("blackfalcondata/realtor-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 '{ "searchLocations": [ "Austin, TX" ], "propertyTypes": [], "startUrls": [], "maxResults": 10, "agentLocations": [], "agentLanguages": [], "includeDetails": false }' | apify call blackfalcondata/realtor-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=blackfalcondata/realtor-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Realtor Scraper โ€” US Real Estate Listings & Property Data", "description": "Scrape US real estate from realtor.com โ€” for-sale, for-rent & recently-sold listings with price & tax history, schools, flood risk, value estimates (AVM), mortgage breakdown, agent contacts, photos, GPS, full filters, radius search, and incremental NEW/UPDATED/EXPIRED tracking.", "version": "0.1", "x-build-id": "rVDvxvfaviuigO5pt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~realtor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-realtor-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/blackfalcondata~realtor-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-realtor-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/blackfalcondata~realtor-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-realtor-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": { "searchMode": { "title": "๐Ÿ” Search Mode", "enum": [ "for_sale", "for_rent", "sold" ], "type": "string", "description": "Which listings to scrape.", "default": "for_sale" }, "searchLocations": { "title": "๐Ÿ“ Locations", "type": "array", "description": "One or more locations: \"City, ST\" (e.g. \"Austin, TX\"), a ZIP code (e.g. \"78704\"), or a neighborhood. Each is searched independently. Leave empty if you only use Start URLs.", "items": { "type": "string" } }, "propertyTypes": { "title": "๐Ÿ  Property Types", "type": "array", "description": "Restrict to one or more property types. Leave empty for all types.", "items": { "type": "string", "enum": [ "single_family", "condo", "townhomes", "multi_family", "duplex_triplex", "mobile", "land", "farm" ], "enumTitles": [ "Single family", "Condo", "Townhome", "Multi-family", "Duplex/Triplex", "Mobile", "Land", "Farm" ] }, "default": [] }, "searchStatuses": { "title": "๐Ÿท๏ธ Extra Statuses (for-sale only)", "type": "array", "description": "Include additional statuses alongside active for-sale listings.", "items": { "type": "string", "enum": [ "pending", "contingent", "coming_soon" ], "enumTitles": [ "Pending", "Contingent", "Coming soon" ] } }, "keyword": { "title": "๐Ÿ”ค Keyword", "type": "string", "description": "Optional text that must appear in the listing (e.g. \"pool\", \"waterfront\")." }, "startUrls": { "title": "๐Ÿ”— Start URLs", "type": "array", "description": "Paste realtor.com search-result URLs (e.g. https://www.realtor.com/realestateandhomes-search/Austin_TX) or individual property URLs. Search URLs read their location + mode from the URL; the filters below still apply.", "items": { "type": "string" } }, "maxResults": { "title": "๐Ÿ’ฏ Max Results", "minimum": 0, "type": "integer", "description": "Maximum listings to return (0 = full coverage). Full coverage works even for very large markets.", "default": 100 }, "mode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "listings", "agents" ], "type": "string", "description": "Listings (default) or Agents โ€” scrape the real-estate agent directory (name, broker, office, ratings, sales stats) for a location.", "default": "listings" }, "agentLocations": { "title": "๐Ÿ“ Agent Locations", "type": "array", "description": "Agents mode only: locations to find agents in โ€” \"City, ST\" (e.g. \"Austin, TX\") or a ZIP code. Each is searched independently.", "items": { "type": "string" } }, "agentType": { "title": "๐Ÿค Agent Type", "enum": [ "BUYER", "SELLER" ], "type": "string", "description": "Agents mode: which side the agent represents.", "default": "BUYER" }, "agentLanguages": { "title": "๐Ÿ—ฃ๏ธ Agent Languages", "type": "array", "description": "Agents mode: filter by spoken language (e.g. \"spanish\").", "items": { "type": "string" } }, "enrichAgentContacts": { "title": "๐Ÿ“‡ Enrich Agent Contacts", "type": "boolean", "description": "Agents mode: fetch each agent's full contact profile โ€” direct & office phone, website, office address, license number, and social media. On by default.", "default": true }, "priceMin": { "title": "๐Ÿ’ฐ Min Price (USD)", "minimum": 0, "type": "integer", "description": "Minimum listing price." }, "priceMax": { "title": "๐Ÿ’ฐ Max Price (USD)", "minimum": 0, "type": "integer", "description": "Maximum listing price." }, "bedsMin": { "title": "๐Ÿ›๏ธ Min Bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms." }, "bedsMax": { "title": "๐Ÿ›๏ธ Max Bedrooms", "minimum": 0, "type": "integer", "description": "Maximum number of bedrooms." }, "bathsMin": { "title": "๐Ÿ› Min Bathrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bathrooms." }, "sqftMin": { "title": "๐Ÿ“ Min Sqft", "minimum": 0, "type": "integer", "description": "Minimum interior square footage." }, "sqftMax": { "title": "๐Ÿ“ Max Sqft", "minimum": 0, "type": "integer", "description": "Maximum interior square footage." }, "centerLat": { "title": "๐Ÿงญ Center Latitude", "type": "string", "description": "Optional radius filter โ€” center latitude (decimal, e.g. 30.2672). Combine with Center Longitude + Radius to keep only listings within the radius." }, "centerLng": { "title": "๐Ÿงญ Center Longitude", "type": "string", "description": "Radius filter โ€” center longitude (decimal, e.g. -97.7431)." }, "radiusKm": { "title": "๐Ÿ“ Radius (km)", "minimum": 0, "type": "integer", "description": "Keep only listings within this many kilometres of the center point." }, "includeDetails": { "title": "๐Ÿ“‹ Include Detail Enrichment", "type": "boolean", "description": "Fetch each listing's full detail: price history, tax history, schools, flood risk, value estimates (AVM), mortgage breakdown, and full description. On by default. Turn off for faster, cheaper search-only records.", "default": true }, "enrichEmails": { "title": "๐Ÿ“ง Discover Contact Emails", "type": "boolean", "description": "Best-effort agent/advertiser email discovery (billed per listing with a match).", "default": false }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to this many characters. 0 = no truncation.", "default": 0 }, "descriptionFormat": { "title": "๐Ÿ“ Description Format", "enum": [ "text", "html", "markdown" ], "type": "string", "description": "Keep one description representation and drop the others to shrink payload.", "default": "text" }, "excludeEmptyFields": { "title": "๐Ÿงน Exclude Empty Fields", "type": "boolean", "description": "Drop null / empty-string / empty-array fields from each record.", "default": false }, "compact": { "title": "๐Ÿ“ฆ Compact Output", "type": "boolean", "description": "Output only core comparison fields (for AI-agent / MCP workflows).", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental Mode", "type": "boolean", "description": "Track new/changed/expired listings across runs. Requires a State Key.", "default": false }, "stateKey": { "title": "๐Ÿ”‘ State Key", "type": "string", "description": "Stable identifier for this tracking universe (e.g. \"austin-tx-for-sale\")." }, "emitUnchanged": { "title": "โ™ป๏ธ Emit Unchanged Records", "type": "boolean", "description": "When incremental, also emit listings that have not changed.", "default": false }, "emitExpired": { "title": "โšฐ๏ธ Emit Expired Records", "type": "boolean", "description": "When incremental, also emit listings no longer found (now off-market). These off-market markers are always included so change tracking stays complete โ€” they are not subject to Max Results.", "default": false }, "skipReposts": { "title": "๐Ÿšซ Skip Reposts", "type": "boolean", "description": "When incremental, skip listings that are reposts of previously seen (now expired) listings.", "default": false }, "telegramToken": { "title": "๐Ÿ”‘ Telegram Bot Token", "type": "string", "description": "Telegram bot token (from @BotFather). Required for Telegram notifications." }, "telegramChatId": { "title": "๐Ÿ’ฌ Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID where alerts are sent." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL." }, "whatsappPhoneNumberId": { "title": "๐Ÿ“ฑ WhatsApp Phone Number ID", "type": "string", "description": "WhatsApp Business phone number ID from Meta Business Manager." }, "whatsappAccessToken": { "title": "๐Ÿ” WhatsApp Access Token", "type": "string", "description": "Meta Cloud API access token with whatsapp_business_messaging scope." }, "whatsappTo": { "title": "๐Ÿ“จ WhatsApp Recipient", "type": "string", "description": "Recipient phone number in E.164 format (e.g. +14155551234)." }, "webhookUrl": { "title": "๐Ÿช Generic Webhook URL", "type": "string", "description": "Universal escape hatch for n8n / Make / Zapier / custom HTTP backends. Receives a JSON POST per run." }, "webhookHeaders": { "title": "๐Ÿช Webhook Headers (optional)", "type": "object", "description": "Additional HTTP headers sent with the generic webhook POST." }, "notificationLimit": { "title": "๐Ÿ“Š Max Listings Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of listings included in each notification message (1โ€“20).", "default": 5 }, "notifyOnlyChanges": { "title": "๐Ÿ”„ Notify Only New/Updated", "type": "boolean", "description": "When Incremental Mode is on, only notify for NEW and UPDATED listings.", "default": false }, "appConnector": { "title": "๐Ÿ“ค Send results to a connected app", "type": "string", "description": "Optional. Pick a connected app under Settings โ†’ API & Integrations to receive your results (including contact details where available). A run-summary is written to the connected app; support is best-effort as Apify expands its connector catalog." }, "mcpIssueTeam": { "title": "๐Ÿท๏ธ Issue tracker team", "type": "string", "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one." } } }, "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 } } } } } } } } } } ```