# Kakaku.com Scraper - Prices, Shops, Reviews & Price History (`abotapi/kakaku-scraper`) Actor

Scrape Kakaku.com Japan by keyword, category or URL. Extract lowest and highest prices, shop offers, shipping costs, stock availability, specifications, ratings, reviews, rankings, price history and product variants. Ideal for price comparison and market research.

- **URL**: https://apify.com/abotapi/kakaku-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 result rows

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Kakaku.com Scraper

Collect product, price and review data from Kakaku.com (kakaku.com), Japan's largest price comparison site: laptops, phones, cameras, appliances and thousands of other product types. Search by keyword, browse a category or paste links, and get one clean row per product with every shop's price, full specs, ratings, reviews, rankings and price history (where shown).

### Why This Scraper?

- **Every shop's price.** With details on, each product carries the full shop list: shop name, price, shipping, stock and dispatch time, payment methods, region and the shop's own comment, plus the lowest and highest shop price.
- **Full specs and identity.** The complete spec table, spec summary, maker, category path, breadcrumbs, release date, maker price when published, full image gallery and the maker's product page link.
- **Ratings and reviews.** Star rating, review count, discussion post count, popularity rank with the number of ranked products, and user reviews with sub-ratings (set how many to keep).
- **Price history.** The daily average and lowest price series of the last two years, on product pages that show it (not on model parent rows).
- **Many ways in.** Keyword search, category browsing with sort and price filters, and links of every kind: searches, category listings, rankings, products, smartphone model pages, review pages and shop pages.
- **Smartphone models.** Model pages return the colour and storage variants together with the model's shop prices.
- **Change tracking.** Schedule recurring runs and receive only new or updated products, optionally limited to price and availability changes.

### Use Cases

- **Price monitoring:** follow the lowest price and every shop's offer on the products you track.
- **Market research:** compare makers, specs, ratings and popularity inside a category.
- **Product catalogues:** enrich a catalogue with specs, images, release dates and maker links.
- **Review analysis:** collect user reviews with sub-ratings for sentiment work.
- **Shop research:** find which shops carry a product and at what price, shipping and stock.

### Data You Get

> Sample shape: values are illustrative placeholders, not from a live record.

| Field | Example |
| --- | --- |
| `recordType` | `product` |
| `item_id` | `K0000000000` |
| `model_id` | `M0000000000` |
| `url` | `kakaku.com/item/K0000000000/` |
| `name` | `Example Laptop 14 inch` |
| `maker` | `Example Maker` |
| `category` | `Laptops` |
| `category_path` | `Computers, Laptops, Example Maker` |
| `images` | `Full image gallery` |
| `price_lowest_yen` | `100000` |
| `price_highest_yen` | `120000` |
| `msrp_yen` | `110000` |
| `release_date` | `2026-01-01` |
| `rating` | `4.5` |
| `review_count` | `10` |
| `ranking_position` | `1` |
| `shop_count` | `5` |
| `specs` | `Full spec table (label and value)` |
| `spec_summary_tags` | `Screen size: 14 inch` |
| `price_history` | `Daily average and lowest price (where shown)` |
| `maker_site_url` | `Maker product page` |
| `variants` | `Colour and storage variants` |
| `reviews` | `Rating, title, text, sub-ratings, date` |
| `shops` | `Shop, price, shipping, stock, payment, region, comment` |
| `is_ad` | `false` |

### How to Use

1. Pick a mode: search by keyword or category, or paste links.
2. Set the sort, price and rating filters and the maximum number of items.
3. Run the actor.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

**Search by keyword:**

```json
{ "mode": "search", "searchTerms": ["iphone"], "sortBy": "priceAsc", "maxItems": 50 }
```

**Browse a category:**

```json
{ "mode": "search", "category": "pc/note-pc", "minPrice": 100000, "maxPrice": 200000, "sortBy": "rating", "maxItems": 100 }
```

**Paste links:**

