# goo Housing Scraper — Japan Property Data & API (`sian.agency/goo-housing-property-scraper`) Actor goo housing scraper & real estate data API for house.goo.ne.jp (NTT goo 住宅・不動産). Rent & sale listings: price, layout, area, floor, deposit, key money, building age, structure, station access, photos — clean JSON/CSV, one row per unit. Fast overview or full detail. No account needed. - **URL**: https://apify.com/sian.agency/goo-housing-property-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 overview listing extracteds 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 ## goo Housing Scraper — Japan Property Data & API 🏯 [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![SUUMO Property Scraper](https://img.shields.io/badge/Store-SUUMO%20Property%20Scraper-1AE392)](https://apify.com/sian.agency/suumo-property-scraper?fpr=sian) [![Immobiliare.it Scraper](https://img.shields.io/badge/Store-Immobiliare.it%20Scraper-1AE392)](https://apify.com/sian.agency/immobiliare-property-scraper?fpr=sian) [![Trip.com Scraper](https://img.shields.io/badge/Store-Trip.com%20Scraper-93D500)](https://apify.com/sian.agency/trip-com-scraper?fpr=sian) #### 🎉 Turn Japan's goo 住宅・不動産 portal into clean, structured data — one row per unit, ready for analysis ##### For real-estate analysts, investors, relocation agents, and data teams working the Japanese rental & sale market --- ### 📋 Overview **Need Japanese rental and sale listings as clean data instead of endless scrolling?** This scraper turns house.goo.ne.jp search results into structured JSON/CSV — one clean record per listing, with prices normalised to JPY, layout, area, deposit, key money, station access and photos. **Why analysts and agencies choose us:** - ✅ **One clean row per unit** — every result card becomes a structured record, no nested mess - ⚡ **Fast & lightweight** — direct extraction, no slow headless browser, no proxy overhead - 🎯 **40+ data points** — price (normalised to JPY), 万円 raw text, layout, area, floor, deposit, key money, building age & structure, station access, photos - 📡 **Source provenance** — surfaces the origin-portal listing id, so you can trace each aggregated listing back to its feed - 💴 **Pay-per-result** — only pay for listings you actually receive — transparent and cheap - 💎 **Two depths** — fast *overview* for whole-market sweeps, full *detail* for the spec table (structure, year built, orientation, guarantor company, agent, facility flags, equipment) - ✨ **Three ways in** — by pasted goo search URL (keeps every filter), by area (region + prefecture + city codes), or by listing URL --- ### ✨ Features - 🏢 **Listings, done right** — clean per-unit records from the result list - 💴 **Money normalised** — `6.10万円` becomes `61000` JPY *and* keeps the original string - 📐 **Price-per-m² built in** — yield and comparison math ready out of the box - 🚉 **Station access** — every line + station + walk-minute captured - 🔎 **Detail enrichment** — building structure, year built, orientation, contract terms, guarantor company, agent, facility flags, equipment, full photo set - 📡 **Feed provenance** — the 情報提供元 source-portal id on every detail record - 🔗 **Paste-a-URL mode** — apply filters in goo's UI, paste the link, every supported filter is preserved - 📦 **Clean exports** — JSON, CSV, Excel straight from the dataset - 🌐 **Optional Japan proxy** — off by default, available as a one-click escape hatch --- ### 🎬 Quick Start Pick a mode, give it a goo search URL (or an area), and run. Listings stream into your dataset as clean rows. Export as JSON, CSV, or Excel. ```bash curl -X POST https://api.apify.com/v2/acts/sian.agency~goo-housing-property-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"scrapeMode": "overview", "searchMode": "bySearchUrl", "searchUrls": ["https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html"]}' ```` *** ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Choose your input Paste a goo result-list URL, give a region + prefecture + city codes, or list specific listing URLs. #### Step 2: Pick depth `overview` for fast whole-market unit cards, or `detail` for the full spec table. #### Step 3: Run & export Start the run and download your results as JSON, CSV, or Excel. **That's it! In under a minute, you'll have:** - A clean, per-unit dataset - Prices normalised to JPY plus the raw 万円 strings - Layout, area, floor, deposit, station access, and photos *** ### 📥 Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | scrapeMode | string | No | `overview` (fast unit cards) or `detail` (full spec table) | | searchMode | string | No | `bySearchUrl`, `byArea`, or `byListingUrl` | | searchUrls | array | No | Pasted goo result-list URLs (filters preserved) | | region | string | No | Region segment, e.g. `shuto` (byArea) | | pref | string | No | Prefecture slug, e.g. `tokyo` (byArea) | | cityCodes | array | No | JIS municipal codes, e.g. `["13106"]` (byArea) | | vertical | string | No | goo vertical, e.g. `ap` (rent apartment) | | contract | string | No | `rent` or `buy` | | listingUrls | array | No | goo detail URLs (detail mode) | | maxResults | integer | No | Max listings per run (FREE: 25, PAID: unlimited) | **Example — overview by search URL:** ```json { "scrapeMode": "overview", "searchMode": "bySearchUrl", "searchUrls": ["https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html"], "maxResults": 200 } ``` **Example — detail by area:** ```json { "scrapeMode": "detail", "searchMode": "byArea", "region": "shuto", "pref": "tokyo", "cityCodes": ["13106"] } ``` *** ### 📤 Output Results are saved to the Apify dataset with **40+ fields** per listing, including: | Field | Type | Description | |-------|------|-------------| | listingId | string | Stable goo listing id | | url | string | Canonical listing URL | | provider\_id / data\_source | string | Origin-portal listing id + source label | | price | number | Rent/sale price in JPY | | price\_formatted | string | Raw `6.10万円` string | | price\_per\_sqm\_jpy | number | Computed price per m² | | layout | string | 間取り, e.g. `1K`, `2LDK` | | area\_m2 | number | 専有面積 in m² | | floor | string | Unit floor | | deposit / key\_money | string | 敷金 / 礼金 | | building\_age / built\_date / building\_structure | string | Age / 築年月 / structure | | transit | array | Line + station + walk-time | | address | string | 所在地 | | images | array | Photo URLs | | orientation / guarantor\_company / agent / equipment | string/array | Detail-mode spec fields | **Example:** ```json { "listingId": "030H100512562756_149891008", "url": "https://house.goo.ne.jp/rent/ap/detail/1/13106/030H100512562756/149891008/x1030H100512562756.html", "propertyTitle": "ＳＭＤ下田ビル", "data_source": "SUUMO[030H100512562756]", "price": 61000, "price_formatted": "6.10万円", "price_per_sqm_jpy": 3320, "layout": "1K", "area_m2": 18.37, "building_structure": "RC", "mgmt_fee": 6000, "address": "東京都台東区根岸１", "transit": ["ＪＲ山手線 鶯谷駅 徒歩1分"], "orientation": "南西", "image_count": 30 } ``` *** ### 💼 Use Cases & Examples #### 1. Rental Market Research **Analysts mapping rent-by-area across a prefecture.** **Input:** a goo result-list URL · **Output:** per-unit dataset with price & m² · **Use:** build a rent heatmap by ward and station. #### 2. Property Investment Analysis **Investors comparing yields across buildings.** **Input:** a filtered goo search URL · **Output:** price-per-m² on every unit · **Use:** rank candidate buildings by gross yield. #### 3. Relocation & Tenant Search **Relocation agents shortlisting homes for clients.** **Input:** area + layout/budget filters · **Output:** clean rows with deposit, key money, station walk-time · **Use:** hand clients a tidy comparison sheet. #### 4. Real-Estate Lead Generation **Agencies building prospect lists of active listings.** **Input:** broad search by area · **Output:** building, address, layout, agent-contact records · **Use:** feed CRM pipelines. #### 5. Price & Trend Monitoring **Data teams tracking rent movements over time.** **Input:** scheduled runs on the same search · **Output:** snapshots to diff week-over-week · **Use:** detect price changes and new inventory. #### 6. Academic & Policy Research **Researchers studying Japanese housing markets.** **Input:** multiple areas · **Output:** structured, reproducible datasets · **Use:** quantitative housing studies. *** ### 🔗 Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/goo-housing-property-scraper').call({ scrapeMode: 'overview', searchMode: 'bySearchUrl', searchUrls: ['https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html'] }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/goo-housing-property-scraper').call( run_input={'scrapeMode': 'overview', 'searchMode': 'bySearchUrl', 'searchUrls': ['https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html']} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~goo-housing-property-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"scrapeMode": "overview", "searchMode": "bySearchUrl", "searchUrls": ["https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html"]}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule or webhook 2. **HTTP Request**: Call the actor API 3. **Process**: Handle the JSON results 4. **Action**: Save to a sheet, notify, or sync to CRM *** ### 📊 Performance & Pricing #### FREE Tier (Try It Now) - **25 listings** per run — full feature access, same quality - No credit card required - Perfect for testing and small projects #### PAID Tier (Production Ready) - **Unlimited** listings per run - Pay-per-result: only charged for listings you actually receive 💴 **Cheap by design** — direct extraction with no proxy overhead keeps the per-listing price among the lowest for Japanese real-estate data. 🔗 [View current pricing](https://apify.com/sian.agency/goo-housing-property-scraper?fpr=sian) *** ### ❓ Frequently Asked Questions **Q: How many listings can I scrape?** A: FREE tier: 25 per run. PAID tier: unlimited. **Q: Do I need an account or API key?** A: No. Just provide a search URL or an area. **Q: What output formats are available?** A: JSON, CSV, and Excel — export directly from the Apify dataset. **Q: Are GPS coordinates included?** A: The listing pages do not expose latitude/longitude, so those fields are empty. Address and station access are included. **Q: What's the difference between overview and detail?** A: Overview is the fast result-card data. Detail fetches each listing's full page for extra specs (structure, year built, orientation, guarantor company, agent, facility flags, equipment) and merges them in. **Q: What is the provider id / data source field?** A: goo aggregates listings from partner portals. The detail record surfaces the origin-portal id (情報提供元), so you can trace and de-duplicate against the source feed. *** ### 🐛 Troubleshooting **No results returned** - Check that the pasted URL is a house.goo.ne.jp result-list page, or that region/prefecture/city codes are valid. **Fewer rows than expected** - FREE tier caps at 25 listings per run — upgrade for unlimited. - Narrow filters in the goo UI may simply return fewer listings. **A specific listing failed in detail mode** - The listing may have expired or been delisted; the run continues and skips it. *** ### ⚖️ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). > **Disclaimer:** This is an independent tool and is not affiliated with, endorsed by, or sponsored by goo, house.goo.ne.jp, or NTT Resonant / NTT Docomo. "goo" is a trademark of its respective owner. Use this actor in compliance with the site's terms of service and all applicable laws. *** ### 🤝 Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - 📧 *** **Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `scrapeMode` (type: `string`): 🧭 **OVERVIEW** (cheap, primary): unit-level cards from the result list — one row per listing, with price, layout, area, floor, deposit, key money, station access & photos. 🔎 **DETAIL** (enrich): fetches each listing's full page for the spec table — building structure, year built, orientation, contract terms, guarantor company, agent, facility flags, equipment, full image set. Detail merges overview + detail into one record. ## `searchMode` (type: `string`): 🔀 How listings are discovered. - **bySearchUrl** — paste a ready-made goo result-list URL with your filters applied in the UI (most reliable). - **byArea** — give a region, prefecture slug and one or more JIS municipal codes. - **byListingUrl** — fetch specific listings directly (DETAIL only). ## `searchUrls` (type: `array`): 🔗 **BY SEARCH URL:** Paste one or more goo result-list URLs (the `/rent/...` or `/buy/...` pages). Apply all your filters in the goo UI first, then copy the address — every supported filter is preserved. 💡 **TIP:** Example — `https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html` ## `region` (type: `string`): 🗺️ **BY AREA:** Region segment used in goo URLs. Examples: `shuto` (Kanto / Tokyo metro), `kansai`, `toukai`, `kyushu`, `touhoku`, `hokkaidou`. ## `pref` (type: `string`): 🏯 **BY AREA:** Prefecture slug. Examples: `tokyo`, `osaka`, `kanagawa`, `aichi`, `fukuoka`. ## `cityCodes` (type: `array`): 🔢 **BY AREA:** One or more JIS municipal codes to scrape. Example: `13106` = Taito-ku, Tokyo. ## `vertical` (type: `string`): 🏘️ goo vertical (path segment). `ap` = 賃貸マンション/アパート (rent apartment, default). Buy verticals: `bm` new mansion, `um` used mansion, `bh` new house, `uh` used house, `la` land. ## `contract` (type: `string`): 📜 `rent` (賃貸, default) or `buy` (購入). Used with **byArea** to build the result-list URL. ## `listingUrls` (type: `array`): 🏠 **BY LISTING URL (DETAIL ONLY):** Paste goo detail URLs (e.g. `https://house.goo.ne.jp/rent/ap/detail/1/13106/030H100512562756/149891008/x1030H100512562756.html`). Used with scrapeMode = detail. ## `maxResults` (type: `integer`): 🔢 Maximum listings to return per run. **FREE users:** capped at 25 · **PAID users:** unlimited. ## `maxPages` (type: `integer`): 📄 Maximum result-list pages to paginate per search before stopping. ## `useProxy` (type: `boolean`): 🌐 Route requests through a Japan residential proxy. **Off by default** — house.goo.ne.jp is reachable without a proxy, so leaving this off keeps runs fast and cheap. Enable only if you hit a rate-limit or geo-block. ## Actor input object example ```json { "scrapeMode": "overview", "searchMode": "bySearchUrl", "searchUrls": [ "https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html" ], "vertical": "ap", "contract": "rent", "maxResults": 100, "maxPages": 5, "useProxy": false } ``` # Actor output Schema ## `results` (type: `string`): All scraped goo housing listings as a clean JSON/CSV dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrls": [ "https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/goo-housing-property-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/goo-housing-property-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 '{ "searchUrls": [ "https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html" ] }' | apify call sian.agency/goo-housing-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/goo-housing-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "goo Housing Scraper — Japan Property Data & API", "description": "goo housing scraper & real estate data API for house.goo.ne.jp (NTT goo 住宅・不動産). Rent & sale listings: price, layout, area, floor, deposit, key money, building age, structure, station access, photos — clean JSON/CSV, one row per unit. Fast overview or full detail. No account needed.", "version": "1.0", "x-build-id": "DrnsagMhnptWM1UxM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~goo-housing-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-goo-housing-property-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/sian.agency~goo-housing-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-goo-housing-property-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/sian.agency~goo-housing-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-goo-housing-property-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": { "scrapeMode": { "title": "🧭 Scrape mode", "enum": [ "overview", "detail" ], "type": "string", "description": "🧭 **OVERVIEW** (cheap, primary): unit-level cards from the result list — one row per listing, with price, layout, area, floor, deposit, key money, station access & photos.\n\n🔎 **DETAIL** (enrich): fetches each listing's full page for the spec table — building structure, year built, orientation, contract terms, guarantor company, agent, facility flags, equipment, full image set. Detail merges overview + detail into one record.", "default": "overview" }, "searchMode": { "title": "🔀 Search mode", "enum": [ "bySearchUrl", "byArea", "byListingUrl" ], "type": "string", "description": "🔀 How listings are discovered.\n\n- **bySearchUrl** — paste a ready-made goo result-list URL with your filters applied in the UI (most reliable).\n- **byArea** — give a region, prefecture slug and one or more JIS municipal codes.\n- **byListingUrl** — fetch specific listings directly (DETAIL only).", "default": "bySearchUrl" }, "searchUrls": { "title": "🔗 Search URLs", "type": "array", "description": "🔗 **BY SEARCH URL:** Paste one or more goo result-list URLs (the `/rent/...` or `/buy/...` pages). Apply all your filters in the goo UI first, then copy the address — every supported filter is preserved.\n\n💡 **TIP:** Example — `https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html`", "default": [ "https://house.goo.ne.jp/rent/shuto_ap/area_tokyo/13106.html" ], "items": { "type": "string" } }, "region": { "title": "🗺️ Region", "type": "string", "description": "🗺️ **BY AREA:** Region segment used in goo URLs. Examples: `shuto` (Kanto / Tokyo metro), `kansai`, `toukai`, `kyushu`, `touhoku`, `hokkaidou`." }, "pref": { "title": "🏯 Prefecture slug", "type": "string", "description": "🏯 **BY AREA:** Prefecture slug. Examples: `tokyo`, `osaka`, `kanagawa`, `aichi`, `fukuoka`." }, "cityCodes": { "title": "🔢 JIS city codes", "type": "array", "description": "🔢 **BY AREA:** One or more JIS municipal codes to scrape. Example: `13106` = Taito-ku, Tokyo.", "items": { "type": "string" } }, "vertical": { "title": "🏘️ Vertical", "type": "string", "description": "🏘️ goo vertical (path segment). `ap` = 賃貸マンション/アパート (rent apartment, default). Buy verticals: `bm` new mansion, `um` used mansion, `bh` new house, `uh` used house, `la` land.", "default": "ap" }, "contract": { "title": "📜 Contract", "enum": [ "rent", "buy" ], "type": "string", "description": "📜 `rent` (賃貸, default) or `buy` (購入). Used with **byArea** to build the result-list URL.", "default": "rent" }, "listingUrls": { "title": "🏠 Listing URLs", "type": "array", "description": "🏠 **BY LISTING URL (DETAIL ONLY):** Paste goo detail URLs (e.g. `https://house.goo.ne.jp/rent/ap/detail/1/13106/030H100512562756/149891008/x1030H100512562756.html`). Used with scrapeMode = detail.", "items": { "type": "string" } }, "maxResults": { "title": "🔢 Max results", "minimum": 1, "type": "integer", "description": "🔢 Maximum listings to return per run. **FREE users:** capped at 25 · **PAID users:** unlimited.", "default": 100 }, "maxPages": { "title": "📄 Max pages", "minimum": 1, "type": "integer", "description": "📄 Maximum result-list pages to paginate per search before stopping.", "default": 5 }, "useProxy": { "title": "🌐 Use Japan residential proxy", "type": "boolean", "description": "🌐 Route requests through a Japan residential proxy. **Off by default** — house.goo.ne.jp is reachable without a proxy, so leaving this off keeps runs fast and cheap. Enable only if you hit a rate-limit or geo-block.", "default": false } } }, "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 } } } } } } } } } } ```