# Hotpads Property Details Scraper (`ecomscrape/hotpads-property-details-scraper`) Actor

Advanced real estate data extraction tool that automatically scrapes comprehensive property information from Hotpads.com. Extract pricing, location data, amenities, and property details in JSON format for market analysis, investment research, and business intelligence applications.

- **URL**: https://apify.com/ecomscrape/hotpads-property-details-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Real estate, Automation, Integrations
- **Stats:** 13 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## Hotpads.com Property Details Scraper - Advanced Real Estate Data Extraction Tool

### Introduction

HotPads.com stands as one of the largest and most trusted apartment and home rental platforms, serving as a comprehensive marketplace for rental properties since 2005. With its interactive map-based interface and over 4 million property listings, HotPads has become an essential resource for real estate professionals, investors, and market analysts seeking accurate rental market data.

The challenge many professionals face is manually collecting and analyzing vast amounts of property data from HotPads for market research, competitive analysis, or investment decision-making. Our HotPads Property Details Scraper addresses this challenge by automating the data extraction process, enabling users to efficiently gather comprehensive property information at scale. This tool transforms time-consuming manual research into streamlined, automated data collection that can process hundreds of listings in minutes rather than hours.

### Overview of HotPads Property Details Scraper

The HotPads Property Details Scraper is a powerful automation tool designed to extract comprehensive property information from HotPads.com listings. By providing specific HotPads URLs, the scraper collects detailed property listings including pricing, property features, amenities, and broker contact details. This sophisticated scraper handles the complexities of modern web scraping, including JavaScript rendering and anti-bot protection mechanisms.

Key advantages of our scraper include its ability to handle multiple property URLs simultaneously, extract over 40 different data fields per property, and maintain high accuracy rates while respecting website guidelines. The tool is particularly valuable for real estate professionals who need to analyze market trends, investors seeking rental property opportunities, and researchers conducting comprehensive market studies.

The scraper is designed for real estate agents, property managers, investment firms, market researchers, and data analysts who require reliable, up-to-date property information for their business operations. Whether you're tracking rental price trends, identifying investment opportunities, or conducting competitive market analysis, this tool provides the data foundation necessary for informed decision-making.

### Input and Output Details

Example url: https://hotpads.com/7-dekalb-brooklyn-ny-11201-248s2tz/pad

Example url: https://hotpads.com/villas-at-mercey-springs-los-banos-ca-93635-t1dbmc/pad?lat=36.9889\&lon=-120.9690\&z=10

Example url: https://hotpads.com/918-illinois-ave-los-banos-ca-93635-tmkkz9/building?lat=36.9889\&lon=-120.9690\&z=10

Example Screenshot of property page:

![](https://i.ibb.co/b5FYD2SF/Screenshot-from-2025-07-05-02-14-46.png)

#### Input Format

The scraper accepts a JSON configuration that allows for flexible and customized data extraction. The input format includes several key components:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20,
  "urls": [ // Links to property pages.
    "https://hotpads.com/7-dekalb-brooklyn-ny-11201-248s2tz/pad",
    "Example url: https://hotpads.com/918-illinois-ave-los-banos-ca-93635-tmkkz9/building?lat=36.9889&lon=-120.9690&z=10",
    "https://hotpads.com/villas-at-mercey-springs-los-banos-ca-93635-t1dbmc/pad?lat=36.9889&lon=-120.9690&z=10"
  ]
}
```

The **max_retries_per_url** parameter (typically set to 2) determines how many attempts the scraper will make if a URL fails to load initially. The **proxy configuration** is crucial for avoiding bot detection and should include residential proxies from a country matching your target market. The **max_items_per_url** setting controls the maximum number of properties to extract per URL, while the **urls array** contains the specific HotPads property page links you want to scrape.

#### Output Format and Data Fields

You get the output from the Hotpads.com Property Details Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of property information
  {
    "active": true,
    "address": {
      "street": "7 Dekalb Ave",
      "city": "Brooklyn",
      "state": "NY",
      "zip": "11201",
      "neighborhood": "Downtown",
      "hide_street": false
    },
    "alias_encoded": "2y2s1uqyhea6h",
    "amenities": {
      "has_available_in_select_units": false,
      "amenities": [
        "Building Deposit Fee Maximum: 0",
        "Parking Type: none"
      ],
      "model_amenities": [],
      "highlights": [
        {
          "id": "pets",
          "display": "Pets",
          "types": [
            "Cats and Dogs Allowed"
          ]
        },
        {
          "id": "parking",
          "display": "Parking",
          "types": [
            "No Parking"
          ]
        }
      ],
      "condensed_amenities": {
        "pets": "Cats and Dogs Allowed"
      },
      "pet_policies": {
        "cat": {
          "allowed": true,
          "deposit": null,
          "one_time_fee": null,
          "monthly_fee": null,
          "max_number_allowed": null,
          "max_weight_allowed": null,
          "comment": "",
          "restriction": ""
        },
        "dog": {
          "allowed": true,
          "deposit": null,
          "one_time_fee": null,
          "monthly_fee": null,
          "max_number_allowed": null,
          "max_weight_allowed": null,
          "comment": "",
          "restriction": ""
        }
      }
    },
    "belongs_to_multiple_unit_building": false,
    "building": false,
    "contact": {
      "restricted": false,
      "default_inquiry_message": "I'd like to schedule a viewing for 7 Dekalb. Please contact me with more information!",
      "requires_num_beds": false,
      "requires_move_date": false,
      "requires_phone": true,
      "requires_name": true,
      "requires_email": true,
      "requires_message": true,
      "display_contact_box": true,
      "message": "",
      "confirmation_message": "",
      "restricted_income_by_occupants": {
        "1": "",
        "2": "",
        "3": "",
        "4": "",
        "5": "",
        "6": "",
        "7": "",
        "8": ""
      }
    },
    "created": 1739571011835,
    "details": {
      "room_for_rent": {
        "room_details": {
          "room_sq_ft": 0,
          "utilities_share_description": "",
          "room_is_furnished": false,
          "has_private_bath": false
        },
        "roommate_details": {
          "roommates_count": "",
          "description": "",
          "roommates_info": "",
          "pets_info": ""
        },
        "preferred_new_roommate": ""
      },
      "student_housing": false,
      "senior_housing": false,
      "furnished": false,
      "rental": true,
      "demoted": false,
      "allow_website": false,
      "title": "7 Dekalb",
      "full_description": "7 Dekalb",
      "is_mls": false,
      "mls_logo": "",
      "mls_name": "",
      "disclaimer": "",
      "keywords": "",
      "meta_keywords": "Large Building, Rental, Brooklyn, NY, 11201, HotPads",
      "payment_per_inquiry": 0,
      "web_site": "",
      "web_site_is_pay_per_click": false,
      "web_site_original_domain": "www.avanath.com",
      "lease_terms": "",
      "lease_terms_and_utilities_share_description": "",
      "availability_date": "",
      "trusted": true,
      "contact_times": "Sunday: Closed\nMonday: 9:00 AM to 5:00 PM\nTuesday: 9:00 AM to 5:00 PM\nWednesday: 9:00 AM to 5:00 PM\nThursday: 9:00 AM to 5:00 PM\nFriday: 9:00 AM to 5:00 PM\nSaturday: Closed",
      "num_units": 251,
      "zillow_url": "",
      "logo_url_cdn": "",
      "tour_urls": [],
      "is_broker_listing": false,
      "instant_tour_providers": null,
      "has3d_tour": false,
      "fees_and_deposits": [
        {
          "fee_type": "deposit",
          "fee": "$0"
        },
        {
          "fee_type": "buildingDepositFeeMax",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "dogDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "catDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        },
        {
          "fee_type": "securityDeposit",
          "fee": "$0"
        }
      ]
    },
    "display_name": "7 Dekalb",
    "featured_property_product_id": 9,
    "floorplans": [
      {
        "model_id": "4844536",
        "name": "1 Bed 1 Bath Market",
        "type": "FLAT",
        "availability_date": "",
        "beds": 1,
        "baths": 1,
        "sqft": 669,
        "low": 4396,
        "high": 4396,
        "price_range_display": [
          "$4,396",
          "$4,396"
        ],
        "photos": [],
        "large_photos": [],
        "thumb_photos": [],
        "units": [
          {
            "model_id": "5K",
            "name": "5K",
            "availability_date": "",
            "beds": 1,
            "baths": 1,
            "sqft": 669,
            "low": 4397,
            "high": 4397,
            "price_range_display": [
              "4,397",
              "4,397"
            ]
          }
        ],
        "zillow3d_tour_url": ""
      },
      {
        "model_id": "4844537",
        "name": "2 Bed 2 Bath Market",
        "type": "RANGE",
        "availability_date": "",
        "beds": 2,
        "baths": 2,
        "sqft": 1056,
        "low": 6688,
        "high": 6701,
        "price_range_display": [
          "$6,688",
          "$6,701"
        ],
        "photos": [],
        "large_photos": [],
        "thumb_photos": [],
        "units": [
          {
            "model_id": "19F",
            "name": "19F",
            "availability_date": "",
            "beds": 2,
            "baths": 2,
            "sqft": 1099,
            "low": 6688,
            "high": 6688,
            "price_range_display": [
              "6,688",
              "6,688"
            ]
          },
          {
            "model_id": "12S",
            "name": "12S",
            "availability_date": "",
            "beds": 2,
            "baths": 2,
            "sqft": 1056,
            "low": 6701,
            "high": 6701,
            "price_range_display": [
              "6,701",
              "6,701"
            ]
          }
        ],
        "zillow3d_tour_url": ""
      }
    ],
    "for_rent_units_in_building": [
      "UNIT_WITHOUT_NAME"
    ],
    "geo": {
      "lat": 40.6904697,
      "lon": -73.9828389,
      "quad": "032010110310021331210123330"
    },
    "history": {
      "last_updated": {
        "date": 1751412273652,
        "ago": "2 days, 19 hours ago"
      },
      "created": {
        "date": 1739571011835,
        "ago": "4 months, 17 days ago"
      },
      "deactivated": {
        "date": 0,
        "ago": ""
      },
      "activated": {
        "date": 1739571012460,
        "ago": "4 months, 17 days ago"
      },
      "last_synced": {
        "date": 1751656195507,
        "ago": "1 minute ago"
      },
      "last_price": ""
    },
    "icon_type": "building",
    "is_apartment_bldg": true,
    "is_paid_and_not_demoted": true,
    "is_paid_multifamily": true,
    "is_unit": true,
    "legal_disclaimer": "",
    "large_photos": [
      {
        "url": "https://photos.zillowstatic.com/fp/39cc222b7b0801076c72afe830edaddf-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/633b950750f29339d99ef198bd5b44eb-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5cf7f3ddd0e6e0c4a2a057647290d5fa-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/03e70bfbccf5df6d449ff2cc72e496d9-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5fb92f6426bc146bd15f4d2f416bdf8d-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/378eafdc74405251660d7aca603e3be5-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/9a33189121f7ab2fc5727fdb17ec1634-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d1b7b31abbbcf801bddef9c1674a4778-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d67ffa8699f07c2b4a8204ac52941314-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/428094ba624752d82c75c9a7b9ee2e2d-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/cf4fa001c57183516f9a66c1acdce451-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d5d61a740dbd7c6ce5bc5206a91f5d03-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5515ddd84efc4ee041edd903c593ae96-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/bcad7e777fbc94d69815f0f06d3c1c2a-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/bb9ce4dbc23424228fca92da9c9aee65-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/7f2e7cdcb34a3536d94cf420e12e6cb5-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e7d5350ee89ce750405197b8b6456020-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e3b1734cfe497a4612d96b2062306d6c-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f92d386ca4adb6d2e368d6b65d768f77-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/61d0682858466b1c4afa108f9690eacb-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e7f5007e78b65f7b4dfc4525d2408a9e-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e88f2b8c4050638f03042a15bad1baec-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/571fb43d95ca8480fdd6a2212e76b443-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d12368f39be16872dab29fe9168b2763-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6b4854c197b7d571979048b34529003e-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e181fce81c43cb6473d5dad749404307-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/29fe8d868747b686d9887087c7561c11-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6c5ddc594d70380f419394892dabb392-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/0751bfed1eba06168092ba408cbf9fb6-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/304eeeaa6fa606c4223067e618b7056d-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/51e0c2997ae3a367ba1056ca69beb6a2-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f6c2b83b8d0e1d82a589fadec476428b-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/842f419c9d18bb76d8c2ed61b5b23891-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/a236b153171faf7931006bf3fe9ef9a7-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/865694ec1afb6e402884b3dcad4ee4bb-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/ef295b2417896bd43b15521dfce862fc-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/16ba59eab61b23de05e5404ee904097b-rentals_large_1200_1200.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/339ad421b3ac2878cbc3118bfc1bcb35-rentals_large_1200_1200.webp",
        "caption": ""
      }
    ],
    "listed_by": {
      "company_name": "Avanath Realty Inc.",
      "contact_phone": "1-929-368-5723",
      "contact_name": "Leasing Agent",
      "disclaimer": null,
      "landlord_photo_url": null,
      "member_phone": null,
      "member_since": {
        "date": 1537889235577,
        "ago": "6 years, 9 months ago"
      },
      "mls_logo": null,
      "response_rate": null,
      "response_time": null,
      "response_rate_level": null,
      "response_time_level": null,
      "web_site": null,
      "logo_url_cdn": null
    },
    "listing_min_max_price_beds": {
      "d_a_t_a__m_o_d_e_l": "ModelCollection",
      "min_price": 4396,
      "max_price": 6701,
      "min_beds": 1,
      "max_beds": 2,
      "min_baths": 1,
      "max_baths": 2,
      "min_sqft": 669,
      "max_sqft": 1056,
      "bed_display": "1 to 2 beds",
      "bed_display_all_available": "1 and 2 bedrooms",
      "bath_display": "1 to 2 baths",
      "price_display": "$4,396+",
      "price_display_range": "$4,396 - $6,701",
      "sqft_display": "669 to 1056 sqft",
      "bed_display_compact": "1-2 bd",
      "bed_display_semi_compact": "1 - 2 beds",
      "bath_display_compact": "1-2 ba",
      "bath_display_semi_compact": "1 - 2 baths"
    },
    "listing_type": "rental",
    "malone_lot_id_encoded": "248s2tz",
    "med_photo_urls": [
      "https://photos.zillowstatic.com/fp/39cc222b7b0801076c72afe830edaddf-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/633b950750f29339d99ef198bd5b44eb-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/5cf7f3ddd0e6e0c4a2a057647290d5fa-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/03e70bfbccf5df6d449ff2cc72e496d9-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/5fb92f6426bc146bd15f4d2f416bdf8d-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/378eafdc74405251660d7aca603e3be5-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/9a33189121f7ab2fc5727fdb17ec1634-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/d1b7b31abbbcf801bddef9c1674a4778-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/d67ffa8699f07c2b4a8204ac52941314-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/428094ba624752d82c75c9a7b9ee2e2d-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/cf4fa001c57183516f9a66c1acdce451-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/d5d61a740dbd7c6ce5bc5206a91f5d03-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/5515ddd84efc4ee041edd903c593ae96-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/bcad7e777fbc94d69815f0f06d3c1c2a-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/bb9ce4dbc23424228fca92da9c9aee65-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/7f2e7cdcb34a3536d94cf420e12e6cb5-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/e7d5350ee89ce750405197b8b6456020-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/e3b1734cfe497a4612d96b2062306d6c-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/f92d386ca4adb6d2e368d6b65d768f77-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/61d0682858466b1c4afa108f9690eacb-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/e7f5007e78b65f7b4dfc4525d2408a9e-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/e88f2b8c4050638f03042a15bad1baec-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/571fb43d95ca8480fdd6a2212e76b443-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/d12368f39be16872dab29fe9168b2763-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/6b4854c197b7d571979048b34529003e-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/e181fce81c43cb6473d5dad749404307-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/29fe8d868747b686d9887087c7561c11-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/6c5ddc594d70380f419394892dabb392-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/0751bfed1eba06168092ba408cbf9fb6-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/304eeeaa6fa606c4223067e618b7056d-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/51e0c2997ae3a367ba1056ca69beb6a2-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/f6c2b83b8d0e1d82a589fadec476428b-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/842f419c9d18bb76d8c2ed61b5b23891-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/a236b153171faf7931006bf3fe9ef9a7-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/865694ec1afb6e402884b3dcad4ee4bb-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/ef295b2417896bd43b15521dfce862fc-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/16ba59eab61b23de05e5404ee904097b-rentals_medium_500_500.webp",
      "https://photos.zillowstatic.com/fp/339ad421b3ac2878cbc3118bfc1bcb35-rentals_medium_500_500.webp"
    ],
    "models_and_pricing": [
      {
        "num_beds": 1,
        "low_price": 4396,
        "high_price": 4396,
        "quantity": 1
      },
      {
        "num_beds": 2,
        "low_price": 6688,
        "high_price": 6701,
        "quantity": 2
      }
    ],
    "open_houses": [],
    "photo_count": 38,
    "photos": [
      {
        "url": "https://photos.zillowstatic.com/fp/39cc222b7b0801076c72afe830edaddf-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/633b950750f29339d99ef198bd5b44eb-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5cf7f3ddd0e6e0c4a2a057647290d5fa-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/03e70bfbccf5df6d449ff2cc72e496d9-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5fb92f6426bc146bd15f4d2f416bdf8d-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/378eafdc74405251660d7aca603e3be5-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/9a33189121f7ab2fc5727fdb17ec1634-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d1b7b31abbbcf801bddef9c1674a4778-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d67ffa8699f07c2b4a8204ac52941314-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/428094ba624752d82c75c9a7b9ee2e2d-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/cf4fa001c57183516f9a66c1acdce451-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d5d61a740dbd7c6ce5bc5206a91f5d03-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5515ddd84efc4ee041edd903c593ae96-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/bcad7e777fbc94d69815f0f06d3c1c2a-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/bb9ce4dbc23424228fca92da9c9aee65-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/7f2e7cdcb34a3536d94cf420e12e6cb5-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e7d5350ee89ce750405197b8b6456020-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e3b1734cfe497a4612d96b2062306d6c-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f92d386ca4adb6d2e368d6b65d768f77-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/61d0682858466b1c4afa108f9690eacb-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e7f5007e78b65f7b4dfc4525d2408a9e-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e88f2b8c4050638f03042a15bad1baec-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/571fb43d95ca8480fdd6a2212e76b443-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d12368f39be16872dab29fe9168b2763-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6b4854c197b7d571979048b34529003e-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e181fce81c43cb6473d5dad749404307-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/29fe8d868747b686d9887087c7561c11-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6c5ddc594d70380f419394892dabb392-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/0751bfed1eba06168092ba408cbf9fb6-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/304eeeaa6fa606c4223067e618b7056d-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/51e0c2997ae3a367ba1056ca69beb6a2-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f6c2b83b8d0e1d82a589fadec476428b-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/842f419c9d18bb76d8c2ed61b5b23891-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/a236b153171faf7931006bf3fe9ef9a7-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/865694ec1afb6e402884b3dcad4ee4bb-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/ef295b2417896bd43b15521dfce862fc-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/16ba59eab61b23de05e5404ee904097b-rentals_medium_500_500.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/339ad421b3ac2878cbc3118bfc1bcb35-rentals_medium_500_500.webp",
        "caption": ""
      }
    ],
    "popularity": {
      "summary": {
        "from": {
          "date": 1751051455506,
          "ago": "7 days ago"
        },
        "favorites": 0,
        "viewed": 40,
        "inquiries": 0
      }
    },
    "preview_photo": {
      "url": "https://photos.zillowstatic.com/fp/39cc222b7b0801076c72afe830edaddf-rentals_thumb_180_180.webp",
      "caption": ""
    },
    "pricing": {
      "1": {
        "beds_low": 1,
        "beds_high": 1,
        "sq_ft_low": 669,
        "sq_ft_high": 669,
        "baths_low": 1,
        "baths_high": 1,
        "price_low": 4396,
        "price_high": 4397
      },
      "2": {
        "beds_low": 2,
        "beds_high": 2,
        "sq_ft_low": 1056,
        "sq_ft_high": 1099,
        "baths_low": 2,
        "baths_high": 2,
        "price_low": 6688,
        "price_high": 6701
      },
      "three_plus": {},
      "summary": {
        "beds_low": 1,
        "beds_high": 2,
        "sq_ft_low": 669,
        "sq_ft_high": 1099,
        "baths_low": 1,
        "baths_high": 2,
        "price_low": 4396,
        "price_high": 6701
      }
    },
    "priority": 0.9375,
    "property_type": "large",
    "ratings_and_reviews": {
      "reviews_summary": {
        "total_number_of_text_reviews": 0,
        "total_number_of_reviews": 0,
        "average_star_level": 0,
        "review_type": "",
        "ratings_without_reviews": 0,
        "rating_label": "Bad"
      },
      "reviews_breakdown": {
        "one_star": 0,
        "two_star": 0,
        "three_star": 0,
        "four_star": 0,
        "five_star": 0
      },
      "reviews": []
    },
    "recency_time": {
      "display_diff": "5 months",
      "seconds_diff": 12085244,
      "minutes_diff": 201421,
      "hours_diff": 3358,
      "days_diff": 140,
      "weeks_diff": 20,
      "months_diff": 5
    },
    "rental_application_status": "undecided",
    "score": 0.9375,
    "search_keyword": "Apartments for Rent",
    "show_pricing_stats": false,
    "special_offers": [
      {
        "description": "Enjoy your first month rent-free when you sign a 13-month lease on select units!"
      }
    ],
    "thumb_photos": [
      {
        "url": "https://photos.zillowstatic.com/fp/39cc222b7b0801076c72afe830edaddf-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/633b950750f29339d99ef198bd5b44eb-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5cf7f3ddd0e6e0c4a2a057647290d5fa-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/03e70bfbccf5df6d449ff2cc72e496d9-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5fb92f6426bc146bd15f4d2f416bdf8d-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/378eafdc74405251660d7aca603e3be5-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/9a33189121f7ab2fc5727fdb17ec1634-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d1b7b31abbbcf801bddef9c1674a4778-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d67ffa8699f07c2b4a8204ac52941314-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/428094ba624752d82c75c9a7b9ee2e2d-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/cf4fa001c57183516f9a66c1acdce451-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d5d61a740dbd7c6ce5bc5206a91f5d03-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5515ddd84efc4ee041edd903c593ae96-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/bcad7e777fbc94d69815f0f06d3c1c2a-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/bb9ce4dbc23424228fca92da9c9aee65-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/7f2e7cdcb34a3536d94cf420e12e6cb5-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e7d5350ee89ce750405197b8b6456020-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e3b1734cfe497a4612d96b2062306d6c-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f92d386ca4adb6d2e368d6b65d768f77-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/61d0682858466b1c4afa108f9690eacb-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e7f5007e78b65f7b4dfc4525d2408a9e-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e88f2b8c4050638f03042a15bad1baec-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/571fb43d95ca8480fdd6a2212e76b443-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/d12368f39be16872dab29fe9168b2763-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6b4854c197b7d571979048b34529003e-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e181fce81c43cb6473d5dad749404307-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/29fe8d868747b686d9887087c7561c11-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6c5ddc594d70380f419394892dabb392-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/0751bfed1eba06168092ba408cbf9fb6-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/304eeeaa6fa606c4223067e618b7056d-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/51e0c2997ae3a367ba1056ca69beb6a2-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f6c2b83b8d0e1d82a589fadec476428b-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/842f419c9d18bb76d8c2ed61b5b23891-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/a236b153171faf7931006bf3fe9ef9a7-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/865694ec1afb6e402884b3dcad4ee4bb-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/ef295b2417896bd43b15521dfce862fc-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/16ba59eab61b23de05e5404ee904097b-rentals_squarethumb_74_74.webp",
        "caption": ""
      },
      {
        "url": "https://photos.zillowstatic.com/fp/339ad421b3ac2878cbc3118bfc1bcb35-rentals_squarethumb_74_74.webp",
        "caption": ""
      }
    ],
    "trusted": true,
    "unit": "",
    "updated": 1751412273652,
    "uri_building": "/7-dekalb-brooklyn-ny-11201-248s2tz/building",
    "uri_malone": "/7-dekalb-brooklyn-ny-11201-248s2tz/pad",
    "url_malone_unit": "",
    "uri_v2": "/7-dekalb-brooklyn-ny-11201-248s2tz/pad",
    "user_item_dates": {
      "viewed": {
        "date": 1751655592089,
        "ago": "11 minutes, 3 seconds ago"
      },
      "inquiry": {
        "date": 0,
        "ago": ""
      },
      "hidden": {
        "date": 0,
        "ago": ""
      },
      "favorite": {
        "date": 0,
        "ago": ""
      }
    },
    "user_item_types": [
      "viewed"
    ],
    "user_on_waitlist": false,
    "waitlisted": false,
    "zestimate": 0,
    "broker": {
      "is_broker_exclusive_listing": false,
      "company_name": "Avanath Realty Inc.",
      "company_phone_number": null,
      "contact_name": "Leasing Agent",
      "agent_license_type": null,
      "is_broker_listing": false
    },
    "is_allowed_to_retain": true
  }, // ... Many other property details
] 
```