```json
{ "mode": "url", "urls": ["https://kakaku.com/item/K0001794291/", "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_so=p1", "https://kakaku.com/shop/3933/"], "maxItems": 50 }
```

Links that are not a search, category, ranking, product, model or shop page (the home page, help pages, other sites) are skipped with a warning.

**Recurring monitoring:**

```json
{ "mode": "search", "category": "pc/note-pc", "incrementalMode": true, "changeScope": "priceAndStock", "maxItems": 500 }
```

#### Run it from your code

Python:

```python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("<ACTOR_ID>").call(run_input={"mode": "search", "searchTerms": ["iphone"], "maxItems": 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item["price_lowest_yen"])
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('<ACTOR_ID>').call({ mode: 'search', searchTerms: ['iphone'], maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length);
```

#### Tips

- A keyword search mixes in model rows for phones and sponsored rows from outside shops. Sponsored rows are skipped unless Include sponsored rows is on.
- Turn off Add product details for the quickest runs when you only need the core fields from the listing.
- Set Max reviews per product to 0 and turn off Add price history to keep details lighter.
- Use a category path such as pc/note-pc to browse a whole category with sort and price filters.

### Send results into your apps (MCP connectors)

Optionally send a condensed summary of the results into Notion, Linear, Airtable or Apify through Model Context Protocol connectors. Authorize a connector once in your Apify integrations settings, then select it in the input. The full records always stay in the dataset.

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | search | Search by keyword or category, or paste links. |
| `searchTerms` | array | iphone | One search per keyword. |
| `category` | string | empty | Category path (pc/note-pc) or listing link, browsed as one more search. |
| `sortBy` | string | popular | Popularity, price low to high or high to low; rating, reviews and newest apply to categories. |
| `minPrice` | integer | empty | Minimum lowest price in yen. |
| `maxPrice` | integer | empty | Maximum lowest price in yen. |
| `minRating` | number | empty | Minimum rating from 0 to 5. |
| `includeAds` | boolean | false | Return sponsored rows flagged with is_ad. |
| `urls` | array | sample links | Search, category, ranking, product, model, review or shop links. |
| `fetchDetails` | boolean | true | Adds the shop price list, full specs, maker link, ranking, variants and reviews. |
| `includePriceHistory` | boolean | true | Adds the daily price series of the last two years. |
| `maxReviews` | integer | 20 | Reviews kept per product; 0 skips them. |
| `maxPages` | integer | empty | Pages per search; does not cap the run on its own. |
| `maxItems` | integer | 20 | Maximum rows; 0 means unlimited. |
| `proxy` | object | Apify Proxy | Connection settings. Residential is recommended for the most reliable results. |
| `resumeFromRunId` | string | empty | Skip rows already collected by an earlier run. |
| `incrementalMode` | boolean | false | Return only new or updated products. |
| `stateKey` | string | empty | Name a monitoring campaign. |
| `changeScope` | string | all | Compare all fields, or price and availability only. |
| `compactUpdates` | boolean | false | Return UPDATED and EXPIRED rows as slim rows with old and new prices. |
| `emitExpired` | boolean | false | Also return products that are no longer found, after a complete scan. |
| `expireAfterMissedScans` | integer | 1 | Complete scans a product must miss before it is marked EXPIRED. |
| `ignoreFieldsForChanges` | array | empty | Extra fields that never mark a product as updated. |
| `mcpConnectors` | array | empty | Connectors to send results to. |
| `notionParentPageUrl` | string | empty | Notion parent page. |
| `maxNotifyListings` | integer | 50 | Items exported per connector. |

#### Connection and plans

The default connection works for this site and is billed with your Apify plan. Residential is recommended for the most reliable results; it is billed by traffic on your account and you can pick it in the proxy settings.

If the selected connection is refused, the run switches to a backup connection on its own, and says so in the log. Apify free plans do not include residential proxies: on a free plan the run continues on a backup connection, and the log shows a short notice. Some pages may still be unavailable there. For residential access, upgrade at https://apify.com/pricing or supply your own proxy URLs.

