# ApartmentGuide.com Scraper (`lexis-solutions/apartmentguide-com-scraper`) Actor ApartmentGuide.com scraper for rental market data extraction: scrape apartments, townhomes and condos with rent prices, floor plans, amenities, availability, contacts and geo-coordinates for market intelligence, lead generation and CRM enrichment. - **URL**: https://apify.com/lexis-solutions/apartmentguide-com-scraper.md - **Developed by:** [Lexis Solutions](https://apify.com/lexis-solutions) (community) - **Categories:** AI, Real estate, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.90 / 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. 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 ## ApartmentGuide.com Scraper ![banner](https://i.ibb.co/h1KJ5Hf3/Screenshot-2026-05-01-at-9-02-53-PM.png) --- ApartmentGuide.com is a major US rental marketplace. This actor collects structured rental listings — pricing, beds/baths, square footage, amenities, photos, contact info, and floor plans — from ApartmentGuide search, category, and property detail pages. ### Use Cases - **Rental market intelligence**: Track rent ranges, available units, and amenities across cities and zip codes. - **Competitive pricing**: Compare prices across floor-plans and property managers in a region. - **Lead generation**: Build contact lists of leasing offices with phone numbers and websites. - **Catalog enrichment**: Feed internal CRMs and BI pipelines with structured rental data. - **Map-based analytics**: Each listing carries lat/lng for geographic dashboards. ### Input - `startUrls` (array, required): ApartmentGuide search, category, or property detail URLs. - `maxItems` (integer, optional): Maximum number of rental items per start URL. - `proxyConfiguration` (object, optional): Apify proxy. US residential proxies are required for reliable scraping. Notes: - Search URLs (zip-style) such as `https://www.apartmentguide.com/zip/94105-Apartments_Townhomes-For-Rent/1-beds-1-baths-...` are supported. - Search URLs (state/city style) such as `https://www.apartmentguide.com/apartments_townhomes_condos_houses/Illinois/Chicago` are supported. - Category URLs such as `https://www.apartmentguide.com/apartments/Texas/Austin/` are supported. - Detail URLs such as `https://www.apartmentguide.com/a/Chicago-Midway-Bedford-Park-IL-6131253/` are processed directly. - Pagination is automatic; crawling stops per source URL when `maxItems` is reached. ### Input Examples **1) Zip search URL** ```json { "startUrls": [ { "url": "https://www.apartmentguide.com/zip/94105-Apartments_Townhomes-For-Rent/1-beds-1-baths-1z141xt+1z141xu/" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ```` **2) State + city search URL** ```json { "startUrls": [ { "url": "https://www.apartmentguide.com/apartments_townhomes_condos_houses/Illinois/Chicago" } ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ``` **3) Category URL** ```json { "startUrls": [{ "url": "https://www.apartmentguide.com/apartments/Texas/Austin/" }], "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ``` **4) Property detail URL** ```json { "startUrls": [ { "url": "https://www.apartmentguide.com/a/Chicago-Midway-Bedford-Park-IL-6131253/" } ], "maxItems": 1, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ``` ### Output Each dataset item contains fields like: ```json { "url": "https://www.apartmentguide.com/a/Perry-Co-Living-Washington-DC-5904451/", "originalUrl": "https://www.apartmentguide.com/a/Perry-Co-Living-Washington-DC-5904451/", "listingId": "5904451", "name": "Perry Co-Living", "description": "Experience convenient, all-inclusive co-living (rooms for rent) at 1201 Perry St NE...", "propertyType": "APARTMENTS", "roomForRent": false, "address": "1201 Perry St NE, Washington, DC 20017", "city": "Washington", "state": "District of Columbia", "stateAbbr": "DC", "zipCode": "20017", "latitude": 38.936047, "longitude": -76.99078, "neighborhoods": ["University Heights", "Northeast Washington", "Brookland"], "phoneNumber": "(703) 972-5630", "websiteUrl": null, "applicationUrl": null, "priceText": "$1,275+", "priceMin": 1275, "priceMax": 1375, "bedRange": "1 Bed", "bedText": "1 Bed", "bathText": "1 Bath", "squareFeetText": "116–140 Sqft", "unitsAvailable": 4, "unitsAvailableText": "4 Units Available", "totalUnits": 7, "availabilityStatus": "TODAY", "ratingPercent": null, "ratingCount": null, "amenities": ["Dishwasher", "Controlled Access"], "amenitiesAll": [ { "name": "24 Hour Availability", "category": "Additional Features", "subcategory": null }, { "name": "Bicycle storage", "category": "Community Features", "subcategory": "Fitness" }, { "name": "Dishwasher", "category": "In-Unit Features", "subcategory": "Kitchen & Dining" } ], "uniqueHighlights": [ "24 Hour Availability", "Bicycle Storage", "Club House", "Library", "TV Lounge", "Rooftop Deck", "Dishwasher", "In-Unit Laundry", "Smart TV", "Community Movie Room" ], "categoryBadges": [], "propertyVibes": [ { "category": "Great Price", "context": "in University Heights" }, { "category": "Easy Access", "context": "to Red Line Metro" } ], "propertyManagementCompany": null, "bedCountData": [{ "beds": 1, "priceLow": 1275, "priceHigh": 1375 }], "floorPlans": [ { "name": "Shared Bath - 3 Person Suite", "beds": 1, "baths": 1, "priceMin": 1325, "priceMax": 1325, "squareFeetMin": 120, "squareFeetMax": 120, "availableCount": 1, "availabilityStatus": "AVAILABLE_WITH_COUNT", "availableDate": null, "priceTerm": "/mo", "units": [ { "unitId": "3-4", "rent": "$1,325", "dateAvailable": "2026-03-12T00:00:00.000Z", "deposit": null, "sqft": 102, "unitFloor": null, "isAvailable": true } ] } ], "deals": [], "leasingTerms": ["12-Month"], "petPolicies": [ { "label": "No Pets", "id": "NO_PETS", "deposit": null, "additionalRent": null, "initialFee": null, "maximumPets": null, "weightRestriction": null } ], "fees": { "adminFee": null, "applicationFee": "$30", "brokerFee": null, "salesTax": null, "utilitiesIncluded": null, "utilitiesTenantPaid": [], "insuranceRequired": null, "insuranceMinLiability": null }, "incomeRestrictions": [], "walkScore": { "walk": { "score": 92, "description": "Walker's Paradise" }, "bike": { "score": 63, "description": "Bikeable" }, "transit": { "score": 69, "description": "Good Transit" }, "categoryScores": { "parks": 100, "schools": 100, "grocery": 100, "errands": 91, "dineDrink": 85, "culture": 96, "shopping": 88 } }, "schools": [ { "name": "Brookland Ms", "type": "public", "grade": "6-8", "overallRating": "4", "milesToGeoCode": 0.2, "address": "1150 Michigan Avenue Northeast", "districtName": "District Of Columbia Public Schools" } ], "officeHours": [], "imageUrls": [ "https://i.apartmentguide.com/t_3x2_fixed_webp_lg/ffe230d26be889ab307393d612bd1076" ], "updatedAt": "2026-05-01T00:00:00.000Z" } ``` The scraper paginates through result pages and stops when `maxItems` is reached per start URL or when no more results are returned. ### Why use the ApartmentGuide.com Scraper? - **Four entry points**: Zip search, state/city search, category, and direct property detail URLs. - **Rich per-property data**: Pricing per floor plan, beds/baths, square footage, amenities, photos, contact info, and lat/lng. - **Structured output**: Ready-to-use JSON items. - **Per-URL limits**: `maxItems` is enforced per source URL. - **Pagination-aware**: Automatic pagination across search and category pages. - **Apify-native**: Works with Apify datasets, request queue, and proxy configuration. ### FAQ - **How many properties can it extract?**\ Controlled by `maxItems` per source URL. - **Do I need proxies?**\ Yes. US residential proxies are required for reliable scraping. - **Can I start from a property detail URL?**\ Yes. Detail URLs are accepted and processed directly. - **What property types are supported?**\ All categories on apartmentguide.com — apartments, townhomes, condos, houses — and combinations. ### Need to scrape other rental or real-estate platforms? Check out these related actors: - [Redfin Scraper](https://apify.com/lexis-solutions/redfin-scraper) — US real-estate property listings. - [Booli.se Scraper](https://apify.com/lexis-solutions/booli-se-scraper) — Swedish real-estate listings. *** **Need help or want a custom solution?** Lexis Solutions is a certified Apify Partner. We can help with custom data extraction projects. Contact us over [Email](mailto:scraping@lexis.solutions) or [LinkedIn](https://www.linkedin.com/company/lexis-solutions). ### Support Our Work If you're happy with our work and scrapers, you're welcome to leave us a company review [here](https://apify.com/partners/find/lexis-solutions/review) and leave a review for the scrapers you're subscribed to. ### Image Credit Image credit: [apartmentguide.com](https://www.apartmentguide.com/). # Actor input Schema ## `startUrls` (type: `array`): URLs from apartmentguide.com. Supports search URLs (/zip/..., /apartments\_townhomes\_condos\_houses//), category URLs (/apartments///), and property detail URLs (/a/-/). ## `maxItems` (type: `integer`): Maximum number of rental items to collect per start URL. ## `proxyConfiguration` (type: `object`): Proxy configuration. US residential proxies are required for reliable scraping. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.apartmentguide.com/apartments/Texas/Austin/" }, { "url": "https://www.apartmentguide.com/apartments_townhomes_condos_houses/Illinois/Chicago" }, { "url": "https://www.apartmentguide.com/a/Chicago-Midway-Bedford-Park-IL-6131253/" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `overview` (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 = { "startUrls": [ { "url": "https://www.apartmentguide.com/apartments/Texas/Austin/" }, { "url": "https://www.apartmentguide.com/apartments_townhomes_condos_houses/Illinois/Chicago" }, { "url": "https://www.apartmentguide.com/a/Chicago-Midway-Bedford-Park-IL-6131253/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("lexis-solutions/apartmentguide-com-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.apartmentguide.com/apartments/Texas/Austin/" }, { "url": "https://www.apartmentguide.com/apartments_townhomes_condos_houses/Illinois/Chicago" }, { "url": "https://www.apartmentguide.com/a/Chicago-Midway-Bedford-Park-IL-6131253/" }, ] } # Run the Actor and wait for it to finish run = client.actor("lexis-solutions/apartmentguide-com-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.apartmentguide.com/apartments/Texas/Austin/" }, { "url": "https://www.apartmentguide.com/apartments_townhomes_condos_houses/Illinois/Chicago" }, { "url": "https://www.apartmentguide.com/a/Chicago-Midway-Bedford-Park-IL-6131253/" } ] }' | apify call lexis-solutions/apartmentguide-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lexis-solutions/apartmentguide-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ApartmentGuide.com Scraper", "description": "ApartmentGuide.com scraper for rental market data extraction: scrape apartments, townhomes and condos with rent prices, floor plans, amenities, availability, contacts and geo-coordinates for market intelligence, lead generation and CRM enrichment.", "version": "1.0", "x-build-id": "doHUPPbNVtzh04P2J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lexis-solutions~apartmentguide-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lexis-solutions-apartmentguide-com-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/lexis-solutions~apartmentguide-com-scraper/runs": { "post": { "operationId": "runs-sync-lexis-solutions-apartmentguide-com-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/lexis-solutions~apartmentguide-com-scraper/run-sync": { "post": { "operationId": "run-sync-lexis-solutions-apartmentguide-com-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "URLs from apartmentguide.com. Supports search URLs (/zip/..., /apartments_townhomes_condos_houses//), category URLs (/apartments///), and property detail URLs (/a/-/).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum number of items", "type": "integer", "description": "Maximum number of rental items to collect per start URL.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy configuration. US residential proxies are required for reliable scraping.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```