# at home Scraper — Japan Rental Property Data & API (`sian.agency/athome-property-scraper`) Actor at home (athome.co.jp) scraper & real estate data API for Japan rental listings. Extract rent, layout, floor area, deposit, key money, building age, station access, lat/long geo, agent contacts & photos — clean JSON/CSV, one row per room. アットホームの物件データを取得。No account needed. - **URL**: https://apify.com/sian.agency/athome-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 ## at home Scraper — Japan Rental 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 Scraper](https://img.shields.io/badge/Store-SUUMO%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) [![Bayut Property Scraper](https://img.shields.io/badge/Store-Bayut%20Property%20Scraper-93D500)](https://apify.com/sian.agency/bayut-property-scraper?fpr=sian) #### 🎉 Turn a top Japan rental portal into clean, structured data — one row per room, geo-located, ready for analysis ##### For real-estate analysts, investors, relocation agents, and data teams working the Japanese rental market --- ### 📋 Overview **Need Japanese rental listings as clean data instead of endless scrolling?** This scraper turns at home (athome.co.jp) search results into structured JSON/CSV — and it does the one thing most Japan property tools get wrong: it gives you **one clean row per room** *with* the data buyers actually need — price in JPY, **latitude/longitude geo**, **agent contact details**, deposit/key-money breakdown, and grouped facility lists. **Why analysts and agencies choose us:** - ✅ **Per-room rows**: every rentable unit becomes one clean record — no nested mess - ⚡ **Fast & lightweight**: direct extraction, no slow headless browser, no proxy overhead - 🗺️ **GPS coordinates included**: real latitude/longitude on every detail listing — map and cluster instantly - 📞 **Agent contacts**: agency name, address, phone and license number — built-in lead data - 🎯 **45+ data points**: rent (normalised to JPY), 万円 raw text, layout, area, floor, deposit, key money, building age, station access, facilities, photos - 💴 **Pay-per-result**: only pay for listings you actually receive — transparent and cheap - 💎 **Two depths**: fast *overview* for whole-market sweeps, full *detail* for JSON-LD + spec table - ✨ **Three ways in**: by prefecture slug, by pasted search URL (keeps every filter), or by listing URL --- ### ✨ Features - 🏢 **Rental listings, done right** — one record per rentable room - 💴 **Money normalised** — `11.9万円` becomes `119000` JPY *and* keeps the original string - 📐 **Rent-per-m² built in** — yield and comparison math ready out of the box - 🗺️ **Geo lat/long** — every detail listing carries real coordinates for mapping - 🚉 **Station access** — every line / station / walk-time entry captured - 📞 **Agent block** — agency name, address, phone, license number - 🛁 **Facility groups** — bath/toilet, kitchen, security, storage, equipment, TV/comms - 🔎 **Detail enrichment** — deposit, key money, guarantor, renewal fee, contract period, parking, pets, full photo set - 🔗 **Paste-a-URL mode** — apply filters on the site, paste the link, every filter is preserved - 📦 **Clean exports** — JSON, CSV, Excel straight from the dataset --- ### 🎬 Quick Start Pick a mode, give it a prefecture slug or a search URL, 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~athome-property-scraper/runs?token=YOUR_TOKEN \ -H 'Content-Type: application/json' \ -d '{"scrapeMode": "overview", "searchMode": "byPlace", "places": ["tokyo"]}' ```` *** ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Choose your input Enter a prefecture slug (e.g. `tokyo`), paste a search URL, or list specific listing URLs. #### Step 2: Pick depth `overview` for fast whole-market room cards, or `detail` for the full JSON-LD + spec table (geo, agent, facilities). #### 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-room dataset - Rent normalised to JPY plus the raw 万円 strings - Layout, area, floor, geo coordinates, deposit, station access, agent contacts, and photos *** ### 📥 Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | scrapeMode | string | No | `overview` (fast room cards) or `detail` (full JSON-LD + spec table) | | searchMode | string | No | `byPlace`, `bySearchUrl`, or `byListingUrl` | | places | array | No | Prefecture slugs, e.g. `["tokyo"]` | | wards | array | No | Optional ward/city slugs paired with `places`, e.g. `["shinjuku-city"]` | | searchUrls | array | No | Pasted search URLs (path-segment filters preserved) | | listingUrls | array | No | Detail URLs or listing codes (detail mode) | | filters | array | No | Extra path-segment filters, e.g. `1ldk`, `pet`, `walk10` | | maxResults | integer | No | Max listings per run (FREE: 25, PAID: unlimited) | **Example — overview by prefecture:** ```json { "scrapeMode": "overview", "searchMode": "byPlace", "places": ["tokyo"], "wards": ["shinjuku-city"], "maxResults": 200 } ``` **Example — detail by search URL:** ```json { "scrapeMode": "detail", "searchMode": "bySearchUrl", "searchUrls": ["https://www.athome.co.jp/chintai/tokyo/shinjuku-city/1ldk/list/"] } ``` *** ### 📤 Output Results are saved to the Apify dataset with **45+ fields** per listing, including: | Field | Type | Description | |-------|------|-------------| | listingId | string | athome listing code (物件番号) | | url | string | Canonical listing URL | | price | number | Monthly rent in JPY | | price\_text | string | Raw `11.9万円` string | | price\_per\_sqm\_jpy | number | Computed rent per m² | | layout | string | 間取り, e.g. `1K`, `2LDK` | | floor\_size\_sqm | number | 面積 in m² | | floor / floors\_total | number | Room floor / building floors | | deposit / key\_money | string | 敷金 / 礼金 | | build\_year / build\_age | number / string | Build year / 築年月 | | latitude / longitude | number | GPS coordinates (detail mode) | | address / region / locality | string | 住所 / 都道府県 / 市区町村 | | transit | array | Line / station / walk-time entries | | agent\_name / agent\_phone / agent\_license | string | Listing agency details | | bath\_toilet / kitchen / security / storage | array | Grouped facility lists | | images | array | Photo URLs | **Example:** ```json { "listingId": "6990708422", "url": "https://www.athome.co.jp/chintai/6990708422/", "propertyTitle": "Ｎ’ｓ高田馬場", "price": 119000, "price_text": "11.9万円", "price_per_sqm_jpy": 3955, "layout": "1K", "floor_size_sqm": 30.09, "floor": 4, "floors_total": 9, "deposit": "1ヶ月", "mgmt_fee": "15,000円", "build_year": 2019, "latitude": 35.7159442, "longitude": 139.6975817, "region": "東京都", "transit": ["ＪＲ山手線 / 高田馬場駅 徒歩10分"], "agent_name": "TKホーム(有)東和企画", "agent_phone": "+81-3-5332-6155", "image_count": 16 } ``` *** ### 💼 Use Cases & Examples #### 1. Rental Market Research **Analysts mapping rent-by-area across a prefecture.** **Input:** prefecture slug · **Output:** per-room 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 search URL · **Output:** rent-per-m² on every unit · **Use:** rank candidate buildings by gross yield. #### 3. Relocation & Tenant Search **Relocation agents shortlisting homes for clients.** **Input:** prefecture + 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 + agents.** **Input:** broad search by area · **Output:** building, address, layout, agent phone & license · **Use:** feed CRM pipelines. #### 5. Mapping & Geo Analysis **Data teams plotting inventory on a map.** **Input:** detail mode over a search · **Output:** latitude/longitude on every listing · **Use:** cluster, geofence, and visualise. #### 6. Academic & Policy Research **Researchers studying Japanese housing markets.** **Input:** multiple prefectures · **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/athome-property-scraper').call({ scrapeMode: 'overview', searchMode: 'byPlace', places: ['tokyo'] }); 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/athome-property-scraper').call( run_input={'scrapeMode': 'overview', 'searchMode': 'byPlace', 'places': ['tokyo']} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~athome-property-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"scrapeMode": "overview", "searchMode": "byPlace", "places": ["tokyo"]}' ``` #### 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/athome-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 for the source site?** A: No. Just provide a prefecture slug or a search URL. **Q: Are GPS coordinates included?** A: Yes — detail-mode listings carry real latitude/longitude, plus address, region, locality and station access. **Q: What output formats are available?** A: JSON, CSV, and Excel — export directly from the Apify dataset. **Q: What's the difference between overview and detail?** A: Overview is the fast room-card data. Detail fetches each listing's full page (JSON-LD + spec table) for geo, agent contacts, deposit/key-money breakdown, facilities and the full photo set, then merges them into one record. **Q: How do I filter precisely?** A: Apply your filters on the site's search UI, then paste the resulting URL in `searchUrls` — every path-segment filter is preserved. Or add slugs like `1ldk`, `pet`, `walk10` in `filters`. *** ### 🐛 Troubleshooting **No results returned** - Check the prefecture slug (e.g. `tokyo`) or that the pasted URL is a `/chintai/.../list/` search page. **Fewer rows than expected** - FREE tier caps at 25 listings per run — upgrade for unlimited. - Narrow filters 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 at home Co., Ltd. "at home" (アットホーム) and athome.co.jp are trademarks of their respective owners. Use this actor in compliance with the source 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): room-level cards from the search results — one row per rentable unit, with rent, layout, area, station access & photos. 🔎 **DETAIL** (enrich): fetches each listing's full page (JSON-LD + spec table) for price in JPY, geo lat/long, deposit, key money, building age, parking, facilities, agent contacts & full image set. Detail merges overview + detail into one record. ## `searchMode` (type: `string`): 🔀 How listings are discovered. - **byPlace** — give one or more athome prefecture slugs (e.g. `tokyo`) with optional ward/city slugs. - **bySearchUrl** — paste a ready-made athome search URL with your filters applied in the UI (most reliable). - **byListingUrl** — fetch specific listings directly (DETAIL only). ## `places` (type: `array`): 📍 **BY PREFECTURE:** athome prefecture slugs to scrape. Examples: `tokyo`, `osaka`, `kanagawa`, `aichi`, `fukuoka`. Builds `/chintai/{prefecture}/list/`. 💡 **TIP:** For precise filtering, use **bySearchUrl** instead — apply your filters in athome's UI and paste the URL. ## `wards` (type: `array`): 🏙️ **OPTIONAL (byPlace):** Ward or city slugs paired with `places` by position (e.g. `shinjuku-city`). Builds `/chintai/{prefecture}/{ward}/list/`. Leave empty to scrape the whole prefecture. ## `searchUrls` (type: `array`): 🔗 **BY SEARCH URL:** Paste one or more athome.co.jp search-results URLs (the `/chintai/.../list/` pages). Apply all your filters in the athome UI first, then copy the address — every path-segment filter is preserved. ## `listingUrls` (type: `array`): 🏠 **BY LISTING URL (DETAIL ONLY):** Paste athome detail URLs (e.g. `https://www.athome.co.jp/chintai/6990708422/`) or bare listing codes. Used with scrapeMode = detail. ## `filters` (type: `array`): 🎛️ **OPTIONAL:** Extra athome path-segment filters applied to byPlace searches. Examples: `1ldk` (layout), `pet` (pets allowed), `mansion` (building type), `walk10` (≤10 min walk), `within-10year` (build age). Each is appended to the search path. ## `maxResults` (type: `integer`): 🔢 Maximum listings to return per run. **FREE users:** capped at 25 · **PAID users:** unlimited. ## `useProxy` (type: `boolean`): 🌐 Route requests through a Japan residential proxy. **Off by default** — athome.co.jp is reachable without a proxy, so leaving this off keeps runs fast and cheap. Enable only if you hit a soft per-IP rate-gate at scale. ## Actor input object example ```json { "scrapeMode": "overview", "searchMode": "byPlace", "places": [ "tokyo" ], "maxResults": 100, "useProxy": false } ``` # Actor output Schema ## `results` (type: `string`): All scraped athome 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/athome-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 = {} # Run the Actor and wait for it to finish run = client.actor("sian.agency/athome-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 '{}' | apify call sian.agency/athome-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/athome-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "at home Scraper — Japan Rental Property Data & API", "description": "at home (athome.co.jp) scraper & real estate data API for Japan rental listings. Extract rent, layout, floor area, deposit, key money, building age, station access, lat/long geo, agent contacts & photos — clean JSON/CSV, one row per room. アットホームの物件データを取得。No account needed.", "version": "1.0", "x-build-id": "6p4d0TET0rZbjJkFI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~athome-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-athome-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~athome-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-athome-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~athome-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-athome-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): room-level cards from the search results — one row per rentable unit, with rent, layout, area, station access & photos.\n\n🔎 **DETAIL** (enrich): fetches each listing's full page (JSON-LD + spec table) for price in JPY, geo lat/long, deposit, key money, building age, parking, facilities, agent contacts & full image set. Detail merges overview + detail into one record.", "default": "overview" }, "searchMode": { "title": "🔀 Search mode", "enum": [ "byPlace", "bySearchUrl", "byListingUrl" ], "type": "string", "description": "🔀 How listings are discovered.\n\n- **byPlace** — give one or more athome prefecture slugs (e.g. `tokyo`) with optional ward/city slugs.\n- **bySearchUrl** — paste a ready-made athome search URL with your filters applied in the UI (most reliable).\n- **byListingUrl** — fetch specific listings directly (DETAIL only).", "default": "byPlace" }, "places": { "title": "📍 Prefecture slugs", "type": "array", "description": "📍 **BY PREFECTURE:** athome prefecture slugs to scrape. Examples: `tokyo`, `osaka`, `kanagawa`, `aichi`, `fukuoka`. Builds `/chintai/{prefecture}/list/`.\n\n💡 **TIP:** For precise filtering, use **bySearchUrl** instead — apply your filters in athome's UI and paste the URL.", "default": [ "tokyo" ], "items": { "type": "string" } }, "wards": { "title": "🏙️ Ward / city slugs", "type": "array", "description": "🏙️ **OPTIONAL (byPlace):** Ward or city slugs paired with `places` by position (e.g. `shinjuku-city`). Builds `/chintai/{prefecture}/{ward}/list/`. Leave empty to scrape the whole prefecture.", "items": { "type": "string" } }, "searchUrls": { "title": "🔗 Search URLs", "type": "array", "description": "🔗 **BY SEARCH URL:** Paste one or more athome.co.jp search-results URLs (the `/chintai/.../list/` pages). Apply all your filters in the athome UI first, then copy the address — every path-segment filter is preserved.", "items": { "type": "string" } }, "listingUrls": { "title": "🏠 Listing URLs", "type": "array", "description": "🏠 **BY LISTING URL (DETAIL ONLY):** Paste athome detail URLs (e.g. `https://www.athome.co.jp/chintai/6990708422/`) or bare listing codes. Used with scrapeMode = detail.", "items": { "type": "string" } }, "filters": { "title": "🎛️ Extra filters", "type": "array", "description": "🎛️ **OPTIONAL:** Extra athome path-segment filters applied to byPlace searches. Examples: `1ldk` (layout), `pet` (pets allowed), `mansion` (building type), `walk10` (≤10 min walk), `within-10year` (build age). Each is appended to the search path.", "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 }, "useProxy": { "title": "🌐 Use Japan residential proxy", "type": "boolean", "description": "🌐 Route requests through a Japan residential proxy. **Off by default** — athome.co.jp is reachable without a proxy, so leaving this off keeps runs fast and cheap. Enable only if you hit a soft per-IP rate-gate at scale.", "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 } } } } } } } } } } ```