### Output Example

> Sample shape: values are illustrative placeholders, not from a live record.

```json
{
  "recordType": "product",
  "item_id": "K0000000000",
  "name": "Example Laptop 14 inch",
  "maker": "Example Maker",
  "category": "Laptops",
  "price_lowest_yen": 100000,
  "price_highest_yen": 120000,
  "release_date": "2026-01-01",
  "rating": 4.5,
  "review_count": 10,
  "ranking_position": 1,
  "shop_count": 2,
  "specs": { "Screen size": "14 inch", "Memory": "16 GB" },
  "shops": [
    { "shop_id": "0", "shop_name": "Example Shop", "price_yen": 100000, "shipping": "Free", "stock": "In stock", "payment": ["Card"], "region": null, "comment": "Example comment", "rank": 1 }
  ],
  "reviews": [
    { "review_id": "0", "title": "Example title", "rating": 5, "posted_date": "2026-01-02", "body": "Example review text", "helpful_count": 0 }
  ],
  "is_ad": false
}
```

### Plan Requirement

The actor works on any Apify plan with no action needed: the default connection reads every Kakaku.com page type. Residential proxies are optional and are not required for normal runs. Billing follows the pricing shown on the Store page.

### FAQ

#### How much does a run cost?

You pay per run start, per row returned and, when details are on, per enriched product. Reviews are counted in blocks of 10: every started block of 10 delivered reviews (Max reviews per product, 20 by default) adds one more detail unit to that product, and a product with no details or no reviews adds none. Set Max items and Max reviews per product to control the total.

#### Is it legal to scrape Kakaku.com?

The actor reads publicly visible product and price information. You are responsible for using the data in line with applicable law and the site terms, including data protection rules.

#### Can I schedule runs?

Yes. Use Incremental mode on a schedule to receive only changes, and set Change scope to price and availability when only prices matter.

#### Why did a run return nothing?

The keyword or category may match nothing, the filters may be too strict, or a link may not be a supported page. Try a broader keyword or relax the filters.

#### Why are some fields empty?

Not every product has every field: a maker price or release date is only shown when the site has one, and some product types have no reviews. With Add product details off, the detail-only fields (shops, reviews, price history) stay empty.

#### Can I use it with AI tools?

Yes, through the Apify MCP server or the connectors above.

### 🔗 Want more electronics data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🔌 <a href="https://apify.com/abotapi/biccamera-com-scraper"><b>Bic Camera Scraper</b></a><br>Scrape Bic Camera (biccamera.com) products: JPY price, list price and discount, Bic Point...</td><td>🔌 <a href="https://apify.com/abotapi/appliancesonline-com-au-scraper"><b>Appliances Online Scraper</b></a><br>Scrape appliancesonline.com.au by category, keyword, or URL. Extract title, brand, AUD...</td></tr>
<tr><td>🔌 <a href="https://apify.com/abotapi/yodobashi-com-scraper"><b>Yodobashi Scraper</b></a><br>Scrape yodobashi.com electronics and appliances: JPY price, list price and discount...</td><td>🔌 <a href="https://apify.com/abotapi/pbtech-co-nz-scraper"><b>PB Tech Scraper</b></a><br>Scrape pbtech.co.nz products with full specifications, price, brand, condition, per-store...</td></tr>
<tr><td>🔌 <a href="https://apify.com/abotapi/dienmayxanh-scraper"><b>Dienmayxanh Scraper</b></a><br>Scrape dienmayxanh.com home appliances and electronics with full specifications, current...</td><td>🔌 <a href="https://apify.com/abotapi/fnac-com-scraper"><b>Fnac Scraper</b></a><br>Scrape Fnac (fnac.com) products: current price plus strike-through discount, colour/model...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/kakaku-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

