# Suumo Scraper \[Only $0.70💰] | Japan Rent & Sale | Agents (`ahmed_jasarevic/suumo-jp-scraper`) Actor

Extract SUUMO Japan rental and sale property listings — Tokyo apartment rents, layout, station access, deposit, key money and agent contacts. Perfect for Japan real estate market research and rental price monitoring in Chiyoda, Shinjuku and Shibuya.

- **URL**: https://apify.com/ahmed\_jasarevic/suumo-jp-scraper.md
- **Developed by:** [Ahmed Jasarevic](https://apify.com/ahmed_jasarevic) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.67 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

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

## SUUMO Scraper — Japan Rental & Sale Property Data

Extract rental and sale property listings from SUUMO (suumo.jp), Japan's largest real estate portal, for Tokyo rent tracking, Japan property market research, and real estate lead generation.

### Main Use Cases

- **Tokyo rental market monitoring** — track apartment rents and availability in Chiyoda, Shinjuku, Shibuya and other Tokyo wards
- **Japan property market research** — build datasets of rents, sale prices, layout, area, station access and building age
- **Property investment scouting** — collect use-condo sale listings with prices, deposit, key money and management fees
- **Real estate lead generation** — extract handling agent name, phone and business hours for Japanese apartment rentals
- **Relocation & expat housing** — assemble apartment options for foreigners moving to Tokyo

### How It Works

Paste one or more SUUMO search-result (ichiran) URLs. The actor auto-detects rental vs. sale from the URL, reads the listing data embedded in each result page, and paginates through all pages — a single Chiyoda rental search covers ~34,000 listings. For rental listings it can optionally visit each detail page to collect the handling agent's contact information.

### Extract Tokyo Rental Listings For Real Estate Market Research

Rental URLs contain `/jj/chintai/ichiran/`. The actor returns rent, layout, area, address, building name, station access, building age, deposit, key money and management fee for every listing in the search. Verified examples:

- Chiyoda-ku rentals (25–99万/月): ~34,000 listings
- Shinjuku-ku rentals: ~126,000 listings
- Shibuya-ku rentals (8–20万/月): ~68,000 listings

Enable `includeAgentInfo` to also return each rental's handling agent (store name, phone, business hours) — useful for agency outreach and relocation services.

### Monitor Japan Property Prices & Rental Market Trends With Rents And Sale Data

Sale URLs contain `/jj/bukken/ichiran/` and work identically — useful condos in Chiyoda-ku (50–80M円) return ~630 listings with price, layout, area, built date and building age. Combine rental and sale URLs in one run to build a complete view of a ward's residential market. Schedule the task daily or weekly to monitor price movements over time — Tokyo area condominium prices hit record highs above ¥100M in H1 2026, so sale-price tracking has never been more relevant.

### Input

All input fields with their types, defaults and notes:

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `searchUrls` | Array\<String> (stringList) | ✅ Yes | — | One or more SUUMO search-result URLs. Rental: `/jj/chintai/ichiran/`; sale: `/jj/bukken/ichiran/`. Listing type is auto-detected; the actor paginates through all result pages. |
| `maxItems` | Integer | No | 100 | Maximum number of listings scraped across all URLs (max 5000). |
| `maxPages` | Integer | No | 0 | Maximum result pages to crawl per search URL; `0` = unlimited. |
| `includeAgentInfo` | Boolean | No | `true` | Rental only: visits each listing's detail page for agent name/phone/hours. Roughly doubles the number of requests. |
| `proxy` | Object (proxy editor) | No | Off | Apify proxy configuration (Datacenter/Residential groups). |

### Output

Each dataset row is one property listing. Fields returned (overview view):

| Field | Description |
|---|---|
| `listingType` | `rent` or `sale` — auto-detected from the search URL |
| `rent` / `price` | Monthly rent or sale price (as displayed on SUUMO) |
| `layout` | Room layout, e.g. 1LDK, 2LDK |
| `area` | Floor area |
| `address` | Property address |
| `buildingName` / `propertyName` | Building or property name |
| `stations` | Array of nearby stations |
| `stationAccess` | Walking time from the nearest station |
| `buildingAge` / `builtDate` | Building age and construction year |
| `deposit` | Shikikin (deposit), often 1–2 months' rent |
| `keyMoney` | Reikin (key money / gift fee) |
| `managementFee` | Monthly management fee |
| `agentName` / `agentPhone` | Handling agent (rental, when `includeAgentInfo` is on) |
| `contactEnriched` | `true` when agent contact enrichment was applied |
| `detailUrl` | Direct link to the SUUMO listing page |

### Example Input

```json
{
  "searchUrls": [
    "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&pc=50&smk=&po1=25&po2=99&shkr1=03&shkr2=03&shkr3=03&shkr4=03&sc=13101&ta=13&tn=13101",
    "https://suumo.jp/jj/bukken/ichiran/JJ012FC001/?ar=030&bs=011&pc=50&smk=&po1=50&po2=80&sc=13101&ta=13&tn=13101"
  ],
  "maxItems": 500,
  "maxPages": 0,
  "includeAgentInfo": true
}
```

### Example Output

```json
{
  "listingType": "rent",
  "rent": "19.8万円",
  "layout": "1LDK",
  "area": "40.12m2",
  "address": "東京都千代田区麹町3丁目",
  "buildingName": "パークコート麹町",
  "stations": ["麴町駅"],
  "stationAccess": "徒歩3分",
  "buildingAge": "築8年",
  "builtDate": "2018年3月",
  "deposit": "1ヶ月",
  "keyMoney": "1ヶ月",
  "managementFee": "12,000円",
  "agentName": "株式会社サンプル不動産",
  "agentPhone": "03-1234-5678",
  "contactEnriched": true,
  "detailUrl": "https://suumo.jp/chintai/xxxx/"
}
```

### Integrations & Automation

- **Apify API** — trigger runs via HTTP, MCP, or any LLM agent framework
- **Webhooks** — get notified when a scheduled run finishes
- **Zapier / Make / n8n** — connect to sheets, Slack, or BI dashboards
- **Scheduling** — run daily for rent/price monitoring, weekly for market snapshots (scheduled runs also improve the actor's recommendation ranking in the Apify Store)

### Related Actors

- [jungle\_synthesizer/suumo-scraper](https://apify.com/jungle_synthesizer/suumo-scraper) — SUUMO apartment rental scraping
- [solidcode/suumo-jp-scraper](https://apify.com/solidcode/suumo-jp-scraper) — SUUMO property search extraction
- [ahmed\_jasarevic/rightmove-scraper](https://apify.com/ahmed_jasarevic/rightmove-scraper) — UK property listings
- [ahmed\_jasarevic/inmuebles24-scraper](https://apify.com/ahmed_jasarevic/inmuebles24-scraper) — Mexico real estate listings & leads
- [ahmed\_jasarevic/crexi-property-broker-data-scraper-pro](https://apify.com/ahmed_jasarevic/crexi-property-broker-data-scraper-pro) — US commercial real estate data

### FAQ

#### Is there a SUUMO API?

SUUMO (operated by Recruit Co., Ltd.) does not offer a public API for listing data. This actor extracts the data directly from public search-result pages, giving you a SUUMO API alternative for rental and sale property data.

#### How much is rent in Tokyo?

Depends heavily on ward and layout. In central wards like Chiyoda, 1LDK apartments typically start around 25万/月 (this actor's verified Chiyoda search covers 25–99万/月 listings); Shinjuku and Shibuya have wider ranges including more affordable 8–20万/月 options. Run the actor to compute actual market medians instead of guessing.

#### Can foreigners buy property in Japan?

Yes — there are no citizenship or residence restrictions on buying real estate in Japan, which is why international investors track Tokyo condominium prices closely. This actor provides the raw listing data (sale prices, area, building age) to support such research.

#### What is key money (reikin)?

Key money is a non-refundable "gift" fee paid to the landlord in Japanese rentals. It's common in Tokyo; the actor returns it as the `keyMoney` field so you can compare total upfront costs (deposit + key money + management fee).

#### Is there an English version of SUUMO?

SUUMO has an English section but its coverage is much smaller than the Japanese site. This actor reads the full Japanese index, so you get complete Tokyo rental and sale data regardless of language.

#### What are alternatives to this actor / to SUUMO data?

- [jungle\_synthesizer/suumo-scraper](https://apify.com/jungle_synthesizer/suumo-scraper) — alternative SUUMO rental actor
- [solidcode/suumo-jp-scraper](https://apify.com/solidcode/suumo-jp-scraper) — alternative SUUMO search extraction
- Homes.co.jp (LIFULL HOME'S) — another major Japanese portal; you can use this actor's URL-based approach on its search pages too
- For Japan real estate data beyond SUUMO, check [ahmed\_jasarevic/rightmove-scraper](https://apify.com/ahmed_jasarevic/rightmove-scraper) (UK) or [ahmed\_jasarevic/inmuebles24-scraper](https://apify.com/ahmed_jasarevic/inmuebles24-scraper) (Mexico)

#### How can I track Japan apartment prices over time?

Set up a scheduled run of this actor (daily or weekly) on your target ward URLs. Each run appends to a dataset, which you can diff or chart to monitor rental and sale price trends.

#### How do I find Japanese real estate agents?

Enable `includeAgentInfo`. Every rental listing then includes the handling agent's store name and phone number — a ready-made lead list for B2B outreach, relocation services and brokerage partnerships.

### For AI Agents & LLM Apps

**Purpose:** Returns SUUMO rental and sale property listings as flat JSON rows (rent/price, layout, area, address, station access, building age, deposit, key money, management fee, agent name/phone, detailUrl).

**Minimal working input:**

```json
{
  "searchUrls": [
    "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&pc=50&smk=&po1=25&po2=99&shkr1=03&shkr2=03&shkr3=03&shkr4=03&sc=13101&ta=13&tn=13101"
  ]
}
```

**Variant input (sale listings):** use a `/jj/bukken/ichiran/` URL, e.g.

```json
{
  "searchUrls": [
    "https://suumo.jp/jj/bukken/ichiran/JJ012FC001/?ar=030&bs=011&pc=50&smk=&po1=50&po2=80&sc=13101&ta=13&tn=13101"
  ],
  "maxItems": 100
}
```

**Output fields:** `listingType`, `rent`, `price`, `layout`, `area`, `address`, `buildingName`, `propertyName`, `stations`, `stationAccess`, `buildingAge`, `builtDate`, `deposit`, `keyMoney`, `managementFee`, `agentName`, `agentPhone`, `contactEnriched`, `detailUrl`.

**Behaviors an agent should know:**

- `searchUrls` is required; each URL must be a SUUMO *ichiran* (search-result) URL — rental URLs contain `/chintai/ichiran/`, sale URLs `/bukken/ichiran/`. The type is auto-detected per URL.
- `includeAgentInfo` is `true` by default and roughly doubles requests, so it doubles the billed events — set it to `false` for cheap list-only runs.
- `maxItems` caps the total results (max 5000). Set it explicitly; without it the actor still respects the 100-item default.
- `contactEnriched: true` means the per-listing `contact-enrichment` charge ($0.001) applied.

**Billing:** Pay-per-event: $0.0007 per result (tiered down to $0.00067 on higher plans) + $0.00005 per actor start; +$0.001 per listing when agent contact enrichment is applied.

### Legal & Compliance Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Recruit Co., Ltd. or SUUMO. It reads only publicly available SUUMO search-result and listing pages — it does not bypass logins, break CAPTCHAs, or access non-public data. Users are responsible for complying with SUUMO's Terms of Service and applicable laws, including Japan's data protection rules, when using extracted data. Agent phone numbers are publicly published business contact details; do not use them for unsolicited commercial outreach that violates applicable law (e.g. Japan's Act on Specified Commercial Transactions or anti-spam rules). This is not legal advice.

### SEO Keywords

suumo scraper, suumo api, japan real estate data, tokyo apartment rent, tokyo rental market, japan property prices, japan condo prices, buy property in japan, tokyo real estate market research, japan property investment, rental price monitoring, suumo english, tokyo 1ldk rent, shinjuku apartment for rent, shibuya apartment rental, key money japan rental, japan relocation housing, japanese real estate agent data, suumo alternatives, homes.co.jp data, tokyo apartment hunting, japan housing market, expat housing tokyo, chiyoda rent, tokyo condominium prices 2026

# Actor input Schema

## `searchUrls` (type: `array`):

Paste one or more SUUMO search-result (ichiran) URLs. Open suumo.jp, set your filters (rental 賃貸 or sale 売買), and copy the URL from the browser address bar. Rental URLs contain /jj/chintai/ichiran/, sale URLs contain /jj/bukken/ichiran/. The actor auto-detects the listing type from the URL and paginates through all result pages.

## `maxItems` (type: `integer`):

Maximum number of listings to scrape across all search URLs.

## `maxPages` (type: `integer`):

Maximum number of result pages to crawl per search URL (0 = unlimited).

## `includeAgentInfo` (type: `boolean`):

Fetch each rental listing's detail page to extract the handling agent/store name, phone and business hours. Sale listings already include agent info in the list view. Enabling this roughly doubles the number of requests.

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

Select proxies to be used by your crawler.

## Actor input object example

```json
{
  "searchUrls": [
    "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&pc=50&smk=&po1=25&po2=99&shkr1=03&shkr2=03&shkr3=03&shkr4=03&sc=13101&ta=13&tn=13101"
  ],
  "maxItems": 100,
  "maxPages": 0,
  "includeAgentInfo": true,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

// Prepare Actor input
const input = {
    "searchUrls": [
        "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&pc=50&smk=&po1=25&po2=99&shkr1=03&shkr2=03&shkr3=03&shkr4=03&sc=13101&ta=13&tn=13101"
    ],
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ahmed_jasarevic/suumo-jp-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 = {
    "searchUrls": ["https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&pc=50&smk=&po1=25&po2=99&shkr1=03&shkr2=03&shkr3=03&shkr4=03&sc=13101&ta=13&tn=13101"],
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ahmed_jasarevic/suumo-jp-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 '{
  "searchUrls": [
    "https://suumo.jp/jj/chintai/ichiran/FR301FC001/?ar=030&bs=040&pc=50&smk=&po1=25&po2=99&shkr1=03&shkr2=03&shkr3=03&shkr4=03&sc=13101&ta=13&tn=13101"
  ],
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ahmed_jasarevic/suumo-jp-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ahmed_jasarevic/suumo-jp-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/oyWP8a60HqH0yf786/builds/1xmETzZmBEjdUUaqd/openapi.json