The scraper returns comprehensive property data in a structured format with over 40 distinct fields, each serving specific analytical purposes:

**Core Property Information:**

- **Address**: Complete property address for location-based analysis
- **Display Name**: Property marketing name used in listings
- **Property Type**: Classification (apartment, house, condo, etc.) for categorization
- **Active**: Current listing status for availability tracking
- **Created/Updated**: Timestamps for market velocity analysis

**Pricing and Financial Data:**

- **Pricing**: Current rental rates and fee structures
- **Listing Min Max Price Beds**: Price ranges across different bedroom configurations
- **Zestimate**: Estimated property value for investment analysis
- **Models And Pricing**: Detailed pricing for different unit types

**Property Features and Amenities:**

- **Amenities**: Complete list of property amenities for competitive analysis
- **Property Details**: Square footage, bedrooms, bathrooms, and other specifications
- **Floorplans**: Available floor plan information for space analysis
- **Building**: Multi-unit building information and features

**Marketing and Visibility Metrics:**

- **Photos/Large Photos/Thumb Photos**: Visual content availability for marketing assessment
- **Photo Count**: Number of listing images for presentation quality evaluation
- **Priority/Score**: Listing ranking and visibility metrics
- **Popularity**: Property engagement and interest levels

**Contact and Business Information:**