Search by keyword or category, or paste kakaku.com links. Fields of the other mode are ignored.

## `searchTerms` (type: `array`):

One search per keyword, in Japanese or English (iphone, ノートパソコン). Results come back in the site's popularity order unless you change Sort by.

## `category` (type: `string`):

Optional. Browse a whole product category instead of (or as well as) keywords: a path such as pc/note-pc or kaden/rice-cooker, or a category listing link. Runs as one more search.

## `sortBy` (type: `string`):

Order of the results. Price sorting works for categories, and for keywords when sorted high to low; a keyword sorted low to high mostly lists outside-shop offers (skipped), so use a category or a price range for the cheapest products. Rating, review count and newest apply to categories only (a keyword search keeps the popularity order for those).

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

Only products priced at or above this lowest price. Leave empty for no minimum.

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

Only products priced at or below this lowest price. Leave empty for no maximum.

## `minRating` (type: `number`):

Only keep products rated at least this value (0 to 5). Unrated products are dropped when this is set. Leave empty for no filter.

## `includeAds` (type: `boolean`):

Search results mix in sponsored listings from outside shops. They are skipped by default; turn this on to return them flagged with is_ad. Ignored in incremental mode.

## `urls` (type: `array`):

One link per line. Accepted: a keyword search (search.kakaku.com/iphone/, with page, sort, price filters), a category listing (…/itemlist.aspx with page, sort, maker and price filters) or a category page, a category ranking, the site ranking, a top category page (kakaku.com/pc/), an item (with or without /spec/, /pricehistory/, /images/), a smartphone model page, a review page or a shop page. Tracking parameters are ignored. Filter fields are ignored in this mode.

## `fetchDetails` (type: `boolean`):

Opens each product to add the full shop price list (price, shipping, stock, payment, shop comment), the complete spec table, maker site link, ranking, review and discussion counts, variants for smartphones and reviews. Billed as one detail-enrichment unit per enriched result, plus one more unit per started block of 10 delivered reviews (Max reviews per product).

## `includePriceHistory` (type: `boolean`):

Adds the daily average and lowest price series of the last two years to each product. Applies when Add product details is on.

## `maxReviews` (type: `integer`):

How many user reviews to keep on each product row (0 skips them). Applies when Add product details is on. Every started block of 10 delivered reviews adds one detail-enrichment unit.

## `maxPages` (type: `integer`):

Does not cap the run: it has no default and defers to Max items, which is the only default cap. Leave empty or 0 to walk every result page; set it only to stop a search earlier.

## `maxItems` (type: `integer`):

The one default cap on the run (20). Maximum rows to return across all searches and links. 0 means unlimited.

## `proxy` (type: `object`):

Proxy settings. The default connection works on every plan. Residential is recommended for the most reliable results (large or frequent runs); it is billed by traffic on your account. If the selected connection is refused, the run switches to a backup connection on its own.

## `resumeFromRunId` (type: `string`):

Run ID (or dataset ID) of a previous run of this Actor. Rows already collected there are skipped, so this run returns only the delta. Leave empty for a normal run. For recurring monitoring of the same search, use Incremental mode instead.

## `incrementalMode` (type: `boolean`):

For recurring monitoring. A product is returned as NEW the first time, and as UPDATED when a compared field changes: lowest and highest price, maker price, shop count, any shop's price, shipping or stock, rating, review count, name, description, specs, images and release date. Not compared (still in the row): daily popularity rank, the shop's position in the price list, the price history series, the sponsored flag, the scrape time and a review's helpful-vote counter. Unchanged products are not returned or billed. State is kept per search setup, or per State key when you set one.

## `stateKey` (type: `string`):

Optional name for a monitoring campaign. Runs sharing a key share their incremental state. Leave empty to scope it automatically to the search.

## `changeScope` (type: `string`):

All compared fields (default) marks a product UPDATED when any compared field changes. Price and availability only compares just the lowest and highest price, maker price, shop count and each shop's price, shipping and stock, so name, spec or image edits never create a billable row.

