# Yodobashi Product Scraper (`sian.agency/yodobashi-product-scraper`) Actor

Scrape Yodobashi.com products — JPY price, Gold Points, ratings, images, specs & stock. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.

- **URL**: https://apify.com/sian.agency/yodobashi-product-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** E-commerce, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.75 / 1,000 overview products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Yodobashi Product Scraper — JPY Prices, Specs & Stock 🛍️

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Home Depot Product Scraper](https://img.shields.io/badge/Store-Home%20Depot%20Scraper-F96302)](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian)

#### 🎉 Pull Yodobashi.com prices, Gold Points, ratings, and stock — by keyword or category, no code
##### Built for retail analysts, resellers, and brands who need fresh Japanese-market product data on demand

---

### 📋 Overview

**Track every price, point reward, and product spec on Yodobashi.com (ヨドバシ.com) — without writing a single line of code.** This scraper turns any Yodobashi search or category into a clean, structured spreadsheet of products, complete with JPY prices, Gold Points, ratings, images, and stock — Japan's leading consumer-electronics retailer.

**Why professionals choose us:**
- ✅ **Complete product data**: price (JPY), Gold Points, point rate, rating, review count, brand/maker, release date, and more
- ⚡ **Fast search-first mode**: pull up to ~48 products per page in seconds; scale to thousands across multiple searches
- 🌏 **Native Japanese support**: search in Japanese or English (`ノートパソコン`, `Nintendo Switch`) — results in the correct JP store/locale
- 💴 **Yen pricing & rewards**: tax-inclusive JPY price plus the Gold Point reward every product earns
- 💰 **Pay only for results**: charged per product you actually receive — no wasted spend, free tier to test
- 💎 **Detail enrichment**: add the full specifications table, the long description, and the complete image gallery with one switch

---

### ✨ Features

- 🔎 **Keyword & Category Search**: scrape any Yodobashi search term (Japanese or English) or category path
- 🏷️ **Full Pricing (JPY)**: tax-inclusive selling price in Japanese yen
- 🟡 **Gold Points**: the points and reward rate (%) each product earns
- ⭐ **Ratings & Reviews**: star rating and total review count for every product
- 📅 **Release Dates**: the product's release date (発売日) for new-arrival tracking
- 🖼️ **Product Images**: hero image in overview, the full gallery in detail mode
- 🧾 **Specifications Table**: full structured specs (Detail mode) — Japanese spec sheet, ready for feeds
- 🧭 **Breadcrumbs & Categories**: the product's full category path for clean classification
- 🏬 **Stock Status**: availability label and number of stores holding stock, when shown
- 📦 **Clean Export**: results delivered as structured JSON or CSV, ready for Excel or your database
- 🚀 **No-Code Setup**: configure searches in a simple form — no scripts, no maintenance

---

### 🎬 Quick Start

Enter one or more search keywords, pick a mode, and run. In under a minute you'll have a structured dataset of Yodobashi products you can download as JSON or CSV. No setup, no proxies, no code.

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~yodobashi-product-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"keywords": ["Nintendo Switch"], "scrapeMode": "overview"}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Add Your Searches

Type one or more Yodobashi search keywords (e.g. `Nintendo Switch`, `ノートパソコン`, `イヤホン`) — one per line. Japanese and English both work.

#### Step 2: Choose Your Mode

Pick **Overview** for fast search results, or **Detail** to also pull the full specifications table, the long description and the complete image gallery.

#### Step 3: Run & Download

Click **Start**, then export your results as JSON, CSV, or Excel from the Apify dataset.

**That's it! In just a few minutes, you'll have:**

- A clean table of Yodobashi products with JPY prices and Gold Points
- Ratings, review counts, and product images
- Stock status and release dates

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| keywords | array | No | Yodobashi search terms, one per item (`Nintendo Switch`, `ノートパソコン`) |
| categoryPaths | array | No | Advanced — Yodobashi category paths from a category URL (e.g. `140007/140008`) |
| scrapeMode | string | No | `overview` (fast search) or `detail` (adds specs table + long description + gallery) |
| sort | string | No | `popular`, `newest`, `price_low`, `price_high`, or `release_new` |
| mkrbrnds | string | No | Advanced — maker/brand filter code from a Yodobashi search URL |
| minPrice / maxPrice | integer | No | Price band in JPY |
| maxResults | integer | No | Maximum products to return across all searches |

**Example — fast search:**

```json
{
  "keywords": ["Nintendo Switch", "ワイヤレスイヤホン"],
  "scrapeMode": "overview",
  "sort": "popular",
  "maxResults": 100
}
```

**Example — full detail with specs:**

```json
{
  "keywords": ["ノートパソコン"],
  "scrapeMode": "detail",
  "sort": "price_low",
  "maxResults": 50
}
```