- **Contact**: Property manager or landlord contact details
- **Listed By**: Listing agent or company information
- **Broker**: Associated real estate broker details
- **Legal Disclaimer**: Important legal and disclosure information

**Geographic and Location Data:**

- **Geo**: Precise geographic coordinates for mapping and location analysis
- **URI Building/URI Malone**: Unique property identifiers for tracking
- **Search Keyword**: Associated search terms for SEO analysis

This comprehensive data structure enables detailed market analysis, competitive research, and investment evaluation across multiple dimensions of property characteristics and market positioning.

### Usage Guide

#### Step-by-Step Implementation

1. **URL Collection**: Navigate to HotPads.com and collect the specific property page URLs you want to scrape. Ensure URLs are complete and point directly to individual property listings.

2. **Configuration Setup**: Prepare your JSON input with appropriate retry settings, proxy configuration matching your target market, and the collected URLs.

3. **Proxy Selection**: Choose residential proxies from a country that aligns with your target market to avoid geographic restrictions and maintain natural browsing patterns.

4. **Execution Monitoring**: Run the scraper and monitor the extraction process, paying attention to retry attempts and successful data collection rates.

#### Best Practices and Tips

Set reasonable extraction limits (max_items_per_url) to balance comprehensive data collection with respectful website usage. For large-scale projects, consider implementing delays between requests and distributing the workload across multiple sessions. Always verify the accuracy of extracted data by spot-checking results against the original listings.

