Suumo.jp Scraper

Overview

This actor scrapes detailed property listings from Suumo.jp, a major Japanese real estate platform. It extracts structured data from search results and individual listing pages, including building information, unit specs, pricing, amenities, and agency contact details. Use it to automate data collection for market analysis, lead generation, or populating databases.

Key Features

• Comprehensive Data Extraction: Captures property titles, addresses, rent, fees, layout, area, transport links, building metadata, images, and tags.
• Detailed Page Scraping: Optionally visits individual listing pages to gather deeper information like features, construction details, contract terms, and full agency contact information (name, address, phone, hours).
• Scalable & Controlled: Set a limit to control the number of listings scraped per run.
• Built-in Reliability: Configured to use Apify Residential proxies by default to handle potential blocking and ensure consistent operation.
• Structured Output: Returns data in a consistent JSON format, ready for integration into applications, dashboards, or spreadsheets.

How to Use

Configure the actor using input parameters via the Apify console, API, or a scheduled run. The core requirement is providing one or more startUrls.

Input

The actor accepts the following input parameters:

Example Input

{
  "startUrls": [
    "https://suumo.jp/chintai/tokyo/city/"
  ],
  "limit": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Output

The actor outputs a dataset where each item represents a property listing. The output is a JSON object containing fields from the search result card and, if detail page scraping is enabled, a nested detail object.

Example Output Structure

{
  "url": "https://suumo.jp/chintai/...",
  "buildingTitle": "Building Name",
  "buildingAddress": "Full Address",
  "transport": ["Station Line/Station Name Walk X min"],
  "rent": "54万円",
  "adminFee": "20000円",
  "layout": "2LDK",
  "area": "72.96m2",
  "detail": {
    "features": ["Air Conditioning", "Auto-lock", "..."] ,
    "summary": {
      "structure": "Steel-reinforced concrete",
      "built": "2025年1月"
    },
    "contact": {
      "name": "Agency Name",
      "address": "Agency Address",
      "phone": "XXX-XXXX-XXXX",
      "businessHours": "AM 10:00 - PM 6:00"
    }
  },
  "scrapedAt": "2025-10-27T13:01:03.339Z"
}