# Suumo Apartments Listings Scraper This is a template for extracting property information (such as location, land area, etc.) from the list of SUUMO used apartments via URL. - Template page: [https://www.octoparse.com/template/suumo-used-apartments-listings-scraper](https://www.octoparse.com/template/suumo-used-apartments-listings-scraper) - Categories: Real Estate - Status: `PUBLISHED` - Run mode: `BOTH` ## Pricing Free. ## What is an Octoparse template? An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters. ## Overview This ready-to-use template collects structured data from listing pages. ## Output The current workflow extracts 13 fields, including `Original_URL`, `バルコニー`, `会員名`, `専有面積`, `所在地`, `接客評価コメント`, `沿線_駅`, `物件名`, `物件名_URL`, `築年月`, `販売価格`, `間取り`, `電話番号`. ## Use Cases - Use structured results for research, comparison, and monitoring. - Collect rows without building the extraction workflow from scratch. - Combine results with other templates for downstream enrichment. - Review a representative result before starting a large batch. ## Why Octoparse - **No coding required:** complete Enter result URLs(Max 10) and start the template in local or cloud mode. - **Flexible export:** review and export results as CSV, Excel, or JSON. ## Input ### Enter result URLs(Max 10) Required. Enter result URLs(Max 10) Constraints: minItems=1; maxItems=10; items.minLength=1; items.maxLength=10000. ## How to Use # Suumo Apartments Listings Scraper — Usage Guide ## Purpose This template collects used-apartment listing data from SUUMO result pages. It extracts property information such as location, price, floor area, floor plan, and listing URLs from one or more SUUMO search-result URLs. Source: [https://suumo.jp/](https://suumo.jp/) ## Price This template currently has no per-line charge. ## Input - **Enter result URLs(Max 10)** — required. Enter one or more SUUMO listing-result URLs, one per line. ## How to Use 1. Open the template and select **Try it** or **Start**. 2. Enter up to 10 SUUMO result URLs in the **Enter result URLs(Max 10)** field. 3. Choose **local** or **cloud** run. 4. Review the returned rows and export or process the structured data. ## Output Fields The template returns these fields: - `物件名` - `物件名_URL` - `販売価格` - `所在地` - `沿線_駅` - `専有面積` - `間取り` - `バルコニー` - `築年月` - `会員名` - `接客評価コメント` - `電話番号` - `Original_URL` Some fields may be empty when the source listing does not provide them, especially `接客評価コメント`, `電話番号`, and `Original_URL`. ## Limitations - The template collects only the fields listed above from the SUUMO listing or search-result page. - It does not add data that SUUMO does not display. - It does not collect complete detail-page data; use a detail-page template if deeper record data is required. ## Tips - Start with one or a few URLs, review the returned rows, then scale up. - Use the most specific valid result URLs to reduce unrelated or duplicate records. - Use a stable field such as `物件名_URL` or `物件名` as a deduplication key when available. ## Scheduling and Data Export You can schedule recurring runs and export collected data to CSV, Excel, JSON, databases, or cloud storage. You can also reuse the data through Octoparse APIs or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates). Scheduling and API access may require a paid Octoparse plan. For local scheduled runs, keep your computer and Octoparse open. ## Notes テンプレートをカスタマイズしたい場合、お気軽に support@octoparse.com までお問い合わせください。 ## Limitations Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above. ## Tips Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed. ## FAQ ### What do I need to enter? Use the exact inputs and limits listed above. ### What data does this template return? See Output Schema below; availability can vary by source record. ### How is usage billed? See the Pricing section above for current pricing and billing details. ## Related Templates - [Suumo Land Listings Scraper](https://www.octoparse.com/template/suumo-land-listings-scraper) - [Suumo Used Apartment Detail Scraper](https://www.octoparse.com/template/suumo-used-property-details-scraper) - [Suumo Detached House Details Scraper](https://www.octoparse.com/template/suumo-detached-house-details-scraper) - [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword) - [Google Maps Listings Scraper (by URLs)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-url) ## Input Schema ```json { "title": "Suumo Apartments Listings Scraper input", "description": "Input parameters configured for the current published template version.", "type": "object", "schemaVersion": 1, "additionalProperties": false, "properties": { "enter_result_URLs": { "title": "Enter result URLs(Max 10)", "description": "Enter result URLs(Max 10)", "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 10000 }, "minItems": 1, "maxItems": 10, "x-octoparse": { "apiEnabled": true } } }, "required": [ "enter_result_URLs" ] } ``` ## Input JSON Example Example 1 ```json { "enter_result_URLs": [ "https://suumo.jp/jj/bukken/ichiran/JJ010FJ001/?ar=030&bs=011&ta=12&jspIdFlg=patternShikugun&kb=1&kt=9999999&mb=0&mt=9999999&ekTjCd=&ekTjNm=&tj=0&cnb=0&cn=9999999" ] } ``` ## Output Schema ```json { "schemaVersion": 1, "type": "object", "properties": { "Original_URL": { "type": "string", "description": "" }, "バルコニー": { "type": "string", "description": "" }, "会員名": { "type": "string", "description": "" }, "専有面積": { "type": "string", "description": "" }, "所在地": { "type": "string", "description": "" }, "接客評価コメント": { "type": "string", "description": "" }, "沿線_駅": { "type": "string", "description": "" }, "物件名": { "type": "string", "description": "" }, "物件名_URL": { "type": "string", "description": "" }, "築年月": { "type": "string", "description": "" }, "販売価格": { "type": "string", "description": "" }, "間取り": { "type": "string", "description": "" }, "電話番号": { "type": "string", "description": "" } }, "title": "Suumo Apartments Listings Scraper output", "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.", "additionalProperties": false } ``` ## Output Example Example 1 ```json { "Original_URL": "https://suumo.jp/jj/bukken/ichiran/JJ010FJ001/?ar=030&bs=011&ta=12&jspIdFlg=patternShikugun&kb=1&kt=9999999&mb=0&mt=9999999&ekTjCd=&ekTjNm=&tj=0&cnb=0&cn=9999999", "バルコニー": "7.91m2", "会員名": "\n\t\t\t\t\t\t\t\t\t\t\t(株)smartplus松戸", "専有面積": "49.57m2（14.99坪）（壁芯）", "所在地": "千葉県船橋市緑台２", "接客評価コメント": "", "沿線_駅": "京成松戸線「高根公団」徒歩20分", "物件名": "\n\t\t\t\t\t☆当日見学・送迎可☆スマートクラブ入会特典あり♪最適な銀行プランをご提案♪", "物件名_URL": "https://suumo.jp/ms/chuko/chiba/sc_funabashi/nc_21029228/", "築年月": "1972年10月", "販売価格": "350万円", "間取り": "3K", "電話番号": "0120-500968" } ``` ## API `POST https://openapi.octoparse.com/api/agentTools/executeTask` This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token. Request body: `templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional. Obtain a token: ```http POST https://openapi.octoparse.com/token Content-Type: application/json { "username": "YOUR_USERNAME", "password": "YOUR_PASSWORD", "grant_type": "password" } ``` Use `data.access_token` as `Authorization: Bearer `. After starting, poll `getTaskStatus` and export with `exportData`. ```json { "templateName": "suumo-used-apartments-listings-scraper", "taskName": "Suumo Apartments Listings Scraper", "parameters": "{\"enter_result_URLs\":[\"https://suumo.jp/jj/bukken/ichiran/JJ010FJ001/?ar=030&bs=011&ta=12&jspIdFlg=patternShikugun&kb=1&kt=9999999&mb=0&mt=9999999&ekTjCd=&ekTjNm=&tj=0&cnb=0&cn=9999999\"]}" } ``` ## Python Example ```python import json import requests OPENAPI_BASE = "https://openapi.octoparse.com" ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" parameters = json.loads("{\"enter_result_URLs\":[\"https://suumo.jp/jj/bukken/ichiran/JJ010FJ001/?ar=030&bs=011&ta=12&jspIdFlg=patternShikugun&kb=1&kt=9999999&mb=0&mt=9999999&ekTjCd=&ekTjNm=&tj=0&cnb=0&cn=9999999\"]}") response = requests.post( f"{OPENAPI_BASE}/api/agentTools/executeTask", headers={ "Authorization": f"Bearer {ACCESS_TOKEN}", "Content-Type": "application/json", }, json={ "templateName": "suumo-used-apartments-listings-scraper", "taskName": "Suumo Apartments Listings Scraper", "parameters": json.dumps(parameters, ensure_ascii=False), }, timeout=60, ) print(response.status_code) print(response.json()) ``` ## HTTP/cURL Example ```bash curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ --data-binary @- <<'JSON' { "templateName": "suumo-used-apartments-listings-scraper", "taskName": "Suumo Apartments Listings Scraper", "parameters": "{\"enter_result_URLs\":[\"https://suumo.jp/jj/bukken/ichiran/JJ010FJ001/?ar=030&bs=011&ta=12&jspIdFlg=patternShikugun&kb=1&kt=9999999&mb=0&mt=9999999&ekTjCd=&ekTjNm=&tj=0&cnb=0&cn=9999999\"]}" } JSON ``` ## MCP Setup Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `suumo-used-apartments-listings-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results. ## Machine-readable Resources - [Template contract](https://www.octoparse.com/templates/suumo-used-apartments-listings-scraper.json) - [Manifest](https://www.octoparse.com/templates/suumo-used-apartments-listings-scraper-manifest.json)