When handling errors, common issues include outdated URLs, temporarily unavailable listings, or proxy connectivity problems. Implement proper error handling to gracefully manage these situations and ensure maximum data collection success rates.

### Benefits and Applications

#### Time and Efficiency Savings

The scraper can process hundreds of property listings in minutes, compared to hours or days of manual data collection. This automation allows real estate professionals to focus on analysis and decision-making rather than data gathering, significantly improving productivity and enabling more comprehensive market coverage.

#### Real-World Applications

Market analysts use the extracted data to identify rental price trends, vacancy rates, and emerging neighborhoods. Real estate investors leverage the information to evaluate potential acquisition targets and assess rental income potential. Property managers utilize the data for competitive pricing strategies and market positioning of their properties.

#### Business Value

Access to comprehensive, real-time property data enables more informed investment decisions, better market timing, and competitive advantages in fast-moving real estate markets. The structured data format facilitates easy integration with existing business intelligence tools and analytical workflows.

### Conclusion

The HotPads Property Details Scraper represents a powerful solution for real estate professionals seeking efficient, comprehensive property data extraction. By automating the collection of detailed property information, market pricing, and competitive intelligence, this tool enables data-driven decision-making in today's dynamic rental market.

Whether you're conducting market research, evaluating investment opportunities, or analyzing competitive positioning, the scraper provides the reliable, structured data foundation necessary for success in real estate operations. Start leveraging automated property data extraction to gain competitive advantages and make more informed business decisions.

## Related Actors

- [**Hotpads Property Search Scraper**](https://apify.com/ecomscrape/hotpads-property-search-scraper): Your comprehensive tool for extracting valuable property information from Hotpads extensive directory platform.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Hotpads.com Property Details Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific property urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://hotpads.com/7-dekalb-brooklyn-ny-11201-248s2tz/pad?lat=40.6975&lon=-73.9797&z=10"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://hotpads.com/7-dekalb-brooklyn-ny-11201-248s2tz/pad?lat=40.6975&lon=-73.9797&z=10"
    ],
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/hotpads-property-details-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://hotpads.com/7-dekalb-brooklyn-ny-11201-248s2tz/pad?lat=40.6975&lon=-73.9797&z=10"],
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/hotpads-property-details-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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://hotpads.com/7-dekalb-brooklyn-ny-11201-248s2tz/pad?lat=40.6975&lon=-73.9797&z=10"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call ecomscrape/hotpads-property-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/hotpads-property-details-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1jdfMF4BWgMesvRXr/builds/ICgbxSiNPQdrS5gei/openapi.json