***

### 📤 Output

Results are saved to the Apify dataset with a rich field set per product, including:

| Field | Type | Description |
|-------|------|-------------|
| productTitle | string | Product name (Japanese) |
| brand | string | Brand / maker |
| maker\_code | string | Yodobashi maker code |
| release\_date | string | Release date (発売日) |
| price | number | Tax-inclusive price in JPY |
| currency | string | Always `JPY` |
| points | number | Gold Points awarded |
| point\_rate | number | Point reward rate (%) |
| rating | number | Average star rating |
| review\_count | number | Total number of reviews |
| in\_stock | boolean | Whether the product is available |
| availability | string | Raw availability label (Japanese) |
| store\_stock\_count | number | Stores holding stock, when shown |
| images | array | Product image URLs (full gallery in Detail mode) |
| breadcrumbs | array | Full category path |
| specs | object | Full specifications table (Detail mode) |
| description | string | Long product description (Detail mode) |

**Example:**

```json
{
  "sku": "100000001009063421",
  "productTitle": "Nintendo Switch 2（日本語・国内専用） [Nintendo Switch 2 本体]",
  "brand": "任天堂 Nintendo",
  "maker_code": "0000001509",
  "release_date": "2025/06/05",
  "price": 59980,
  "currency": "JPY",
  "points": 600,
  "point_rate": 1,
  "rating": 4.75,
  "review_count": 214,
  "in_stock": true,
  "availability": "在庫あり",
  "images": ["https://image.yodobashi.com/product/..."],
  "breadcrumbs": ["ゲーム", "TVゲーム", "ゲーム機本体"],
  "specs": { "セット内容": "..." },
  "description": "「Nintendo Switch」が\"2\"になりました..."
}
```

***

### 💼 Use Cases & Examples

#### 1. Price Monitoring

**Resellers and analysts tracking Yodobashi prices over time to stay competitive.**

**Input:** Your product keywords and a daily schedule
**Output:** Current JPY price and Gold Points for every match
**Use:** Spot price drops, react to point campaigns, and keep your own pricing sharp.

#### 2. Competitive Analysis

**Brands and category managers benchmarking their products against the Yodobashi assortment.**

**Input:** Category keywords
**Output:** Competitor prices, ratings, review counts, and point rewards
**Use:** Understand where you win or lose on price, rating, and rewards.

#### 3. Catalog Building

**E-commerce teams building a clean Japanese product catalog with images and specs.**

**Input:** Keywords or category paths, in Detail mode
**Output:** Titles, makers, release dates, images, and full specifications tables
**Use:** Populate your storefront or PIM with structured, ready-to-use product data.

#### 4. Cross-Border Arbitrage & Sourcing

**Resellers sourcing Japanese electronics for export or marketplace listing.**

**Input:** Your target product keywords
**Output:** Live JPY prices, point rewards, and stock status
**Use:** Identify margin opportunities and in-stock items to source quickly.

#### 5. New-Release & Trend Spotting

**Analysts tracking new product launches and best-sellers in the Japanese market.**

**Input:** Broad category keywords, sorted by newest or release date
**Output:** Product launches, release dates, and rating momentum
**Use:** Surface emerging products and category trends before competitors do.

#### 6. Market Research

**Researchers studying Japanese consumer-electronics pricing and assortment.**

