# Zumper Scraper - US Apartments & Rentals Data (`bujhmml/zumper-rentals-scraper`) Actor Scrape Zumper rentals by city: full price/bed/bath/sqft ranges, address, neighborhood, amenities, pets, photos, agent and brokerage contact, ratings and dates. Fast, HTTP-first, no browser. - **URL**: https://apify.com/bujhmml/zumper-rentals-scraper.md - **Developed by:** [Ihor Bielievskiy](https://apify.com/bujhmml) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.40 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zumper Scraper - US Apartments & Rentals Pull rental listings from [Zumper](https://www.zumper.com) by city. For every listing you get the full price and bedroom/bathroom ranges, square footage, address with neighborhood and zip, amenities, pet policy, photos, the listing agent and brokerage with a phone number, ratings, and the key dates - everything Zumper ships in its own search payload. No headless browser. Each city page embeds its complete search state as inline JSON, and the actor parses that directly, so it is fast and cheap to run. Requests use a real Chrome TLS fingerprint (via `curl_cffi`) to look like a browser. ### What you can scrape - Apartments, houses, condos, or rooms for rent in any US city Zumper covers. - Filter by price, bedrooms, bathrooms, and pet-friendliness without writing a single Zumper URL filter. - Cap results per city so a multi-city run samples evenly instead of draining the first city. ### Input | Field | Type | Description | |-------|------|-------------| | `startUrls` | array | Zumper for-rent URLs, e.g. `https://www.zumper.com/apartments-for-rent/san-francisco-ca`. Houses/condos/rooms paths and Zumper's own path filters are accepted. | | `citySlugs` | array | City slugs like `san-francisco-ca`, `austin-tx` (the part after the property-type path). Combined with the property type below. | | `propertyType` | string | `apartments` (default), `houses`, `condos`, or `rooms`. Decides the URL path built from each city slug. Ignored for full `startUrls`. | | `maxItems` | integer | Stop after this many listings across all cities. `0` = no limit. Default `100`. | | `maxItemsPerCity` | integer | Cap listings per city URL. `0` = no per-city cap. | | `minPrice` / `maxPrice` | integer | Keep listings whose monthly rent range overlaps this band. | | `minBeds` / `maxBeds` | integer | Bedroom range filter (`0` = studio). | | `minBaths` | integer | Minimum bathrooms. | | `petsAllowed` | boolean | Keep only listings that allow at least one pet type. | | `proxyConfiguration` | object | Apify Proxy. Datacenter is usually enough; switch to residential if you start seeing blocks. | | `impersonate` | string | curl_cffi browser fingerprint: `chrome` (default), `chrome131`, `chrome124`, `safari17_0`. | Provide at least one of `startUrls` or `citySlugs`. Pagination is automatic - the actor walks `?page=N` until a city runs out of listings. Price/bed/bath/pet filters are applied after fetch, so pagination and counts stay correct. Example input: ```json { "citySlugs": ["san-francisco-ca", "austin-tx"], "propertyType": "apartments", "minPrice": 2000, "maxPrice": 4000, "minBeds": 1, "petsAllowed": true, "maxItemsPerCity": 200, "maxItems": 500 } ```` ### Output One dataset item per rental listing: ```json { "listing_id": 58574913, "price_min": 3020.0, "price_max": 18280.0, "previous_price": null, "beds": 0.0, "max_beds": 3.0, "baths": 1.0, "max_baths": 2.0, "min_square_feet": 425, "max_square_feet": 1818, "floorplan_count": 54, "address": "149 San Francisco New Montgomery St", "building_name": "Blueground San Francisco", "building_id": 1717500, "city": "San Francisco", "state": "CA", "zipcode": "94105", "neighborhood_id": 247, "neighborhood_name": "SOMA", "timezone": "America/Los_Angeles", "lat": 37.78714246632131, "lng": -122.39963719035394, "property_type": 2, "listing_type": 1, "listing_status": 1, "lease_type": 1, "min_lease_days": 30, "max_lease_days": null, "leasing_fee": 0.0, "has_fees": false, "promotion": 100, "amenities": [32, 1, 2, 5, 6], "amenity_tags": ["Smoke Detector", "Stove", "Blender"], "building_amenities": [8, 13, 11], "building_amenity_tags": ["Elevator", "Fitness Center"], "features": [35, 14, 78], "pets": [1, 3, 2], "agent_id": 14665954, "agent_name": "Blueground Us", "brokerage_id": 160302, "brokerage_name": "BLUEGROUND", "phone": "(415) 964-3025", "is_messageable": true, "is_featured": false, "rating": 9.6, "external_rating": null, "integrated_tour_types": [], "date_available": null, "created_on": "2024-07-31T19:43:57+00:00", "modified_on": "2026-06-23T18:05:45+00:00", "listed_on": "2026-06-24T05:00:01+00:00", "short_description": "...", "image_ids": [761884337, 761884338], "photos": [ "https://img.zumpercdn.com/761884337/1280x960?auto=format", "https://img.zumpercdn.com/761884338/1280x960?auto=format" ], "url": "https://www.zumper.com/apartment-buildings/1717500/blueground-san-francisco-soma-san-francisco-ca" } ``` Field notes: - `price_min`/`price_max`, `beds`/`max_beds`, `baths`/`max_baths`, and the square-foot fields describe the building's advertised range across its floorplans. - `amenity_tags` and `building_amenity_tags` are the human-readable labels; `amenities`/`building_amenities`/`features`/`pets`/`integrated_tour_types` are Zumper's internal numeric codes for the same things, kept so you can match listings without parsing text. - `photos` are ready-to-use Zumper CDN image URLs built from `image_ids` (1280x960). `image_ids` is kept so you can request other sizes. - `created_on`/`modified_on`/`listed_on` are ISO-8601 UTC timestamps. - Listings are deduplicated by `listing_id` across all cities. Unresolvable inputs and fetch/parse failures are written as typed error items (`{ "error": ..., "source_url": ..., "detail": ... }`) so a single bad city or a markup change never silently empties your run. The `error` field is one of `unsupported_url`, `not_found` (dead URL or city slug), `blocked` (anti-bot challenge), `fetch_failed` (transient network or HTTP error), or `parse_failed` (a listing did not match the expected shape). If every source fails and zero listings are scraped, the run is marked **FAILED** with a status message instead of reporting a green, empty success, so schedulers and monitors are not deceived. ### Billing Pay-per-result: one `listing` charge event per stored listing. Listings removed by your filters and error records are never charged. ### Notes - Listing data lives in the page's `window.__PRELOADED_STATE__` blob under `currentSearch.listables.listables`. If Zumper changes that structure, the actor emits an explicit parse error rather than empty results. - Network calls have a 30s timeout and bounded retries with exponential backoff and jitter; `403`/`429`/redirects are treated as blocks and retried with backoff. - The for-rent listing paths are allowed by Zumper's `robots.txt` for the default user agent. # Actor input Schema ## `startUrls` (type: `array`): Zumper for-rent search URLs, e.g. https://www.zumper.com/apartments-for-rent/san-francisco-ca . Any property-type path (apartments / houses / condos / rooms) and Zumper's own path filters are accepted. Provide these and/or city slugs below. ## `citySlugs` (type: `array`): City slugs like san-francisco-ca or austin-tx (the part after the property-type path). Each slug is combined with the Property type selected below. ## `propertyType` (type: `string`): Which rental category to use when building URLs from city slugs. Ignored for full startUrls (their path wins). ## `maxItems` (type: `integer`): Stop after this many listings across all cities. 0 = no limit. ## `maxItemsPerCity` (type: `integer`): Cap listings per city URL so you sample evenly across many cities instead of exhausting the first. 0 = no per-city cap. ## `minPrice` (type: `integer`): Keep only listings whose price range reaches at least this monthly rent. Applied after fetch. ## `maxPrice` (type: `integer`): Keep only listings whose price range starts at or below this monthly rent. Applied after fetch. ## `minBeds` (type: `integer`): Keep only listings offering at least this many bedrooms (0 = studio). Applied after fetch. ## `maxBeds` (type: `integer`): Keep only listings whose smallest unit has at most this many bedrooms. Applied after fetch. ## `minBaths` (type: `integer`): Keep only listings offering at least this many bathrooms. Applied after fetch. ## `petsAllowed` (type: `boolean`): Keep only listings that list at least one allowed pet type. ## `proxyConfiguration` (type: `object`): Apify Proxy. Datacenter is usually enough for Zumper's listing pages; switch to residential if you hit blocks. ## `impersonate` (type: `string`): curl\_cffi impersonation target used for requests. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.zumper.com/apartments-for-rent/san-francisco-ca" } ], "citySlugs": [ "austin-tx" ], "propertyType": "apartments", "maxItems": 100, "maxItemsPerCity": 0, "petsAllowed": false, "proxyConfiguration": { "useApifyProxy": true }, "impersonate": "chrome" } ``` # 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 = { "startUrls": [ { "url": "https://www.zumper.com/apartments-for-rent/san-francisco-ca" } ], "citySlugs": [ "austin-tx" ] }; // Run the Actor and wait for it to finish const run = await client.actor("bujhmml/zumper-rentals-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 = { "startUrls": [{ "url": "https://www.zumper.com/apartments-for-rent/san-francisco-ca" }], "citySlugs": ["austin-tx"], } # Run the Actor and wait for it to finish run = client.actor("bujhmml/zumper-rentals-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 '{ "startUrls": [ { "url": "https://www.zumper.com/apartments-for-rent/san-francisco-ca" } ], "citySlugs": [ "austin-tx" ] }' | apify call bujhmml/zumper-rentals-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bujhmml/zumper-rentals-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zumper Scraper - US Apartments & Rentals Data", "description": "Scrape Zumper rentals by city: full price/bed/bath/sqft ranges, address, neighborhood, amenities, pets, photos, agent and brokerage contact, ratings and dates. Fast, HTTP-first, no browser.", "version": "1.1", "x-build-id": "dRVaeIzfV6baCVQsn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bujhmml~zumper-rentals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bujhmml-zumper-rentals-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/bujhmml~zumper-rentals-scraper/runs": { "post": { "operationId": "runs-sync-bujhmml-zumper-rentals-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/bujhmml~zumper-rentals-scraper/run-sync": { "post": { "operationId": "run-sync-bujhmml-zumper-rentals-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": { "startUrls": { "title": "Zumper search URLs", "type": "array", "description": "Zumper for-rent search URLs, e.g. https://www.zumper.com/apartments-for-rent/san-francisco-ca . Any property-type path (apartments / houses / condos / rooms) and Zumper's own path filters are accepted. Provide these and/or city slugs below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "citySlugs": { "title": "City slugs", "type": "array", "description": "City slugs like san-francisco-ca or austin-tx (the part after the property-type path). Each slug is combined with the Property type selected below.", "items": { "type": "string" } }, "propertyType": { "title": "Property type", "enum": [ "apartments", "houses", "condos", "rooms" ], "type": "string", "description": "Which rental category to use when building URLs from city slugs. Ignored for full startUrls (their path wins).", "default": "apartments" }, "maxItems": { "title": "Max results (total)", "minimum": 0, "type": "integer", "description": "Stop after this many listings across all cities. 0 = no limit.", "default": 100 }, "maxItemsPerCity": { "title": "Max results per city", "minimum": 0, "type": "integer", "description": "Cap listings per city URL so you sample evenly across many cities instead of exhausting the first. 0 = no per-city cap.", "default": 0 }, "minPrice": { "title": "Min price (USD/month)", "minimum": 0, "type": "integer", "description": "Keep only listings whose price range reaches at least this monthly rent. Applied after fetch." }, "maxPrice": { "title": "Max price (USD/month)", "minimum": 0, "type": "integer", "description": "Keep only listings whose price range starts at or below this monthly rent. Applied after fetch." }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Keep only listings offering at least this many bedrooms (0 = studio). Applied after fetch." }, "maxBeds": { "title": "Max bedrooms", "minimum": 0, "type": "integer", "description": "Keep only listings whose smallest unit has at most this many bedrooms. Applied after fetch." }, "minBaths": { "title": "Min bathrooms", "minimum": 0, "type": "integer", "description": "Keep only listings offering at least this many bathrooms. Applied after fetch." }, "petsAllowed": { "title": "Pet-friendly only", "type": "boolean", "description": "Keep only listings that list at least one allowed pet type.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy. Datacenter is usually enough for Zumper's listing pages; switch to residential if you hit blocks.", "default": { "useApifyProxy": true } }, "impersonate": { "title": "Browser TLS fingerprint", "enum": [ "chrome", "chrome131", "chrome124", "safari17_0" ], "type": "string", "description": "curl_cffi impersonation target used for requests.", "default": "chrome" } } }, "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 } } } } } } } } } } ```