# Suumo Detached House Details Scraper

This is a template for extracting property information (such as location and land area) from the detailed page of a detached house on SUUMO via URL.

- Template page: [https://www.octoparse.com/template/suumo-detached-house-details-scraper](https://www.octoparse.com/template/suumo-detached-house-details-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 detail pages.

## Output

The current workflow extracts 30 fields, including `交通手段`, `会員名`, `価格`, `備考1`, `備考2`, `取得時間1`, `取得時間2`, `問い合わせ先`, `土地権利`, `土地面積`, `建ぺい率と容積率`, `建物構造`, `建築面積`, `情報提供日`, `所在地`, `次回更新日`, `物件URL`, `物件名`, `物件画像1`, `物件画像2`, `物件画像3`, `物件画像4`, `物件画像5`, `物件種別`, `用途地域`, `登記簿地目`, `私道面積`, `築年月`, `自主管理欄`, `間取りタイプ`.

## 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 URL (up to 100 per run) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URL (up to 100 per run)

Required. Enter result URL of Suumo Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=10000.

## How to Use

# Suumo Detached House Details Scraper

## Overview

Collects property information (location, land area, etc.) from SUUMO detached house detail pages using listing URLs. Data source: https://suumo.jp/.

## Pricing

This template currently has no per-line charge.

## Input

- **URL (up to 100 per run)** (required): enter one or more values, one per line.

## Output

Returns the template’s output schema with detail-page fields, including property URL, name, type, management notes, listing/update dates, image URLs, capture times, location, price, access, land/building details, layout, remarks, member name, and inquiry contact. Fields such as `会員名`, `問い合わせ先`, and `取得時間2` may be empty when the source record does not provide them.

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Fill in the required field **URL (up to 100 per run)**.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

## Running and Exporting

Run locally or in the cloud. You can schedule recurring runs and export to CSV, Excel, JSON, databases, cloud storage, or send to reporting and AI workflows through Octoparse APIs. See 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.

## Limitations

- Collects only the detail-page fields listed in Output; it does not add data that SUUMO does not display.
- Empty values are possible for optional fields such as `会員名`, `問い合わせ先`, and `取得時間2`.

## Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid URLs (up to 100 per run) to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the output fields as a deduplication key when available.

## 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 Detached House Listing Scraper](https://www.octoparse.com/template/suumo-detached-house-listing-scraper)
- [Homes Detached House Scraper](https://www.octoparse.com/template/homes-detached-house-listing-scraper)
- [Suumo Used Apartment Detail Scraper](https://www.octoparse.com/template/suumo-used-property-details-scraper)
- [Suumo Apartments Listings Scraper](https://www.octoparse.com/template/suumo-used-apartments-listings-scraper)
- [Suumo Land Listings Scraper](https://www.octoparse.com/template/suumo-land-listings-scraper)

## Input Schema

```json
{
  "title": "Suumo Detached House Details Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL": {
      "title": "URL (up to 100 per run)",
      "description": "Enter result URL of Suumo",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRL"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRL": [
    "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/"
  ]
}
```

Example 2

```json
{
  "uRL": [
    "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/"
  ]
}
```

Example 3

```json
{
  "uRL": [
    "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/"
  ]
}
```

Example 4

```json
{
  "uRL": [
    "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/"
  ]
}
```

Example 5

```json
{
  "uRL": [
    "[\"https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/\"]"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "交通手段": {
      "type": "string",
      "description": ""
    },
    "会員名": {
      "type": "string",
      "description": ""
    },
    "価格": {
      "type": "string",
      "description": ""
    },
    "備考1": {
      "type": "string",
      "description": ""
    },
    "備考2": {
      "type": "string",
      "description": ""
    },
    "取得時間1": {
      "type": "string",
      "description": ""
    },
    "取得時間2": {
      "type": "string",
      "description": ""
    },
    "問い合わせ先": {
      "type": "string",
      "description": ""
    },
    "土地権利": {
      "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": ""
    },
    "物件画像1": {
      "type": "string",
      "description": ""
    },
    "物件画像2": {
      "type": "string",
      "description": ""
    },
    "物件画像3": {
      "type": "string",
      "description": ""
    },
    "物件画像4": {
      "type": "string",
      "description": ""
    },
    "物件画像5": {
      "type": "string",
      "description": ""
    },
    "物件種別": {
      "type": "string",
      "description": ""
    },
    "用途地域": {
      "type": "string",
      "description": ""
    },
    "登記簿地目": {
      "type": "string",
      "description": ""
    },
    "私道面積": {
      "type": "string",
      "description": ""
    },
    "築年月": {
      "type": "string",
      "description": ""
    },
    "自主管理欄": {
      "type": "string",
      "description": ""
    },
    "間取りタイプ": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Suumo Detached House Details 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
{
  "交通手段": "\n\t\t\t中央バス「三井アウトレットパーク入口36号線沿」歩4分～7分\n\t\t\t中央バス「三井アウトレットパーク店舗入口」歩5分～8分\n\t\t\t中央バス「大曲」歩15分～18分\n\t\t\t",
  "会員名": "\n\t\t\t\t\t(株)ecoaハウス\n\t\t\t\t\t\n\t\t\t\t\t",
  "価格": "3400万円～3960万円令和8年8月1日　大幅お値下げ！ (旧価格　令和8年6月1日　詳細は各物件参照ください) \n\t\t\t\n\t\t\t",
  "備考1": "宅地\n\t\t\t",
  "備考2": "設備：公営水道、本下水、都市ガス、建築確認番号：第SKK20255053号他\n\t\t\t",
  "取得時間1": "2026-11-17 19:08:16.206",
  "取得時間2": "2026-11-17 19:08:28.783",
  "問い合わせ先": "TEL：0120-018-935\n\t\t\t\t\t\t",
  "土地権利": "所有権\n\t\t\t",
  "土地面積": "200m2～200.02m2（実測）\n\t\t\t",
  "建ぺい率と容積率": "建ペい率：60％、容積率：200％\n\t\t\t",
  "建物構造": "【No.２】【No.６】木造軸組工法(ピン工法）　【No.７】【No.８】枠組壁工法\n\t\t\t",
  "建築面積": "69.56m2～114.48m2（実測）\n\t\t\t",
  "情報提供日": "26/11/17",
  "所在地": "北海道北広島市大曲幸町２-3番他\n\t\t\t",
  "次回更新日": "",
  "物件URL": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件名": "工務店グランプリ二度の日本一【エコアハウス】北広島IC車3分！北広島大曲建売住宅４棟 ",
  "物件画像1": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像2": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像3": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像4": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像5": "",
  "物件種別": "未入居",
  "用途地域": "-\n\t\t\t",
  "登記簿地目": "景観法による規制有、宅地造成工事規制区域、日影制限有、宅地造成規制法／国土利用計画法／第一種特別工業地域／道路斜線制限／隣地斜線制限／建築基準法第22条・23条指定区域\n\t\t\t",
  "私道面積": "道路幅：8ｍ、アスファルト舗装\n\t\t\t",
  "築年月": "2024年10月\n\t\t\t",
  "自主管理欄": "\n\t\t\t\n\t\t\t\t物件の特徴\n\t\t\t\n\t\t",
  "間取りタイプ": "2LDK～3LDK+S（納戸）\n\t\t\t"
}
```

Example 2

```json
{
  "交通手段": "\n\t\t\t中央バス「三井アウトレットパーク入口36号線沿」歩4分～7分\n\t\t\t中央バス「三井アウトレットパーク店舗入口」歩5分～8分\n\t\t\t中央バス「大曲」歩15分～18分\n\t\t\t",
  "会員名": "\n\t\t\t\t\t(株)ecoaハウス\n\t\t\t\t\t\n\t\t\t\t\t",
  "価格": "3400万円～3960万円令和8年8月1日　大幅お値下げ！ (旧価格　令和8年6月1日　詳細は各物件参照ください) \n\t\t\t\n\t\t\t",
  "備考1": "宅地\n\t\t\t",
  "備考2": "設備：公営水道、本下水、都市ガス、建築確認番号：第SKK20255053号他\n\t\t\t",
  "取得時間1": "2026-11-15 10:53:03.576",
  "取得時間2": "2026-11-15 10:53:15.942",
  "問い合わせ先": "TEL：0120-018-935\n\t\t\t\t\t\t",
  "土地権利": "所有権\n\t\t\t",
  "土地面積": "200m2～200.02m2（実測）\n\t\t\t",
  "建ぺい率と容積率": "建ペい率：60％、容積率：200％\n\t\t\t",
  "建物構造": "【No.２】【No.６】木造軸組工法(ピン工法）　【No.７】【No.８】枠組壁工法\n\t\t\t",
  "建築面積": "69.56m2～114.48m2（実測）\n\t\t\t",
  "情報提供日": "26/11/13",
  "所在地": "北海道北広島市大曲幸町２-3番他\n\t\t\t",
  "次回更新日": "",
  "物件URL": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件名": "工務店グランプリ二度の日本一【エコアハウス】北広島IC車3分！北広島大曲建売住宅４棟 ",
  "物件画像1": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像2": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像3": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像4": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像5": "",
  "物件種別": "未入居",
  "用途地域": "-\n\t\t\t",
  "登記簿地目": "景観法による規制有、宅地造成工事規制区域、日影制限有、宅地造成規制法／国土利用計画法／第一種特別工業地域／道路斜線制限／隣地斜線制限／建築基準法第22条・23条指定区域\n\t\t\t",
  "私道面積": "道路幅：8ｍ、アスファルト舗装\n\t\t\t",
  "築年月": "2024年10月\n\t\t\t",
  "自主管理欄": "\n\t\t\t\n\t\t\t\t物件の特徴\n\t\t\t\n\t\t",
  "間取りタイプ": "2LDK～3LDK+S（納戸）\n\t\t\t"
}
```

Example 3

```json
{
  "交通手段": "\n\t\t\t中央バス「三井アウトレットパーク入口36号線沿」歩4分～7分\n\t\t\t中央バス「三井アウトレットパーク店舗入口」歩5分～8分\n\t\t\t中央バス「大曲」歩15分～18分\n\t\t\t",
  "会員名": "\n\t\t\t\t\t(株)ecoaハウス\n\t\t\t\t\t\n\t\t\t\t\t",
  "価格": "3400万円～3960万円令和8年8月1日　大幅お値下げ！ (旧価格　令和8年6月1日　詳細は各物件参照ください) \n\t\t\t\n\t\t\t",
  "備考1": "宅地\n\t\t\t",
  "備考2": "設備：公営水道、本下水、都市ガス、建築確認番号：第SKK20255053号他\n\t\t\t",
  "取得時間1": "2026-11-13 02:34:57.882",
  "取得時間2": "2026-11-13 02:35:21.079",
  "問い合わせ先": "TEL：0120-018-935\n\t\t\t\t\t\t",
  "土地権利": "所有権\n\t\t\t",
  "土地面積": "200m2～200.02m2（実測）\n\t\t\t",
  "建ぺい率と容積率": "建ペい率：60％、容積率：200％\n\t\t\t",
  "建物構造": "【No.２】【No.６】木造軸組工法(ピン工法）　【No.７】【No.８】枠組壁工法\n\t\t\t",
  "建築面積": "69.56m2～114.48m2（実測）\n\t\t\t",
  "情報提供日": "26/11/12",
  "所在地": "北海道北広島市大曲幸町２-3番他\n\t\t\t",
  "次回更新日": "",
  "物件URL": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件名": "工務店グランプリ二度の日本一【エコアハウス】北広島IC車3分！北広島大曲建売住宅４棟 ",
  "物件画像1": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像2": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像3": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像4": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像5": "",
  "物件種別": "未入居",
  "用途地域": "-\n\t\t\t",
  "登記簿地目": "景観法による規制有、宅地造成工事規制区域、日影制限有、宅地造成規制法／国土利用計画法／第一種特別工業地域／道路斜線制限／隣地斜線制限／建築基準法第22条・23条指定区域\n\t\t\t",
  "私道面積": "道路幅：8ｍ、アスファルト舗装\n\t\t\t",
  "築年月": "2024年10月\n\t\t\t",
  "自主管理欄": "\n\t\t\t\n\t\t\t\t物件の特徴\n\t\t\t\n\t\t",
  "間取りタイプ": "2LDK～3LDK+S（納戸）\n\t\t\t"
}
```

Example 4

```json
{
  "交通手段": "\n\t\t\t中央バス「三井アウトレットパーク入口36号線沿」歩4分～7分\n\t\t\t中央バス「三井アウトレットパーク店舗入口」歩5分～8分\n\t\t\t中央バス「大曲」歩15分～18分\n\t\t\t",
  "会員名": "\n\t\t\t\t\t(株)ecoaハウス\n\t\t\t\t\t\n\t\t\t\t\t",
  "価格": "3400万円～3960万円令和8年8月1日　大幅お値下げ！ (旧価格　令和8年6月1日　詳細は各物件参照ください) \n\t\t\t\n\t\t\t",
  "備考1": "宅地\n\t\t\t",
  "備考2": "設備：公営水道、本下水、都市ガス、建築確認番号：第SKK20255053号他\n\t\t\t",
  "取得時間1": "2026-11-10 18:19:33.435",
  "取得時間2": "2026-11-10 18:19:46.797",
  "問い合わせ先": "TEL：0120-018-935\n\t\t\t\t\t\t",
  "土地権利": "所有権\n\t\t\t",
  "土地面積": "200m2～200.02m2（実測）\n\t\t\t",
  "建ぺい率と容積率": "建ペい率：60％、容積率：200％\n\t\t\t",
  "建物構造": "【No.２】【No.６】木造軸組工法(ピン工法）　【No.７】【No.８】枠組壁工法\n\t\t\t",
  "建築面積": "69.56m2～114.48m2（実測）\n\t\t\t",
  "情報提供日": "26/11/10",
  "所在地": "北海道北広島市大曲幸町２-3番他\n\t\t\t",
  "次回更新日": "",
  "物件URL": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件名": "工務店グランプリ二度の日本一【エコアハウス】北広島IC車3分！北広島大曲建売住宅４棟 ",
  "物件画像1": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像2": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像3": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像4": "https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/",
  "物件画像5": "",
  "物件種別": "未入居",
  "用途地域": "-\n\t\t\t",
  "登記簿地目": "景観法による規制有、宅地造成工事規制区域、日影制限有、宅地造成規制法／国土利用計画法／第一種特別工業地域／道路斜線制限／隣地斜線制限／建築基準法第22条・23条指定区域\n\t\t\t",
  "私道面積": "道路幅：8ｍ、アスファルト舗装\n\t\t\t",
  "築年月": "2024年10月\n\t\t\t",
  "自主管理欄": "\n\t\t\t\n\t\t\t\t物件の特徴\n\t\t\t\n\t\t",
  "間取りタイプ": "2LDK～3LDK+S（納戸）\n\t\t\t"
}
```

Example 5

```json
{
  "交通手段": "",
  "会員名": "",
  "価格": "",
  "備考1": "",
  "備考2": "",
  "取得時間1": "2026-11-02 06:42:37.572",
  "取得時間2": "2026-11-02 06:42:41.813",
  "問い合わせ先": "",
  "土地権利": "",
  "土地面積": "",
  "建ぺい率と容積率": "",
  "建物構造": "",
  "建築面積": "",
  "情報提供日": "",
  "所在地": "",
  "次回更新日": "",
  "物件URL": "about:blank",
  "物件名": "",
  "物件画像1": "",
  "物件画像2": "",
  "物件画像3": "",
  "物件画像4": "",
  "物件画像5": "",
  "物件種別": "",
  "用途地域": "",
  "登記簿地目": "",
  "私道面積": "",
  "築年月": "",
  "自主管理欄": "",
  "間取りタイプ": ""
}
```

## 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 <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "suumo-detached-house-details-scraper",
  "taskName": "Suumo Detached House Details Scraper",
  "parameters": "{\"uRL\":[\"https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"uRL\":[\"https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "suumo-detached-house-details-scraper",
        "taskName": "Suumo Detached House Details 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-detached-house-details-scraper",
  "taskName": "Suumo Detached House Details Scraper",
  "parameters": "{\"uRL\":[\"https://suumo.jp/ikkodate/hokkaido_/sc_kitahiroshima/nc_75837879/\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `suumo-detached-house-details-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-detached-house-details-scraper.json)
- [Manifest](https://www.octoparse.com/templates/suumo-detached-house-details-scraper-manifest.json)
