# Ekiten Store Listing Scraper

This is a template for extracting store information from the search list page of Ekiten via URL.

- Template page: [https://www.octoparse.com/template/ekiten-store-listing-scraper](https://www.octoparse.com/template/ekiten-store-listing-scraper)
- Categories: Directories, Lead Generation
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$0.3/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## 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 21 fields, including `title`, `url`, `アクセス`, `ジャンル`, `バス停`, `住所`, `価格帯`, `公式サイト`, `公開日`, `取得日付`, `口コミ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 URLs (up to 5000) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs (up to 5000)

Required. URLs (up to 5000) Constraints: minItems=1; maxItems=5000; items.minLength=1; items.maxLength=10000.

## How to Use

# Ekiten Store Listing Scraper Usage Guide

## Purpose
Collect store listing data from Ekiten search result pages by URL. Source: [Ekitens](https://www.ekiten.jp/), a business discovery and listing service.

## Pricing
- Current price: **$0.3 / 1,000 lines**
- Billing is based on the number of output lines produced by the task.

## Input Parameters
- **URLs (up to 5000)** (required): enter one or more values, one per line.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the input field with Ekiten search listing URLs.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

## Output
Returns listing/search-result fields including store name (`店舗名`), detail page URL (`詳細ページURL`), rating (`評価点数`), review count (`口コミ件数`), review URL (`口コミURL`), genre (`ジャンル`), address (`住所`), access (`アクセス`), today's business status (`本日の営業状況`), price range (`価格帯`), phone (`電話番号`), nearest station (`最寄駅`), bus stop (`バス停`), business hours (`営業時間`), parking (`駐車場`), official site (`公式サイト`), publish date (`公開日`), last update date (`最終更新日`), and retrieval date (`取得日付`).

Fields such as `公開日`, `最終更新日`, and `取得日付` can be empty when Ekiten does not provide them.

## Limitations
- Collects only the listing/search-result fields shown above.
- Does not collect complete detail-page data.
- Does not add data that Ekiten does not display.
- For deeper record data, use a detail-page template.

## Tips
- Start with one or a few inputs and review returned rows before scaling the task.
- Use the most specific valid URLs to reduce unrelated or duplicate records.
- Use a stable identifier such as `詳細ページURL` as the deduplication key when available.

## Scheduling and Export
- Schedule recurring runs in the cloud.
- Export rows to CSV, Excel, JSON, databases, or cloud storage.
- Reuse data through Octoparse OpenAPI 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.

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

- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [eBay Scraper (Store Listing)](https://www.octoparse.com/template/ebay-scraper-store-listing)
- [Ekiten Review Scraper](https://www.octoparse.com/template/ekiten-review-scraper)
- [Tabelog Store list Scraper](https://www.octoparse.com/template/tabelog-store-list-scraper)
- [Bing Maps Store Scraper](https://www.octoparse.com/template/bing-maps-store-scraper)

## Input Schema

```json
{
  "title": "Ekiten Store Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs (up to 5000)",
      "description": "URLs (up to 5000)",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 5000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRLs": [
    "https://www.ekiten.jp/freeword/?g=0552"
  ]
}
```

Example 2

```json
{
  "uRLs": [
    "http://ekiten.jp/g0115/a34101/",
    "https://www.ekiten.jp/g0115/a34102/",
    "https://www.ekiten.jp/g0115/a34102/",
    "https://www.ekiten.jp/g0115/a34104/",
    "https://www.ekiten.jp/g0115/a34105/"
  ]
}
```

Example 3

```json
{
  "uRLs": [
    "https://www.ekiten.jp/freeword/?fw%5B%5D=%E3%83%9E%E3%83%83%E3%82%B5%E3%83%BC%E3%82%B8"
  ]
}
```

Example 4

```json
{
  "uRLs": [
    "https://www.ekiten.jp/g0204/a13113/"
  ]
}
```

Example 5

```json
{
  "uRLs": [
    "https://www.ekiten.jp/g0210/a13113/"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": ""
    },
    "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": ""
    },
    "取得日付": {
      "type": "string",
      "description": ""
    },
    "口コミ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": ""
    }
  },
  "title": "Ekiten Store Listing 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
{
  "title": "行政書士 未来タクト",
  "url": "https://www.ekiten.jp/shop_7004997/",
  "アクセス": "青葉台駅から徒歩11分（850m）",
  "ジャンル": "便利屋・代行サービス",
  "バス停": "桜台団地前から330m （徒歩5分）",
  "住所": "神奈川県横浜市青葉区桜台26-1第三アサキビル3F-301",
  "価格帯": "",
  "公式サイト": "https://office-yokohama.jimdofree.com",
  "公開日": "2015/07/10",
  "取得日付": "2026-10-28",
  "口コミURL": "https://www.ekiten.jp/shop_7004997/#anc-top-review",
  "口コミ件数": "1",
  "営業時間": "月 定休日 火 9:30~18:00 水 9:30~18:00 木 9:30~18:00 金 9:30~18:00 土 9:30~18:00 日 9:30~18:00 祝 9:30~18:00",
  "店舗名": "行政書士 未来タクト",
  "最寄駅": "青葉台駅 から850m （徒歩11分）",
  "最終更新日": "2022/10/07",
  "本日の営業状況": "9:30〜18:00 9:30〜18:00 9:30〜18:00",
  "評価点数": "3.27",
  "詳細ページURL": "https://www.ekiten.jp/shop_7004997/",
  "電話番号": "045-532-5125",
  "駐車場": "駐車場なし"
}
```

Example 2

```json
{
  "title": "タイ家庭料理トムヤムクン",
  "url": "https://www.ekiten.jp/shop_6917280/",
  "アクセス": "広電西広島駅(己斐)から徒歩2分（88m）",
  "ジャンル": "レストラン / 洋食",
  "バス停": "己斐から57m （徒歩1分） 己斐西広島駅前のレストラン 己斐・西広島駅のレストラン 己斐西広島駅前の洋食店 己斐・西広島駅の洋食店",
  "住所": "広島県広島市西区己斐本町１丁目２０−２",
  "価格帯": "￥500 〜 ￥2,500",
  "公式サイト": "http://r.goope.jp/tomyumgoong",
  "公開日": "2015/01/09",
  "取得日付": "2026-10-28",
  "口コミURL": "https://www.ekiten.jp/shop_6917280/review/",
  "口コミ件数": "6",
  "営業時間": "月 12:00~14:00 17:00~21:30 火 12:00~14:00 17:00~21:30 水 12:00~14:00 17:00~21:30 木 12:00~14:00 17:00~21:30 金 12:00~14:00 17:00~21:30 土 12:00~14:00 17:00~21:30 日 12:00~14:00 17:00~21:30 祝 12:00~14:00 17:00~21:30",
  "店舗名": "タイ家庭料理トムヤムクン",
  "最寄駅": "広電西広島駅(己斐) から88m （徒歩2分） 西広島駅 から200m （徒歩3分） 福島町駅 から510m （徒歩7分）",
  "最終更新日": "2022/10/08",
  "本日の営業状況": "12:00〜14:00 17:00〜21:30 12:00〜14:00 17:00〜21:30 12:00〜14:00 17:00〜21:30",
  "評価点数": "3.72",
  "詳細ページURL": "https://www.ekiten.jp/shop_6917280/",
  "電話番号": "082-961-3913",
  "駐車場": "駐車場なし"
}
```

Example 3

```json
{
  "title": "フィジカルコンディショニングサロン WHOLE 札幌円山",
  "url": "https://www.ekiten.jp/shop_36234149/",
  "アクセス": "円山公園駅から徒歩3分（170m）",
  "ジャンル": "マッサージ / 鍼灸 / 整体 / リラクゼーションマッサージ",
  "バス停": "円山第一鳥居から240m （徒歩4分） 大通西２５丁目から190m （徒歩3分） 円山公園駅前から300m （徒歩4分） 北５条西２４丁目の整体院 円山バスターミナルの整体院 北５条西２４丁目のマッサージ店 円山バスターミナルのマッサージ店",
  "住所": "北海道札幌市中央区大通西24丁目2-18パレンテ301",
  "価格帯": "￥6,500 〜 ￥24,500",
  "公式サイト": "https://whole-tx.com",
  "公開日": "2023/01/12",
  "取得日付": "2026-10-19",
  "口コミURL": "https://www.ekiten.jp/shop_36234149/#anc-top-review",
  "口コミ件数": "3",
  "営業時間": "月 10:00~22:00 火 10:00~22:00 水 10:00~22:00 木 10:00~22:00 金 10:00~22:00 土 10:00~20:00 日 10:00~19:00 祝 10:00~19:00",
  "店舗名": "フィジカルコンディショニングサロン WHOLE 札幌円山",
  "最寄駅": "円山公園駅 から170m （徒歩3分） 西２８丁目駅 から650m （徒歩9分） 西１８丁目駅 から820m （徒歩11分）",
  "最終更新日": "2026/10/13",
  "本日の営業状況": "10:00〜22:00 10:00〜22:00 10:00〜22:00",
  "評価点数": "3.53",
  "詳細ページURL": "https://www.ekiten.jp/shop_36234149/",
  "電話番号": "011-600-6702",
  "駐車場": "駐車場なし"
}
```

Example 4

```json
{
  "title": "鍼灸マッサージsalon ここち",
  "url": "https://www.ekiten.jp/shop_6980043/",
  "アクセス": "代官山駅から徒歩4分（300m）",
  "ジャンル": "鍼灸 / マッサージ / 整体",
  "バス停": "恵比寿公園から130m （徒歩2分） 恵比寿駅のマッサージ店 恵比寿駅入口のマッサージ店 恵比寿駅の整体院 恵比寿駅入口の整体院 恵比寿駅の鍼灸院 恵比寿駅入口の鍼灸院",
  "住所": "東京都渋谷区恵比寿西1-21-5ウエスト21 6F",
  "価格帯": "￥7,000 〜 ￥10,000",
  "公式サイト": "http://co2chi.com/ebisu/",
  "公開日": "2015/05/07",
  "取得日付": "2026-10-19",
  "口コミURL": "https://www.ekiten.jp/shop_6980043/review/",
  "口コミ件数": "39",
  "営業時間": "月 13:00~22:00 火 定休日 水 13:00~22:00 木 13:00~22:00 金 13:00~22:00 土 12:00~21:00 日 12:00~21:00 祝 12:00~21:00",
  "店舗名": "鍼灸マッサージsalon ここち",
  "最寄駅": "恵比寿駅 から390m （徒歩5分） 代官山駅 から300m （徒歩4分） 中目黒駅 から680m （徒歩9分）",
  "最終更新日": "2025/08/14",
  "本日の営業状況": "13:00〜22:00 13:00〜22:00 13:00〜22:00",
  "評価点数": "4.48",
  "詳細ページURL": "https://www.ekiten.jp/shop_6980043/",
  "電話番号": "03-6452-5189",
  "駐車場": "駐車場なし"
}
```

Example 5

```json
{
  "title": "鍼灸マッサージsalon ここち",
  "url": "https://www.ekiten.jp/shop_6980043/",
  "アクセス": "代官山駅から徒歩4分（300m）",
  "ジャンル": "鍼灸 / マッサージ / 整体",
  "バス停": "恵比寿公園から130m （徒歩2分） 恵比寿駅のマッサージ店 恵比寿駅入口のマッサージ店 恵比寿駅の整体院 恵比寿駅入口の整体院 恵比寿駅の鍼灸院 恵比寿駅入口の鍼灸院",
  "住所": "東京都渋谷区恵比寿西1-21-5ウエスト21 6F",
  "価格帯": "￥7,000 〜 ￥10,000",
  "公式サイト": "http://co2chi.com/ebisu/",
  "公開日": "2015/05/07",
  "取得日付": "2026-10-19",
  "口コミURL": "https://www.ekiten.jp/shop_6980043/review/",
  "口コミ件数": "39",
  "営業時間": "月 13:00~22:00 火 定休日 水 13:00~22:00 木 13:00~22:00 金 13:00~22:00 土 12:00~21:00 日 12:00~21:00 祝 12:00~21:00",
  "店舗名": "鍼灸マッサージsalon ここち",
  "最寄駅": "恵比寿駅 から390m （徒歩5分） 代官山駅 から300m （徒歩4分） 中目黒駅 から680m （徒歩9分）",
  "最終更新日": "2025/08/14",
  "本日の営業状況": "13:00〜22:00 13:00〜22:00 13:00〜22:00",
  "評価点数": "4.48",
  "詳細ページURL": "https://www.ekiten.jp/shop_6980043/",
  "電話番号": "03-6452-5189",
  "駐車場": "駐車場なし"
}
```

## 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": "ekiten-store-listing-scraper",
  "taskName": "Ekiten Store Listing Scraper",
  "parameters": "{\"uRLs\":[\"https://www.ekiten.jp/freeword/?g=0552\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"uRLs\":[\"https://www.ekiten.jp/freeword/?g=0552\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "ekiten-store-listing-scraper",
        "taskName": "Ekiten Store Listing 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": "ekiten-store-listing-scraper",
  "taskName": "Ekiten Store Listing Scraper",
  "parameters": "{\"uRLs\":[\"https://www.ekiten.jp/freeword/?g=0552\"]}"
}
JSON
```

## MCP Setup

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