## `compactUpdates` (type: `boolean`):

Off by default. Turn on to return UPDATED and EXPIRED rows as slim rows: item id, link, name, current prices and shop count, plus priceChanges and variantChanges (per shop) with the old and new values. NEW rows stay complete. A compact row carries no detail-only data, so it does not add a detail-enrichment charge.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned a complete search or category from its first page, so never when Max items or Max pages capped it, when Resume was used, when a page could not be read, or for single item, shop and ranking links. This returns, and bills, extra rows.

## `expireAfterMissedScans` (type: `integer`):

With Emit expired products on, a product is marked EXPIRED only after it was missing from this many consecutive complete scans (default 1). EXPIRED means it was no longer found in the listing; a listing drop and a delisting look the same without opening each product.

## `ignoreFieldsForChanges` (type: `array`):

Field names that must not make a product UPDATED, for example review_count or rating. A dotted path such as shops.comment ignores that key inside every shop entry while the rest is still compared. The fields stay in the returned row. Changing this list keeps your saved state, so it never causes a wave of UPDATED rows.

## `mcpConnectors` (type: `array`):

Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify Settings, Integrations, then select it here. The connector receives a condensed summary per item; the full record stays in the dataset. Leave empty to skip.

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "searchTerms": [
    "iphone"
  ],
  "sortBy": "popular",
  "includeAds": false,
  "urls": [
    "https://search.kakaku.com/iphone/",
    "https://kakaku.com/search_results/iphone/",
    "https://search.kakaku.com/iphone/?page=2",
    "https://search.kakaku.com/iphone/?sort=pricet",
    "https://search.kakaku.com/iphone/?minp=10000&maxp=50000",
    "https://kakaku.com/pc/note-pc/itemlist.aspx",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pg=2",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_so=p1",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_ma=901",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pr=100000-200000",
    "https://kakaku.com/pc/note-pc/",
    "https://kakaku.com/item/K0001794291/",
    "https://kakaku.com/item/K0001794291/spec/",
    "https://kakaku.com/item/K0001794291/pricehistory/",
    "https://kakaku.com/item/K0001794291/images/",
    "https://kakaku.com/item/K0001794291/?lid=itemview_spec",
    "https://kakaku.com/keitai/smartphone/model/M0000001194/",
    "https://kakaku.com/shop/3933/",
    "https://review.kakaku.com/review/K0001794291/",
    "https://kakaku.com/pc/note-pc/ranking_0020/",
    "https://kakaku.com/ranking/",
    "https://kakaku.com/pc/",
    "https://kakaku.com/item/K0001794291"
  ],
  "fetchDetails": true,
  "includePriceHistory": true,
  "maxReviews": 20,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "changeScope": "all",
  "compactUpdates": false,
  "emitExpired": false,
  "expireAfterMissedScans": 1,
  "ignoreFieldsForChanges": [],
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `shops` (type: `string`):

No description

## `reviews` (type: `string`):

No description

## `shopProfiles` (type: `string`):

No description

## `changes` (type: `string`):

No description

