# Zumper Property Search Scraper (`stealth_mode/zumper-property-search-scraper`) Actor Scrape rental property listings from Zumper.com with 70+ data fields per result — including pricing, amenities, agent info, location, and availability. Perfect for real estate analysts, investors, and proptech developers needing structured rental market data. - **URL**: https://apify.com/stealth\_mode/zumper-property-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Developer tools, Automation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zumper.com Property Search Scraper: Extract Rental Listings at Scale --- ### What Is Zumper.com? Zumper is one of the largest rental listing platforms in the United States, aggregating apartments, houses, and rooms for rent across hundreds of cities. It serves both renters and property managers, making it a rich source of real-time rental market intelligence. Manually collecting listing data from Zumper is impractical at scale. The **Zumper Property Search Scraper** automates extraction from search result pages, returning structured records with 70+ fields per listing — covering everything from pricing and floor plans to agent contacts and building amenities. --- ### Overview This scraper targets Zumper's property search result pages and extracts detailed listing records in bulk. It is built for: - **Real estate analysts** monitoring rental price trends by neighborhood or city - **Proptech developers** feeding listing data into aggregator platforms or recommendation engines - **Property investors** researching market availability and pricing across regions - **Researchers** studying housing supply, demand, and affordability patterns Key capabilities include configurable item limits per URL, resilient error handling via `ignore_url_failures`, and support for paginated search URLs. --- ### Input Format The scraper accepts a JSON configuration object with three parameters: ```json { "urls": [ "https://www.zumper.com/apartments-for-rent/new-york-ny?page=2" ], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Zumper property search page URLs. Supports pagination — append `?page=N` to iterate through results. Add URLs one by one or paste a bulk list. | | `ignore_url_failures` | `boolean` | If `true`, the scraper skips failed URLs and continues the run rather than stopping. Recommended for bulk jobs. Default: `true`. | | `max_items_per_url` | `integer` | Maximum listings to collect per URL. Default prefill: `20`. Set higher (e.g., `50`) for denser pages. | > **Tip:** To collect listings across multiple pages, add each paginated URL separately (e.g., `?page=1`, `?page=2`, `?page=3`). You can also filter by city, bedroom count, or price range directly in the Zumper search URL before pasting it into the input. *** ### Output Format **Sample output** ```json { "is_featured": false, "listing_id": 64289595, "created_on": 1778115961, "modified_on": 1778148012, "listed_on": 1778115961, "listing_status": 1, "group_id": 64289595, "address": "246 Pearl St #1202", "city": "New York", "lat": 40.707626, "lng": -74.004648, "pets": [], "leasing_fee": null, "building_id": null, "feed_name": "realty_mx", "image_ids": [ 896723154, 896723155, 896723156, 896723157, 896723158 ], "neighborhood_id": 114, "neighborhood_name": "Financial District", "brokerage_id": 74063, "agent_id": 684121, "agent_name": "Leonardo Mora", "brokerage_name": "The Bouklis Group Real Estate", "state": "NY", "building_name": null, "tz": "America/New_York", "promotion": 65, "city_state": "new-york-ny", "zappable": 1, "property_type": 4, "amenities": [ 1, 2, 4, 7, 10, 11, 15, 22 ], "building_amenities": [ 17, 4, 13, 11, 14, 6, 3, 16, 2 ], "amenity_tags": [ "Air Conditioning", "River View", "Dishwasher", "Onsite Laundry", "Diplomats OK", "Deck", "Lounge", "Receiving Room", "Renovated", "Walk-in Closet", "WiFi", "Marble Bath", "Common Outdoor Space", "Business Center", "Roof Deck", "Health Club", "Light", "Dining Room", "Wheelchair Accessible", "High Ceilings", "Granite Kitchen", "Subway", "Hardwood Floor" ], "building_amenity_tags": [ "Onsite Laundry", "Dishwasher", "Hardwood Floor", "Walk-in Closet", "Concierge Service", "Fitness Center", "Residents Lounge", "Business Center", "Roof Deck", "Outdoor Space", "Wheelchair Accessible", "Elevator", "High Ceiling", "Door Attendant", "WiFi", "Lounge", "Renovated", "Health Club", "Dining Room", "River View", "Receiving Room", "Granite Kitchen", "Marble Bath", "Common Outdoor Space", "Subway", "Light", "Diplomats OK" ], "phone": null, "listing_type": 1, "pb_id": null, "pb_url": null, "url": "/listings/27526832p/2-bedroom-financial-district-new-york-ny", "padmapper_url": "/rentals/27526832p/3-bedroom-1-bath-apartment-at-246-pearl-st-new-york-ny-10038", "date_available": null, "max_price": 4900, "min_price": 4900, "previous_price": 4900, "max_bedrooms": 3, "min_bedrooms": 3, "max_bathrooms": 1, "min_bathrooms": 1, "floorplan_count": 1, "min_lease_days": 360, "max_lease_days": null, "min_square_feet": 9223372036854776000, "max_square_feet": -1, "lease_type": 13, "features": [ 88, 10, 19, 78 ], "zipcode": "10038", "is_pad": false, "max_all_bathrooms": [ 1, 0 ], "min_all_bathrooms": [ 1, 0 ], "pl_id": 27526832, "pl_url": "2-bedroom-financial-district-new-york-ny", "pa_url": "246-pearl-st-new-york-ny-10038-usa", "is_messageable": true, "provider_url": "https://bouklisgroup.com/index.cfm?page=details&id=251618", "internal_video_ids": null, "title": null, "short_description": "Discover this exceptional apartment, freshly available on the market and bathed in abundant natural light. Facing northeast, it offers breathtaking views of the iconic Brooklyn Bridge and the vibrant South Street Seaport, creating a serene urban retreat in the heart of Manhattan's Financial District (FiDi).Inside this converted 2 bedroom, you'll find newly installed hardwood floors that add warmth and elegance, complemented by a modern kitchen equipped with premium stainless-steel appliances. The luxurious marble bathroom provides a spa-like sanctuary for relaxation. Resid", "rating": 9.9, "pa_should_index": true, "integrated_tour_types": [], "external_rating": null, "has_fees": true, "from_url": "https://www.zumper.com/apartments-for-rent/new-york-ny?page=2" } ``` Each scraped listing returns a structured record with 70+ fields across the following categories: #### Listing Identity & Status | Field | Meaning | |---|---| | `Listing ID` | Unique Zumper identifier for the listing | | `Group ID` | ID grouping related floorplans or units under one property | | `Listing Status` | Current state of the listing (e.g., active, rented) | | `Listing Type` | Classification such as apartment, house, or room | | `Property Type` | Structural type of the property | | `Is Featured` | Whether the listing has paid featured placement | | `Is Pad` | Indicates if the listing is a Zumper Pad-style listing | | `Zappable` | Whether the listing supports Zumper's instant-apply (Zap) feature | | `Title` | Listing headline as shown on the search page | | `Short Description` | Brief summary of the property | #### Dates & Availability | Field | Meaning | |---|---| | `Created On` | Timestamp when the listing was first created | | `Modified On` | Last update timestamp | | `Listed On` | Date the listing went live on Zumper | | `Date Available` | Move-in availability date | #### Pricing | Field | Meaning | |---|---| | `Min Price` | Lowest monthly rent across available units | | `Max Price` | Highest monthly rent across available units | | `Previous Price` | Prior rent (useful for tracking price changes) | | `Leasing Fee` | Any applicable leasing or admin fee | | `Has Fees` | Boolean flag indicating whether the listing carries fees | | `Promotion` | Active promotional offer (e.g., first month free) | #### Location | Field | Meaning | |---|---| | `Address` | Street address of the property | | `City` | City name | | `State` | US state abbreviation | | `Zipcode` | Postal code | | `City State` | Combined city and state string (e.g., "New York, NY") | | `Latitude` | Geographic latitude coordinate | | `Longitude` | Geographic longitude coordinate | | `Timezone` | Property's local timezone | | `Neighborhood ID` | Internal ID of the neighborhood zone | | `Neighborhood Name` | Human-readable neighborhood label | #### Unit Specifications | Field | Meaning | |---|---| | `Min Bedrooms` | Minimum bedroom count across floorplans | | `Max Bedrooms` | Maximum bedroom count across floorplans | | `Min Bathrooms` | Minimum bathroom count | | `Max Bathrooms` | Maximum bathroom count | | `Min All Bathrooms` | Includes half-baths in minimum count | | `Max All Bathrooms` | Includes half-baths in maximum count | | `Min Square Feet` | Smallest unit size available | | `Max Square Feet` | Largest unit size available | | `Floorplan Count` | Number of distinct floorplan options | | `Min Lease Days` | Shortest lease term in days | | `Max Lease Days` | Longest lease term in days | | `Lease Type` | Lease classification (e.g., fixed, month-to-month) | #### Amenities & Features | Field | Meaning | |---|---| | `Amenities` | Unit-level amenities list (e.g., in-unit washer, dishwasher) | | `Building Amenities` | Shared building features (e.g., gym, rooftop, doorman) | | `Amenity Tags` | Structured tags for unit amenities used for filtering | | `Building Amenity Tags` | Structured tags for building-level amenities | | `Features` | Additional property features not covered by amenity tags | | `Pets` | Pet policy (e.g., cats allowed, dogs allowed, no pets) | #### Building & Agent Info | Field | Meaning | |---|---| | `Building ID` | Unique ID for the building record | | `Building Name` | Name of the building or complex | | `Feed Name` | Data feed source identifier (useful for deduplication) | | `Brokerage ID` | ID of the brokerage managing the listing | | `Brokerage Name` | Name of the brokerage or property management company | | `Agent ID` | Unique ID of the listing agent | | `Agent Name` | Full name of the responsible agent | | `Phone` | Contact phone number for inquiries | | `Is Messageable` | Whether in-app messaging is enabled for this listing | #### URLs & External Links | Field | Meaning | |---|---| | `URL` | Canonical Zumper listing URL | | `Padmapper URL` | Equivalent listing URL on Padmapper (Zumper's sister platform) | | `PB ID` / `PB URL` | Zumper building profile ID and URL | | `PL ID` / `PL URL` | Zumper listing profile ID and URL | | `PA URL` | Zumper apartment-level page URL | | `Provider URL` | Original source URL if the listing was syndicated | #### Media & Ratings | Field | Meaning | |---|---| | `Image IDs` | Array of image identifiers for the listing's photo gallery | | `Internal Video IDs` | IDs of any video tours hosted on Zumper | | `Integrated Tour Types` | Types of virtual or in-person tours available | | `Rating` | Zumper internal rating score | | `External Rating` | Rating sourced from third-party review platforms | #### Indexing & Visibility Flags | Field | Meaning | |---|---| | `PA Should Index` | Whether the apartment page is eligible for search engine indexing | *** ### How to Use 1. **Build your search URL** — Go to Zumper.com, apply filters (city, bedrooms, price), and copy the results page URL. 2. **Add pagination** — Append `?page=2`, `?page=3`, etc. to collect more listings. Add each page as a separate entry in `urls`. 3. **Set item limit** — Use `max_items_per_url` to control volume per page (max depends on Zumper's page size, typically 20–50). 4. **Enable fault tolerance** — Keep `ignore_url_failures: true` for multi-URL runs to prevent a single bad page from stopping the job. 5. **Run and export** — Download results as JSON or CSV for use in Excel, Google Sheets, or a database. **Common issues:** - If a URL returns no results, confirm it is a **search results page**, not an individual listing page. - Highly filtered searches may return fewer items than `max_items_per_url` — this is expected. - Price or availability data reflects the moment of scraping; re-run regularly for live market tracking. *** ### Use Cases & Business Value - **Rental market analysis:** Track average rents, availability, and pricing trends by neighborhood or city over time - **Competitive intelligence:** Monitor how landlords and property managers adjust pricing and promotions - **Lead generation:** Extract agent and brokerage contact information for outreach - **Aggregator feeds:** Power custom rental search platforms with fresh, structured listing data - **Investment research:** Identify high-demand areas based on listing volume, availability dates, and pricing spreads *** ### Conclusion The **Zumper Property Search Scraper** delivers one of the most comprehensive rental listing datasets available from any US rental platform — 70+ structured fields per listing, covering pricing, location, unit specs, amenities, agent details, and more. Whether you're building a proptech product or conducting market research, it eliminates manual data collection and puts reliable rental intelligence at your fingertips. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.zumper.com/apartments-for-rent/new-york-ny?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.zumper.com/apartments-for-rent/new-york-ny?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/zumper-property-search-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 = { "urls": ["https://www.zumper.com/apartments-for-rent/new-york-ny?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/zumper-property-search-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 '{ "urls": [ "https://www.zumper.com/apartments-for-rent/new-york-ny?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/zumper-property-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/zumper-property-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zumper Property Search Scraper", "description": "Scrape rental property listings from Zumper.com with 70+ data fields per result — including pricing, amenities, agent info, location, and availability. Perfect for real estate analysts, investors, and proptech developers needing structured rental market data.", "version": "0.0", "x-build-id": "PO0OSs7AG6zGKVH3s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~zumper-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-zumper-property-search-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/stealth_mode~zumper-property-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-zumper-property-search-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/stealth_mode~zumper-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-zumper-property-search-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": { "urls": { "title": "URLs of the property list urls to scrape", "type": "array", "description": "Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```