# Hot Pepper Beauty Scraper - Salons, Reviews & Stylists (`huggable_quote/hotpepper-beauty-scraper`) Actor

The most comprehensive scraper for Japan's #1 beauty platform. Extract salon details, customer reviews, stylist profiles, hair catalogs, and coupon data from beauty.hotpepper.jp.

- **URL**: https://apify.com/huggable\_quote/hotpepper-beauty-scraper.md
- **Developed by:** [OrbitData Labs](https://apify.com/huggable_quote) (community)
- **Categories:** Lead generation, E-commerce, Other
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Hot Pepper Beauty Scraper — Salons, Reviews, Stylists & Hair Catalog 💇‍♀️

Extract **complete beauty salon data** from [beauty.hotpepper.jp](https://beauty.hotpepper.jp) — Japan's #1 beauty platform and the **Global #1 site in Beauty & Cosmetics**.

Get **salon details, customer reviews with 4-category ratings, stylist profiles, hair style catalogs, and coupon/pricing data** in a single run.

### Why this scraper?

- **All-in-one extraction** — Salon info, reviews, stylists, hair catalog, and coupons from a single actor
- **60+ data fields** per salon with full customer review context
- **Global #1 beauty platform**: beauty.hotpepper.jp with 150,000+ salons and 250,000+ stylists
- **4-category ratings**: Atmosphere, Service, Technique, and Menu/Price — not just an overall score
- **Customer demographics** built in: gender ratio and age distribution per salon
- From the maker of [Tabelog Scraper](https://apify.com/huggable_quote/tabelog-scraper) and [Jalan Scraper](https://apify.com/huggable_quote/jalan-scraper) (Japan Data Suite)

### What makes this data valuable

#### Customer Reviews with Full Context
Not just text — each review includes **4-category ratings** (atmosphere, service, technique, menu/price), **reviewer gender & age**, which **coupon/menu was used**, and which **stylist** performed the service.

#### Stylist Profiles
Every stylist's **name, position, catchphrase**, and **profile photo**. Perfect for talent scouting or salon benchmarking.

#### Hair Style Catalog
Style **photos with names**, associated **stylist**, and direct links to detail pages. Invaluable for **trend analysis**.

#### Coupons & Pricing Intelligence
**First-visit** (新規), **repeat-customer** (再来), and **all-customer** (全員) coupons with prices, descriptions, conditions, and menu categories.

#### Customer Demographics
**Gender ratio** and **age distribution** of each salon's clientele — target market analysis without surveys.

### What data can you extract?

#### Salon Details (25+ fields)
| Field | Example |
|-------|---------|
| Salon name & kana | SOURCE 塚口 (ソース ツカグチ) |
| Address & geo coordinates | 兵庫県尼崎市塚口町１－３－４ (34.753, 135.415) |
| Phone, hours, closed days | 06-6480-5030, 10:00～21:00, 毎週月曜日 |
| Seats, payment methods | セット面7席, カード可 |
| Overall + 4-category ratings | 4.79 overall (atmosphere 4.8, service 4.9, technique 4.85, price 4.7) |
| Customer demographics | 女性 76% / 男性 20代 47%, 30代 27%... |
| Nearest station | 阪急塚口駅 南出口 徒歩2分 |
| Photos (up to 20) | High-resolution salon images |

#### Reviews (12+ fields per review)
| Field | Example |
|-------|---------|
| Review text | 縮毛矯正、カットともに綺麗にしていただきました！ |
| Overall + 4-category ratings | 5.0 (atmosphere 5, service 5, technique 5, price 5) |
| Reviewer gender & age | 女性 / 10代後半 |
| Menu/coupon used | 【富園指名限定】カット＋縮毛矯正 |
| Treatment performed | カット、縮毛矯正 |
| Stylist name | 富園 |
| Review date | 2026/5/3 |

#### Stylists (5+ fields per stylist)
| Field | Example |
|-------|---------|
| Name & position | 堀 友也 / トップスタイリスト（歴10年） |
| Catchphrase | 【髪質改善】をさせたら右に出るものはいない！ |
| Profile photo | High-resolution portrait |
| Stylist profile URL | Direct link to stylist's portfolio |

#### Hair Catalog (4+ fields per style)
| Field | Example |
|-------|---------|
| Style name & photo | メンズヘア/センターパート + HD image |
| Associated stylist | studio nob |
| Style detail URL | Link to full style page with tags & pricing |

#### Coupons (6+ fields per coupon)
| Field | Example |
|-------|---------|
| Coupon name & type | カット＋縮毛矯正 / 新規 (first-visit) |
| Price | ¥13,750 |
| Menu categories | カット, 縮毛矯正 |
| Conditions | 来店日条件: 指定なし, 対象: 全員 |
| Description | 髪質に合わせた薬剤とテクニックで理想ヘアを... |

### Input options

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | array | — | Direct salon page URLs |
| `searchUrls` | array | — | Search/area listing URLs |
| `searchKeywords` | array | — | Keywords like '渋谷 カット' |
| `maxResultsPerSearch` | integer | 20 | Max salons per search |
| `includeReviews` | boolean | true | Extract customer reviews |
| `maxReviewsPerSalon` | integer | 20 | Max reviews per salon (0 = all) |
| `includeStylists` | boolean | true | Extract stylist profiles |
| `includeHairCatalog` | boolean | false | Extract hair style catalog |
| `maxStylesPerSalon` | integer | 10 | Max styles per salon |
| `includeCoupons` | boolean | true | Extract coupon/pricing data |
| `proxyConfiguration` | object | auto | Proxy settings |

### Usage examples

#### Scrape specific salons
```json
{
    "startUrls": [
        { "url": "https://beauty.hotpepper.jp/slnH000457902/" },
        { "url": "https://beauty.hotpepper.jp/slnH000125134/" }
    ],
    "includeReviews": true,
    "maxReviewsPerSalon": 30,
    "includeStylists": true,
    "includeCoupons": true
}
````

#### Search by area

```json
{
    "searchUrls": [
        { "url": "https://beauty.hotpepper.jp/svcSA/macAB/salon/" }
    ],
    "maxResultsPerSearch": 50,
    "includeHairCatalog": true,
    "maxStylesPerSalon": 5
}
```

#### Search by keyword

```json
{
    "searchKeywords": ["渋谷 カット", "表参道 カラー"],
    "maxResultsPerSearch": 20,
    "includeReviews": true,
    "includeStylists": true
}
```

### Output example

```json
{
    "salonId": "H000700311",
    "salonName": "ロイ(Roi)",
    "salonNameKana": "ロイ　シブヤ",
    "salonUrl": "https://beauty.hotpepper.jp/slnH000700311/",
    "catchCopy": "【口コミ平均4.91/渋谷駅5分】マンツーマンサロン/癖もダメージもケアして理想の美髪に♪",
    "prefecture": "関東トップ",
    "area": "渋谷トップ",
    "address": "東京都渋谷区宇田川町３６－４　ヒューリック渋谷井の頭通り ６F",
    "latitude": 35.66195,
    "longitude": 139.69746,
    "nearestStation": "スクランブル交差点を渡りセンター街を直進...",
    "phone": "03-6277-5759",
    "openingHours": "am:10:00～pm9:00",
    "closedDays": "年末年始",
    "seats": "セット面8席",
    "paymentMethods": "Visa／Mastercard／JCB／American Express／PayPay iD suica",
    "overallRating": 4.91,
    "atmosphereRating": 4.9,
    "serviceRating": 4.9,
    "techniqueRating": 4.9,
    "menuPriceRating": 4.7,
    "reviewCount": 834,
    "customerGenderRatio": "女性 87% / 男性 12%",
    "customerAgeBreakdown": {
        "ladies": [
            { "age": "10代", "percent": 6 },
            { "age": "20代", "percent": 51 },
            { "age": "30代", "percent": 30 },
            { "age": "40代", "percent": 8 },
            { "age": "50代以上", "percent": 4 }
        ],
        "mens": [
            { "age": "20代", "percent": 39 },
            { "age": "30代", "percent": 33 },
            { "age": "40代", "percent": 21 }
        ]
    },
    "photos": ["https://imgbp.hotp.jp/CSP/IMG_SRC/18/03/B243411803/..."],
    "reviews": [
        {
            "reviewText": "当日予約できる所で探していてたまたまご予約させて頂いたのですが本当に満足のいく仕上がりでした。今回のカットやカラーの相談は勿論、私の髪の毛に対しての的確なアドバイスを頂けた気がします！",
            "overallRating": 5.0,
            "atmosphereRating": 5.0,
            "serviceRating": 5.0,
            "techniqueRating": 5.0,
            "menuPriceRating": 5.0,
            "reviewerGender": "女性",
            "reviewerAge": "30代前半",
            "menuUsed": "【平日限定】小顔カット＋ケラチンカラー　￥15400→￥8800",
            "treatmentMenu": "カット、カラー",
            "reviewDate": "2026/3/13"
        },
        {
            "reviewText": "子供に薦められて初めて伺いました。こちらの希望をきちんと聞いたうえでアドバイスしていただき、納得してお任せできました。仕上りにとても満足しています。",
            "overallRating": 4.0,
            "atmosphereRating": 4.0,
            "serviceRating": 5.0,
            "techniqueRating": 5.0,
            "menuPriceRating": 3.0,
            "reviewerGender": "女性",
            "reviewerAge": "50代",
            "menuUsed": "クーポン利用なし",
            "treatmentMenu": "カット",
            "reviewDate": "2026/5/11"
        }
    ],
    "stylists": [
        {
            "stylistName": "福田連太郎 《渋谷》",
            "position": "【Top Creator】@fukuda_rentaroi（歴9年）",
            "catchphrase": "顔周り/前髪カット/似合わせ/ケアストレート",
            "profilePhoto": "https://imgbp.hotp.jp/CSP/IMG_SRC/05/87/B217290587/...",
            "stylistUrl": "https://beauty.hotpepper.jp/slnH000700311/stylist/T000975356/"
        },
        {
            "stylistName": "西村拓也 《渋谷》",
            "position": "【店長】口コミ高評価/リピート率No.1（歴10年）",
            "catchphrase": "赤み消し透明感カラー/黒染めなし透ける暗髪/髪質改善",
            "profilePhoto": "https://imgbp.hotp.jp/CSP/IMG_SRC/61/58/B217476158/...",
            "stylistUrl": "https://beauty.hotpepper.jp/slnH000700311/stylist/T000944770/"
        }
    ],
    "coupons": [
        {
            "couponName": "小顔カット＋ケアトリートメント￥11000→￥6660",
            "couponType": "新規",
            "price": "¥6,660",
            "description": "カット＋ケアトリートメントがセットになった限定クーポン",
            "conditions": {
                "来店日条件": "指定なし",
                "対象スタイリスト": "指名なし Roi、福田連太郎、YUTO、石井魁登、西村拓也、高橋尚樹",
                "その他条件": "併用不可"
            },
            "menuCategories": ["カット", "トリートメント"]
        },
        {
            "couponName": "【2回目まで】小顔カット＋ケアトリートメント￥11000→ ￥8800",
            "couponType": "再来",
            "price": "¥8,800",
            "description": "【2回目のお客様限定】カット＋ケアTRがセットになった限定クーポン",
            "conditions": {
                "来店日条件": "指定なし",
                "対象スタイリスト": "全スタイリスト"
            },
            "menuCategories": ["カット", "トリートメント"]
        }
    ],
    "hairCatalog": [
        {
            "styleName": "大人可愛いぱっつんボブミルクティーブラウン20代30代40代",
            "stylePhoto": "https://imgbp.hotp.jp/CSP/IMG_SRC/85/87/B210728587/...",
            "stylistName": "Roi sibuya 《渋谷》",
            "styleUrl": "https://beauty.hotpepper.jp/slnH000700311/style/L220942864.html"
        },
        {
            "styleName": "ワンカールレイヤースタイル/ミルクティーブラウン/20代30代40代",
            "stylePhoto": "https://imgbp.hotp.jp/CSP/IMG_SRC/16/68/B242841668/...",
            "stylistName": "椎名裕紀 《渋谷》",
            "styleUrl": "https://beauty.hotpepper.jp/slnH000700311/style/L256439702.html"
        }
    ],
    "scrapedAt": "2026-05-15T00:00:00+00:00"
}
```

### Pricing

$3.50 per 1,000 results — Pay per event

### Use cases

- **J-Beauty market research** for K-Beauty companies entering Japan
- **Salon competitive intelligence** — pricing, ratings, customer profiles
- **Beauty trend analysis** — popular styles, colors, treatments by region
- **Lead generation** — salon contacts + stylist info
- **NLP research** on Japanese beauty reviews
- **Hair style trend tracking** with visual data
- **Coupon/pricing strategy analysis**

### Part of the Japan Data Suite

Looking for more Japanese data? Check out our other scrapers:

- 🍽️ [Tabelog Scraper](https://apify.com/huggable_quote/tabelog-scraper) — Japan's #1 restaurant review platform
- 🏨 [Jalan Scraper](https://apify.com/huggable_quote/jalan-scraper) — Japan's largest domestic travel platform

All three are **Recruit Holdings** properties — get the complete picture of Japan's service industry.

# Actor input Schema

## `startUrls` (type: `array`):

Direct Hot Pepper Beauty salon page URLs. Example: https://beauty.hotpepper.jp/slnH000457902/

## `searchUrls` (type: `array`):

Hot Pepper Beauty search or area listing URLs. Example: https://beauty.hotpepper.jp/svcSA/macAB/salon/

## `searchKeywords` (type: `array`):

Search keywords to find salons. Examples: '渋谷 カット', '表参道 カラー', '新宿 パーマ'

## `maxResultsPerSearch` (type: `integer`):

Maximum number of salons to collect per search/area URL.

## `includeReviews` (type: `boolean`):

Whether to scrape customer reviews for each salon.

## `maxReviewsPerSalon` (type: `integer`):

Maximum number of reviews to collect per salon. Set 0 for all reviews.

## `includeStylists` (type: `boolean`):

Whether to scrape stylist profiles for each salon.

## `includeHairCatalog` (type: `boolean`):

Whether to scrape the hair style catalog (photos, tags, stylist) for each salon.

## `maxStylesPerSalon` (type: `integer`):

Maximum number of hair styles to collect per salon.

## `includeCoupons` (type: `boolean`):

Whether to scrape coupon/pricing information for each salon.

## `proxyConfiguration` (type: `object`):

Proxy settings. Japan proxies recommended for best results.

## Actor input object example

```json
{
  "maxResultsPerSearch": 20,
  "includeReviews": true,
  "maxReviewsPerSalon": 20,
  "includeStylists": true,
  "includeHairCatalog": false,
  "maxStylesPerSalon": 10,
  "includeCoupons": true
}
```

# Actor output Schema

## `salons` (type: `string`):

Dataset containing salon details (25+ fields), reviews (12+ fields), stylist profiles, hair styles, and coupons from Hot Pepper Beauty.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("huggable_quote/hotpepper-beauty-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("huggable_quote/hotpepper-beauty-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 huggable_quote/hotpepper-beauty-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=huggable_quote/hotpepper-beauty-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Hot Pepper Beauty Scraper - Salons, Reviews & Stylists",
        "description": "The most comprehensive scraper for Japan's #1 beauty platform. Extract salon details, customer reviews, stylist profiles, hair catalogs, and coupon data from beauty.hotpepper.jp.",
        "version": "1.0",
        "x-build-id": "jtrbG0dP1XDZUpzWh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/huggable_quote~hotpepper-beauty-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-huggable_quote-hotpepper-beauty-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/huggable_quote~hotpepper-beauty-scraper/runs": {
            "post": {
                "operationId": "runs-sync-huggable_quote-hotpepper-beauty-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/huggable_quote~hotpepper-beauty-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-huggable_quote-hotpepper-beauty-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": {
                    "startUrls": {
                        "title": "Salon URLs",
                        "type": "array",
                        "description": "Direct Hot Pepper Beauty salon page URLs. Example: https://beauty.hotpepper.jp/slnH000457902/",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "searchUrls": {
                        "title": "Search / Area URLs",
                        "type": "array",
                        "description": "Hot Pepper Beauty search or area listing URLs. Example: https://beauty.hotpepper.jp/svcSA/macAB/salon/",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "searchKeywords": {
                        "title": "Search Keywords",
                        "type": "array",
                        "description": "Search keywords to find salons. Examples: '渋谷 カット', '表参道 カラー', '新宿 パーマ'",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResultsPerSearch": {
                        "title": "Max results per search",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Maximum number of salons to collect per search/area URL.",
                        "default": 20
                    },
                    "includeReviews": {
                        "title": "Include reviews",
                        "type": "boolean",
                        "description": "Whether to scrape customer reviews for each salon.",
                        "default": true
                    },
                    "maxReviewsPerSalon": {
                        "title": "Max reviews per salon",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of reviews to collect per salon. Set 0 for all reviews.",
                        "default": 20
                    },
                    "includeStylists": {
                        "title": "Include stylists",
                        "type": "boolean",
                        "description": "Whether to scrape stylist profiles for each salon.",
                        "default": true
                    },
                    "includeHairCatalog": {
                        "title": "Include hair catalog",
                        "type": "boolean",
                        "description": "Whether to scrape the hair style catalog (photos, tags, stylist) for each salon.",
                        "default": false
                    },
                    "maxStylesPerSalon": {
                        "title": "Max styles per salon",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of hair styles to collect per salon.",
                        "default": 10
                    },
                    "includeCoupons": {
                        "title": "Include coupons",
                        "type": "boolean",
                        "description": "Whether to scrape coupon/pricing information for each salon.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. Japan proxies recommended for best results."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
