# at home Japan Real Estate Scraper (`solidcode/athome-co-jp-scraper`) Actor

\[💰 $2.5 / 1K] Extract property listings from at home (athome.co.jp), one of Japan's largest real-estate portals. Get rent or sale prices, fees, deposit, key money, floor plan, area, station access, photos, and agency contacts. Search by prefecture and type, or paste any athome.co.jp URL.

- **URL**: https://apify.com/solidcode/athome-co-jp-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Real estate, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 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/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

## at home (アットホーム) Japan Real Estate Scraper

Pull property listings from at home (athome.co.jp), one of Japan's largest real-estate portals — monthly rents, sale prices, deposit and key money, floor layouts, station access, agency contacts, photos, and map coordinates for rentals and for-sale homes alike. Covers both 賃貸 (rental) and 売買 (for-sale) inventory across all 47 prefectures in one flat row per property. Built for Japan real-estate investors, relocation agencies, and market researchers who need structured athome.co.jp data without copy-pasting Japanese listing pages one at a time.

### Why This Scraper?

- **Both 賃貸 rentals and 売買 for-sale in one actor** — most athome tools cover rentals only; flip a single Rent/Buy switch to pull monthly-rent apartments or for-sale used condos, houses, and land from the same actor.
- **Four property categories** — rental apartments/mansions (賃貸マンション・アパート), used condominiums (中古マンション), used houses (中古一戸建て), and land (土地), each mapped to a verified search path.
- **All 47 Japanese prefectures** — from Tokyo, Osaka, and Kanagawa to Hokkaido and Fukuoka, picked from a plain-language dropdown or swept together with a single "All Japan" option.
- **Rental deposit and key money broken out** — 敷金 (deposit) and 礼金 (key money) captured as separate fields alongside 管理費 management fee, the exact numbers relocation clients and yield models actually need.
- **Every listing photo, not just a thumbnail** — full-resolution image URLs straight from the listing gallery, typically 15-24 per rental and up to 40 on for-sale homes.
- **Verified agency contact on every detail row** — realtor/agency name plus phone number and license number (免許番号), pulled straight from the listing.
- **Geo-coordinates for rental listings** — latitude and longitude on every 賃貸 detail record, ready to plot on a map or join to district data.
- **Price-per-square-meter on for-sale listings** — 平米単価 alongside the headline price, so condos and land compare on a normalized basis.
- **Nearest-station walking access as structured data** — each listing's 交通 block becomes `{ line, station, walkMinutes }` entries, up to 6 per property.

### Use Cases

**Market Research**
- Track rental and for-sale inventory across all 47 prefectures
- Compare 平米単価 (price per m²) for condos and land between wards
- Monitor the building-age and layout mix in a target city
- Benchmark 管理費, 敷金, and 礼金 norms by prefecture

**Investment Analysis**
- Model rental yields with monthly rent, management fee, deposit, and key money in one row
- Compare for-sale asking prices against price-per-m² across neighborhoods
- Screen used condos and houses by build year and floor area
- Map rental listings by latitude/longitude to spot under-served pockets

**Relocation & Property Services**
- Build shortlists of rentals near a specific train line and walking distance
- Surface pet-friendly or furnished options by pasting a pre-filtered athome.co.jp URL
- Hand overseas clients clean structured data instead of Japanese-only web pages

**Lead Generation**
- Assemble agency contact lists — name and phone — from active listings
- Identify the brokerages listing the most inventory in a prefecture
- Target agencies by license number and coverage area

**Data Enrichment & Integration**
- Enrich a CRM with fresh athome.co.jp pricing and listing status
- Feed listing photos and building specs into a property comparison tool
- Power dashboards that track rent and sale trends over time

### Getting Started

#### Rentals in Tokyo

The simplest way to start — pick Rent, a prefecture, and a cap:

```json
{
    "transactionType": "rent",
    "prefecture": "tokyo",
    "maxResults": 50
}
````

#### For-Sale Used Condos in Osaka

```json
{
    "transactionType": "buy",
    "propertyType": "used-condo",
    "prefecture": "osaka",
    "maxResults": 200
}
```

#### Land Across Fukuoka, Fast Overview Only

Turn off full details for a lighter run that still returns price, layout, area, and address:

```json
{
    "transactionType": "buy",
    "propertyType": "land",
    "prefecture": "fukuoka",
    "maxResults": 500,
    "includeDetails": false
}
```

#### Paste Your Own Filtered athome.co.jp URLs

Already built a filtered search in your browser? Paste the URLs — the guided fields are ignored and your filters are preserved:

```json
{
    "startUrls": [
        "https://www.athome.co.jp/chintai/tokyo/list/",
        "https://www.athome.co.jp/chintai/6991146975/"
    ],
    "maxResults": 300,
    "includeDetails": true
}
```

### Input Reference

#### What to Collect

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `transactionType` | select | `For Rent (賃貸)` | Collect rental listings (賃貸) or properties for sale (売買). Ignored when Start URLs are provided. |
| `propertyType` | select | `Any` | Property category: Any, Rental Apartment / Mansion (賃貸マンション・アパート), Used Condo (中古マンション), House (中古一戸建て), or Land (土地). Applies to Buy searches. Ignored when Start URLs are provided. |
| `prefecture` | select | `Tokyo (東京都)` | One of Japan's 47 prefectures (都道府県), or All Japan. Ignored when Start URLs are provided. |

#### Advanced Search

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | string\[] | `[]` | Paste athome.co.jp URLs directly — search-result, area, category, or individual listing pages. Overrides the guided fields above and preserves any filters already in the URL (price, area, layout, walk time, sort). |

#### Options

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `100` | Maximum listings to collect across all searches and URLs combined. Set 0 for no limit (collects all available, up to a safety ceiling of 20,000 per run). Start with 20-50 to test, then increase. |
| `includeDetails` | boolean | `true` | Open each listing's detail page for the full record — all photos, facilities, agency name and phone, exact address, geo-coordinates, and building specs. Slower but much richer. When off, only result-page fields are returned. |

### Output

A representative rental result with full details enabled:

```json
{
    "listingId": "6991146975",
    "url": "https://www.athome.co.jp/chintai/6991146975/",
    "transactionType": "rent",
    "propertyType": "apartment",
    "title": "シティタワー品川 12階 1LDK",
    "buildingName": "シティタワー品川",
    "price": 189000,
    "priceText": "18.9万円",
    "managementFee": 15000,
    "deposit": 189000,
    "keyMoney": 189000,
    "depositText": "1ヶ月",
    "keyMoneyText": "1ヶ月",
    "layout": "1LDK",
    "areaSqm": 45.2,
    "floor": "12階",
    "floorsTotal": "34階建",
    "buildYear": 2019,
    "buildAge": 6,
    "structure": "鉄筋コンクリート造",
    "address": "東京都品川区南大井３丁目",
    "prefecture": "東京都",
    "city": "品川区",
    "latitude": 35.5921,
    "longitude": 139.7412,
    "stationAccess": [
        { "line": "京急本線", "station": "大森海岸駅", "walkMinutes": 5 }
    ],
    "facilities": {
        "バス・トイレ": ["バス・トイレ別", "追焚機能"],
        "キッチン": ["システムキッチン", "コンロ2口"],
        "セキュリティー": ["オートロック", "TVモニタ付インターホン"]
    },
    "images": ["https://cdn.athome.jp/.../image_files/abc123.jpeg"],
    "imageCount": 16,
    "agencyName": "アットホーム不動産 品川店",
    "agencyPhone": "03-1234-5678",
    "agencyLicense": "東京都知事(3)第12345号",
    "parking": "近隣 月額33,000円",
    "contractPeriod": "2年",
    "currentStatus": "空室",
    "infoPublishDate": "2026-07-01",
    "scrapedAt": "2026-07-11T09:15:00Z"
}
```

#### Core Fields

| Field | Type | Description |
|-------|------|-------------|
| `listingId` | string | Stable athome.co.jp listing ID (deduplication key) |
| `url` | string | Canonical listing detail URL |
| `title` | string | Property or building title |
| `transactionType` | string | `rent` or `buy` |
| `propertyType` | string | `apartment`, `used-condo`, `house`, or `land` |
| `buildingName` | string | Building name (rentals) |
| `layout` | string | Floor plan 間取り (e.g. "1LDK", "2K") |
| `areaSqm` | number | Floor area 専有面積 in m² |
| `floor` | string | Floor of the unit |
| `floorsTotal` | string | Total floors in the building |
| `buildYear` | number | Construction year 築年 |
| `buildAge` | number | Building age in years |
| `structure` | string | Building structure 建物構造 |
| `currentStatus` | string | Availability 現況 (e.g. "空室") |
| `infoPublishDate` | string | Date the listing was published |
| `scrapedAt` | string | ISO timestamp of data extraction |

#### Pricing & Fees

| Field | Type | Description |
|-------|------|-------------|
| `price` | number | Price in JPY — monthly rent (rent) or total price (buy) |
| `priceText` | string | Original display price (e.g. "18.9万円") |
| `pricePerSqm` | number | Price per m² 平米単価 in JPY (for-sale) |
| `managementFee` | number | Management / common-service fee 管理費 (JPY) |
| `deposit` | number | Deposit 敷金 (JPY) |
| `keyMoney` | number | Key money 礼金 (JPY, rentals) |
| `depositText`, `keyMoneyText` | string | Original deposit / key-money text (may be "1ヶ月") |
| `maintenanceReserve` | number | Repair-reserve fund 修繕積立金 (for-sale condos) |
| `landAreaSqm` | number | Land area 土地面積 in m² (for-sale) |
| `buildingAreaSqm` | number | Building area 建物面積 in m² (for-sale) |

#### Location

| Field | Type | Description |
|-------|------|-------------|
| `address` | string | Full address 所在地 |
| `prefecture` | string | Prefecture 都道府県 |
| `city` | string | City or ward 市区町村 |
| `latitude` | number | Latitude — rental listings only |
| `longitude` | number | Longitude — rental listings only |
| `stationAccess` | object\[] | Nearest stations: `{ line, station, walkMinutes }`, up to 6 (`line` is null for bus-stop or airport access) |

#### Agency Contact

| Field | Type | Description |
|-------|------|-------------|
| `agencyName` | string | Listing agency name |
| `agencyPhone` | string | Agency phone number |
| `agencyLicense` | string | Agency license number 免許番号 |

#### Media & Features

Populated when **Include Full Listing Details** is on.

| Field | Type | Description |
|-------|------|-------------|
| `images` | string\[] | Listing photo URLs (typically 15-24 on rentals, up to 40 on for-sale homes) |
| `imageCount` | number | Number of photos |
| `thumbnail` | string | Result-page thumbnail URL |
| `facilities` | object | Grouped feature lists — bath/toilet, kitchen, security, storage, equipment |
| `parking` | string | Parking availability 駐車場 |
| `contractPeriod` | string | Contract term 契約期間 (rentals) |

### Tips for Best Results

- **Start small** — set `maxResults` to 20-50 on your first run to confirm the fields match your needs, then scale up.
- **Toggle details for speed vs. depth** — keep **Include Full Listing Details** on for photos, geo-coordinates, agency contact, and building specs; turn it off for a faster run when you only need price, layout, area, and address.
- **For-sale listings have no geo-coordinates** — use rentals (賃貸) when you need latitude and longitude for map plotting; for-sale rows return everything else but leave the coordinates empty.
- **Paste a filtered athome.co.jp URL to keep your exact facets** — anything you set in the browser (price band, layout, walk time, sort) is preserved when you drop the URL into Start URLs.
- **Deposit and key money often display as months** — values like "1ヶ月" are kept in `depositText` / `keyMoneyText`, while the numeric `deposit` / `keyMoney` fields fill only when the listing quotes a yen amount.
- **Sweep a market with `maxResults: 0`** — no-limit mode keeps paginating and collects all available listings, up to a safety ceiling of 20,000 per run; a single large prefecture easily returns tens of thousands, so split very large markets across multiple runs (e.g. by city or filtered URL) to go deeper.
- **Use All Japan for dense results fast** — it scans the biggest markets first (Tokyo, Kanagawa, Osaka, Aichi, Fukuoka) before the smaller ones.

### Pricing

**From $2.50 per 1,000 results** — a flat, predictable rate that undercuts other athome.co.jp tools and never caps your free tier. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.30 | $0.28 | $0.27 | $0.25 |
| 1,000 | $3.00 | $2.80 | $2.65 | $2.50 |
| 10,000 | $30.00 | $28.00 | $26.50 | $25.00 |
| 100,000 | $300.00 | $280.00 | $265.00 | $250.00 |

A "result" is any property row in the output dataset. Platform fees are additional and depend on your Apify plan.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor is designed for legitimate real estate research, market analysis, and lead generation. You are responsible for complying with applicable laws and athome.co.jp's Terms of Service. Do not use extracted data for spam, harassment, or any illegal purpose, and handle any personal information — such as agency contact details — in line with applicable privacy regulations.

# Actor input Schema

## `transactionType` (type: `string`):

Collect rental listings (賃貸) or properties for sale (売買). Ignored when Start URLs are provided.

## `propertyType` (type: `string`):

Property category to search. Choose 'Any' to include all available types. Applies to Buy searches; rental searches always return apartments/mansions. Ignored when Start URLs are provided.

## `prefecture` (type: `string`):

Prefecture (都道府県) to search. Choose 'All Japan' to search the whole country. Ignored when Start URLs are provided.

## `startUrls` (type: `array`):

Power-user input. Paste athome.co.jp URLs directly — search-result pages, area or category pages, or individual listing pages. When provided, these override the Rent/Buy, Property Type, and Prefecture settings above, and any filters already in the URL (price, area, layout, walk time, sort) are preserved.

## `maxResults` (type: `integer`):

Maximum number of listings to collect across all searches and URLs combined. Set 0 for no limit (collects all available results, capped at an internal safety ceiling of 20,000 per run). Results are collected in full pages, so the final page may overshoot this cap by a few listings. Tip: start with 20-50 to test, then increase.

## `includeDetails` (type: `boolean`):

Open each listing's detail page to capture the full record — all photos, facilities, agency name and phone, exact address, geo coordinates, and building specs (structure, floor, build year). Slower but much richer. When off, only the fields shown on result pages are returned.

## Actor input object example

```json
{
  "transactionType": "rent",
  "propertyType": "any",
  "prefecture": "tokyo",
  "startUrls": [],
  "maxResults": 100,
  "includeDetails": true
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of scraped athome.co.jp listings with key fields.

# 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 = {
    "transactionType": "rent",
    "propertyType": "any",
    "prefecture": "tokyo",
    "startUrls": [],
    "maxResults": 100,
    "includeDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/athome-co-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 = {
    "transactionType": "rent",
    "propertyType": "any",
    "prefecture": "tokyo",
    "startUrls": [],
    "maxResults": 100,
    "includeDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/athome-co-jp-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 '{
  "transactionType": "rent",
  "propertyType": "any",
  "prefecture": "tokyo",
  "startUrls": [],
  "maxResults": 100,
  "includeDetails": true
}' |
apify call solidcode/athome-co-jp-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/athome-co-jp-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "at home Japan Real Estate Scraper",
        "description": "[💰 $2.5 / 1K] Extract property listings from at home (athome.co.jp), one of Japan's largest real-estate portals. Get rent or sale prices, fees, deposit, key money, floor plan, area, station access, photos, and agency contacts. Search by prefecture and type, or paste any athome.co.jp URL.",
        "version": "1.0",
        "x-build-id": "BGsc2IG6v48QV53DB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solidcode~athome-co-jp-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solidcode-athome-co-jp-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/solidcode~athome-co-jp-scraper/runs": {
            "post": {
                "operationId": "runs-sync-solidcode-athome-co-jp-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/solidcode~athome-co-jp-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-solidcode-athome-co-jp-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "transactionType": {
                        "title": "Rent or Buy",
                        "enum": [
                            "rent",
                            "buy"
                        ],
                        "type": "string",
                        "description": "Collect rental listings (賃貸) or properties for sale (売買). Ignored when Start URLs are provided.",
                        "default": "rent"
                    },
                    "propertyType": {
                        "title": "Property Type",
                        "enum": [
                            "any",
                            "apartment",
                            "used-condo",
                            "house",
                            "land"
                        ],
                        "type": "string",
                        "description": "Property category to search. Choose 'Any' to include all available types. Applies to Buy searches; rental searches always return apartments/mansions. Ignored when Start URLs are provided.",
                        "default": "any"
                    },
                    "prefecture": {
                        "title": "Prefecture",
                        "enum": [
                            "all",
                            "hokkaido",
                            "aomori",
                            "iwate",
                            "miyagi",
                            "akita",
                            "yamagata",
                            "fukushima",
                            "ibaraki",
                            "tochigi",
                            "gunma",
                            "saitama",
                            "chiba",
                            "tokyo",
                            "kanagawa",
                            "niigata",
                            "toyama",
                            "ishikawa",
                            "fukui",
                            "yamanashi",
                            "nagano",
                            "gifu",
                            "shizuoka",
                            "aichi",
                            "mie",
                            "shiga",
                            "kyoto",
                            "osaka",
                            "hyogo",
                            "nara",
                            "wakayama",
                            "tottori",
                            "shimane",
                            "okayama",
                            "hiroshima",
                            "yamaguchi",
                            "tokushima",
                            "kagawa",
                            "ehime",
                            "kochi",
                            "fukuoka",
                            "saga",
                            "nagasaki",
                            "kumamoto",
                            "oita",
                            "miyazaki",
                            "kagoshima",
                            "okinawa"
                        ],
                        "type": "string",
                        "description": "Prefecture (都道府県) to search. Choose 'All Japan' to search the whole country. Ignored when Start URLs are provided.",
                        "default": "tokyo"
                    },
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "Power-user input. Paste athome.co.jp URLs directly — search-result pages, area or category pages, or individual listing pages. When provided, these override the Rent/Buy, Property Type, and Prefecture settings above, and any filters already in the URL (price, area, layout, walk time, sort) are preserved.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of listings to collect across all searches and URLs combined. Set 0 for no limit (collects all available results, capped at an internal safety ceiling of 20,000 per run). Results are collected in full pages, so the final page may overshoot this cap by a few listings. Tip: start with 20-50 to test, then increase.",
                        "default": 100
                    },
                    "includeDetails": {
                        "title": "Include Full Listing Details",
                        "type": "boolean",
                        "description": "Open each listing's detail page to capture the full record — all photos, facilities, agency name and phone, exact address, geo coordinates, and building specs (structure, floor, build year). Slower but much richer. When off, only the fields shown on result pages are returned.",
                        "default": true
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```