# Suumo Used Apartment Detail Scraper

This is a template for extracting property information (such as location, land area, etc.) from the detailed page of SUUMO's used apartments by using their URL.

- Template page: [https://www.octoparse.com/template/suumo-used-property-details-scraper](https://www.octoparse.com/template/suumo-used-property-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 34 fields, including `その他制限事項`, `その他概要_特記事項`, `その他面積`, `リフォーム`, `交通`, `会員名`, `住所`, `価格`, `取得時間`, `向き`, `問い合わせ先`, `専有面積`, `引渡可能時期`, `情報提供日`, `所在階_構造_階建`, `敷地の権利形態`, `敷地面積`, `次回更新日`, `物件名`, `物件名_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 URLs and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs

Required. URLs Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=10000.

## How to Use

# Suumo Used Apartment Detail Scraper

This template collects property information (location, land area, price, etc.) from SUUMO used-apartment detail pages by entering the listing URLs. Data source: [Suumo](https://img01.suumo.com/).

## Pricing

No per-line charge. Octoparse plan or resource limits may still apply.

## Input

- **URLs** (required): one or more values, one per line.

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields listed above.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

## Output Fields

The template returns these detail-page fields:

`物件名`, `物件名_URL`, `物件種別`, `情報提供日`, `次回更新日`, `自主管理欄`, `物件画像1`–`物件画像5`, `価格`, `間取り`, `販売戸数`, `総戸数`, `専有面積`, `その他面積`, `所在階_構造_階建`, `築年月`, `住所`, `交通`, `会員名`, `問い合わせ先`, `設備仕様`, `引渡可能時期`, `向き`, `リフォーム`, `その他制限事項`, `その他概要_特記事項`, `敷地面積`, `敷地の権利形態`, `用途地域`, `駐車場`, `取得時間`.

## Limitations

- Collects only the fields listed above from detail pages; it does not add data that Suumo does not display.
- Fields such as `用途地域`, `駐車場`, and `取得時間` can be empty when the source record does not provide them.
- Does not collect reviews or comments.

## Tips

- Start with one or a few inputs and review the returned rows before scaling the task.
- Use the most specific valid URLs to reduce unrelated or duplicate records.
- Use a stable URL or identifier from `物件名`, `物件名_URL`, `物件種別`, `情報提供日`, `次回更新日`, `自主管理欄`, `物件画像1`, `物件画像2`, `物件画像3`, `物件画像4` as the deduplication key when available.

## Scheduling and Export

- Run locally or in the cloud and schedule recurring runs.
- Export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to reporting and AI workflows through Octoparse APIs or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).
- Keep your computer and Octoparse open for local scheduled runs.
- Scheduling and API access may require a paid Octoparse plan.

## 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

- [Goo Net Used Car Sales Scraper](https://www.octoparse.com/template/goo-net-used-car-sales-scraper)
- [Suumo Apartments Listings Scraper](https://www.octoparse.com/template/suumo-used-apartments-listings-scraper)
- [Suumo Detached House Details Scraper](https://www.octoparse.com/template/suumo-detached-house-details-scraper)
- [Certified Honda Used Car Scraper](https://www.octoparse.com/template/hda-ucar)
- [Toyota Japan Certified Used Car Scraper](https://www.octoparse.com/template/tyt-ucar)

## Input Schema

```json
{
  "title": "Suumo Used Apartment Detail Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs",
      "description": "URLs",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "その他制限事項": {
      "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": ""
    },
    "問い合わせ先": {
      "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": ""
    },
    "物件画像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": ""
    },
    "間取り": {
      "type": "string",
      "description": ""
    },
    "駐車場": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Suumo Used Apartment Detail 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

No verified real input/output examples are currently available.

## 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`.

No verified real input/output examples are currently available.

## MCP Setup

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