**Input:** Category keywords across multiple makers
**Output:** Price distribution, rating data, and maker breakdown
**Use:** Build a structured view of the Japanese electronics market.

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/yodobashi-product-scraper').call({
  keywords: ['Nintendo Switch'],
  scrapeMode: 'overview'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/yodobashi-product-scraper').call(
    run_input={'keywords': ['ノートパソコン'], 'scrapeMode': 'overview'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~yodobashi-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"keywords": ["Nintendo Switch"], "scrapeMode": "overview"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule (e.g. daily) or webhook
2. **HTTP Request**: Call the actor API with your keywords
3. **Process**: Handle the JSON results
4. **Action**: Save to a sheet, sync to a database, or send a price-drop alert

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **25 products** per run — full feature access, same data quality
- No credit card required
- Perfect for testing and small projects

#### PAID Tier (Production Ready)

- **Unlimited** products per run
- Run multiple searches and large categories in one go
- Pay-per-result: you're only charged for the products you actually receive

💰 **Best value on the market** — transparent pay-per-result pricing with no hidden proxy or subscription fees.

🔗 [View current pricing](https://apify.com/sian.agency/yodobashi-product-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many products can I scrape?**
A: FREE tier: 25 products per run. PAID tier: unlimited products across as many searches as you like.

**Q: Can I search in Japanese?**
A: Yes — Japanese and English keywords both work, and results come from the Japanese (JPY) store.

**Q: What's the difference between Overview and Detail mode?**
A: Overview is the fast path — search results with JPY price, Gold Points, ratings, images, and stock. Detail adds the full specifications table, the long product description, and the complete image gallery for every product.

**Q: What currency are prices in?**
A: All prices are in Japanese yen (JPY), tax-inclusive, exactly as shown on Yodobashi.com.

**Q: What output formats are available?**
A: JSON, CSV, and Excel — export directly from the Apify dataset.

**Q: Can I scrape by category instead of keywords?**
A: Yes — use the `categoryPaths` field with a Yodobashi category path to scrape a whole category.

**Q: Is this legal?**
A: Yes — we only extract publicly available product data. See the legal section below.

**Q: How fresh is the data?**
A: Every run pulls live data directly from Yodobashi at the moment you run it. Schedule runs to keep prices and stock up to date.

***

### 🐞 Troubleshooting

**No results returned**

- Check that your keywords match real Yodobashi products
- Try a broader search term or a different sort order

**Missing specifications or description**

- Specs and long descriptions only appear in **Detail** mode — switch `scrapeMode` to `detail`

**Fewer results than expected on the free tier**

- The FREE tier is capped at 25 products per run — upgrade to PAID for unlimited results

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what is publicly shared. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

***

### ⚖️ Trademark Disclaimer

Yodobashi® and ヨドバシ.com are trademarks of Yodobashi Camera Co., Ltd. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Yodobashi Camera Co., Ltd.

***

### ⭐ Love This Tool?

If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/yodobashi-product-scraper/reviews) — it helps other professionals discover it and helps us keep improving.

***

### 🤝 Support

[![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi)

**Join our active support community**

- For issues or questions, open an issue in the actor's repository
- Check the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools
- 📧 <apify@sian-agency.online>

#### More from SIÁN Agency

- 🛠️ [Home Depot Product Scraper](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) — Home Depot prices, specs & store stock
- 🛍️ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) — track offers and price history across the web
- 📦 [Amazon Influencer & Deals Scraper](https://apify.com/sian.agency/amazon-influencer-deals-scraper?fpr=sian) — Amazon deals and influencer storefront data

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `keywords` (type: `array`):

🔍 **KEYWORD SEARCH:** Free-text Yodobashi searches — exactly what you'd type into the site's search bar. Japanese or English terms both work.

📝 **EXAMPLES:** `Nintendo Switch` · `ノートパソコン` (laptop) · `イヤホン` (earphones) · `Sony カメラ`

💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.

🖊️ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line).

✅ **IMPORTANT:** Provide either keywords OR category paths (at least one is needed to have something to scrape).

## `categoryPaths` (type: `array`):

🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Yodobashi category instead of a keyword search.

🔧 **HOW TO GET IT:** Open any Yodobashi category page and copy the numeric path segment from the URL (e.g. `140007/140008` from `yodobashi.com/category/140007/140008/`). Paste just the path here (no leading or trailing slash).

💡 **TIP:** Leave this empty if you're only using keywords — it's purely an advanced alternative for category-level harvesting.

🖊️ **BULK EDIT:** Add one category path per line to sweep multiple categories in a single run.

## `scrapeMode` (type: `string`):

⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.

⚡ **Overview (fast):** Search results only — JPY price, Gold Points, ratings, images, brand/maker and stock. Fastest and cheapest path.

🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, the long product description and the complete image gallery scraped from each product page.

💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.

## `sort` (type: `string`):

🔃 **RESULT ORDERING:** Order search results using Yodobashi's own native sort options — so you get the same ranking real shoppers see.

🏆 **Popular** surfaces the most popular products first · 🆕 **Newest** prioritizes the latest arrivals · 💲 **Price** sorts ascending or descending · 📅 **Release date** leads with the newest releases.

## `mkrbrnds` (type: `string`):

™️ **MAKER FILTER (Advanced):** Restrict results to a single maker/brand using Yodobashi's own maker code.

🔧 **HOW TO FIND IT:** On a search page, click a maker under the brand filter and copy the `mkrbrnds=` value from the URL (e.g. `0000001509` for Nintendo).

💡 **TIP:** Leave empty to include all makers.

## `minPrice` (type: `integer`):

💴 **PRICE FLOOR (JPY):** Only return products at or above this price, in Japanese yen. Leave empty for no lower bound.

## `maxPrice` (type: `integer`):

💴 **PRICE CEILING (JPY):** Only return products at or below this price, in Japanese yen. Leave empty for no upper bound.

## `maxResults` (type: `integer`):

🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.

🎁 **TIER-BASED LIMITS:**

- **FREE users:** Up to 25 products per run
- **PAID users:** Unlimited — scrape entire catalogs in a single run

💡 **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.

## Actor input object example

```json
{
  "keywords": [
    "Nintendo Switch"
  ],
  "categoryPaths": [],
  "scrapeMode": "overview",
  "sort": "popular",
  "mkrbrnds": "",
  "maxResults": 100
}
```

# Actor output Schema

## `yodobashiProducts` (type: `string`):

Scraped Yodobashi products with JPY prices, Gold Points, ratings, images, specs and stock.

# 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 = {
    "keywords": [
        "Nintendo Switch"
    ],
    "scrapeMode": "overview",
    "sort": "popular",
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/yodobashi-product-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 = {
    "keywords": ["Nintendo Switch"],
    "scrapeMode": "overview",
    "sort": "popular",
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/yodobashi-product-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 '{
  "keywords": [
    "Nintendo Switch"
  ],
  "scrapeMode": "overview",
  "sort": "popular",
  "maxResults": 100
}' |
apify call sian.agency/yodobashi-product-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Yodobashi Product Scraper",
        "description": "Scrape Yodobashi.com products — JPY price, Gold Points, ratings, images, specs & stock. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.",
        "version": "1.0",
        "x-build-id": "j7NnwWM1d2Y9fkdqc"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~yodobashi-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-yodobashi-product-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/sian.agency~yodobashi-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-yodobashi-product-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/sian.agency~yodobashi-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-yodobashi-product-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": {
                    "keywords": {
                        "title": "🔍 Search Keywords",
                        "type": "array",
                        "description": "🔍 **KEYWORD SEARCH:** Free-text Yodobashi searches — exactly what you'd type into the site's search bar. Japanese or English terms both work.\n\n📝 **EXAMPLES:** `Nintendo Switch` · `ノートパソコン` (laptop) · `イヤホン` (earphones) · `Sony カメラ`\n\n💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.\n\n🖊️ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\n✅ **IMPORTANT:** Provide either keywords OR category paths (at least one is needed to have something to scrape).",
                        "default": [
                            "Nintendo Switch"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "categoryPaths": {
                        "title": "🧭 Category Paths (Advanced)",
                        "type": "array",
                        "description": "🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Yodobashi category instead of a keyword search.\n\n🔧 **HOW TO GET IT:** Open any Yodobashi category page and copy the numeric path segment from the URL (e.g. `140007/140008` from `yodobashi.com/category/140007/140008/`). Paste just the path here (no leading or trailing slash).\n\n💡 **TIP:** Leave this empty if you're only using keywords — it's purely an advanced alternative for category-level harvesting.\n\n🖊️ **BULK EDIT:** Add one category path per line to sweep multiple categories in a single run.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "scrapeMode": {
                        "title": "⚙️ Scrape Mode",
                        "enum": [
                            "overview",
                            "detail"
                        ],
                        "type": "string",
                        "description": "⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\n⚡ **Overview (fast):** Search results only — JPY price, Gold Points, ratings, images, brand/maker and stock. Fastest and cheapest path.\n\n🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, the long product description and the complete image gallery scraped from each product page.\n\n💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.",
                        "default": "overview"
                    },
                    "sort": {
                        "title": "🔃 Sort Order",
                        "enum": [
                            "popular",
                            "newest",
                            "price_low",
                            "price_high",
                            "release_new"
                        ],
                        "type": "string",
                        "description": "🔃 **RESULT ORDERING:** Order search results using Yodobashi's own native sort options — so you get the same ranking real shoppers see.\n\n🏆 **Popular** surfaces the most popular products first · 🆕 **Newest** prioritizes the latest arrivals · 💲 **Price** sorts ascending or descending · 📅 **Release date** leads with the newest releases.",
                        "default": "popular"
                    },
                    "mkrbrnds": {
                        "title": "™️ Maker / Brand Filter (Advanced)",
                        "type": "string",
                        "description": "™️ **MAKER FILTER (Advanced):** Restrict results to a single maker/brand using Yodobashi's own maker code.\n\n🔧 **HOW TO FIND IT:** On a search page, click a maker under the brand filter and copy the `mkrbrnds=` value from the URL (e.g. `0000001509` for Nintendo).\n\n💡 **TIP:** Leave empty to include all makers.",
                        "default": ""
                    },
                    "minPrice": {
                        "title": "💴 Min Price (JPY)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "💴 **PRICE FLOOR (JPY):** Only return products at or above this price, in Japanese yen. Leave empty for no lower bound."
                    },
                    "maxPrice": {
                        "title": "💴 Max Price (JPY)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "💴 **PRICE CEILING (JPY):** Only return products at or below this price, in Japanese yen. Leave empty for no upper bound."
                    },
                    "maxResults": {
                        "title": "🔢 Max Results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.\n\n🎁 **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited — scrape entire catalogs in a single run\n\n💡 **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.",
                        "default": 100
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```