# 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 = {
    "mode": "search",
    "searchTerms": [
        "iphone"
    ],
    "urls": [
        "https://search.kakaku.com/iphone/",
        "https://kakaku.com/search_results/iphone/",
        "https://search.kakaku.com/iphone/?page=2",
        "https://search.kakaku.com/iphone/?sort=pricet",
        "https://search.kakaku.com/iphone/?minp=10000&maxp=50000",
        "https://kakaku.com/pc/note-pc/itemlist.aspx",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pg=2",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_so=p1",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_ma=901",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pr=100000-200000",
        "https://kakaku.com/pc/note-pc/",
        "https://kakaku.com/item/K0001794291/",
        "https://kakaku.com/item/K0001794291/spec/",
        "https://kakaku.com/item/K0001794291/pricehistory/",
        "https://kakaku.com/item/K0001794291/images/",
        "https://kakaku.com/item/K0001794291/?lid=itemview_spec",
        "https://kakaku.com/keitai/smartphone/model/M0000001194/",
        "https://kakaku.com/shop/3933/",
        "https://review.kakaku.com/review/K0001794291/",
        "https://kakaku.com/pc/note-pc/ranking_0020/",
        "https://kakaku.com/ranking/",
        "https://kakaku.com/pc/",
        "https://kakaku.com/item/K0001794291"
    ],
    "proxy": {
        "useApifyProxy": true
    },
    "incrementalMode": false,
    "compactUpdates": false,
    "emitExpired": false,
    "ignoreFieldsForChanges": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/kakaku-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 = {
    "mode": "search",
    "searchTerms": ["iphone"],
    "urls": [
        "https://search.kakaku.com/iphone/",
        "https://kakaku.com/search_results/iphone/",
        "https://search.kakaku.com/iphone/?page=2",
        "https://search.kakaku.com/iphone/?sort=pricet",
        "https://search.kakaku.com/iphone/?minp=10000&maxp=50000",
        "https://kakaku.com/pc/note-pc/itemlist.aspx",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pg=2",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_so=p1",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_ma=901",
        "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pr=100000-200000",
        "https://kakaku.com/pc/note-pc/",
        "https://kakaku.com/item/K0001794291/",
        "https://kakaku.com/item/K0001794291/spec/",
        "https://kakaku.com/item/K0001794291/pricehistory/",
        "https://kakaku.com/item/K0001794291/images/",
        "https://kakaku.com/item/K0001794291/?lid=itemview_spec",
        "https://kakaku.com/keitai/smartphone/model/M0000001194/",
        "https://kakaku.com/shop/3933/",
        "https://review.kakaku.com/review/K0001794291/",
        "https://kakaku.com/pc/note-pc/ranking_0020/",
        "https://kakaku.com/ranking/",
        "https://kakaku.com/pc/",
        "https://kakaku.com/item/K0001794291",
    ],
    "proxy": { "useApifyProxy": True },
    "incrementalMode": False,
    "compactUpdates": False,
    "emitExpired": False,
    "ignoreFieldsForChanges": [],
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/kakaku-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchTerms": [
    "iphone"
  ],
  "urls": [
    "https://search.kakaku.com/iphone/",
    "https://kakaku.com/search_results/iphone/",
    "https://search.kakaku.com/iphone/?page=2",
    "https://search.kakaku.com/iphone/?sort=pricet",
    "https://search.kakaku.com/iphone/?minp=10000&maxp=50000",
    "https://kakaku.com/pc/note-pc/itemlist.aspx",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pg=2",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_so=p1",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_ma=901",
    "https://kakaku.com/pc/note-pc/itemlist.aspx?pdf_pr=100000-200000",
    "https://kakaku.com/pc/note-pc/",
    "https://kakaku.com/item/K0001794291/",
    "https://kakaku.com/item/K0001794291/spec/",
    "https://kakaku.com/item/K0001794291/pricehistory/",
    "https://kakaku.com/item/K0001794291/images/",
    "https://kakaku.com/item/K0001794291/?lid=itemview_spec",
    "https://kakaku.com/keitai/smartphone/model/M0000001194/",
    "https://kakaku.com/shop/3933/",
    "https://review.kakaku.com/review/K0001794291/",
    "https://kakaku.com/pc/note-pc/ranking_0020/",
    "https://kakaku.com/ranking/",
    "https://kakaku.com/pc/",
    "https://kakaku.com/item/K0001794291"
  ],
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "compactUpdates": false,
  "emitExpired": false,
  "ignoreFieldsForChanges": []
}' |
apify call abotapi/kakaku-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/kakaku-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/tBVPWNH5vsVKnvcai/builds/Hr4Hx2jKtI6XWZrvb/openapi.json
