{
  "openapi": "3.0.1",
  "info": {
    "title": "Kakaku.com Scraper - Prices, Shops, Reviews & Price History",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "Hr4Hx2jKtI6XWZrvb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~kakaku-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-kakaku-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/abotapi~kakaku-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-kakaku-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/abotapi~kakaku-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-kakaku-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "What do you want to scrape?",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Search by keyword or category, or paste kakaku.com links. Fields of the other mode are ignored.",
            "default": "search"
          },
          "searchTerms": {
            "title": "Search keywords",
            "type": "array",
            "description": "One search per keyword, in Japanese or English (iphone, ノートパソコン). Results come back in the site's popularity order unless you change Sort by.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "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": {
            "title": "Sort by",
            "enum": [
              "popular",
              "priceAsc",
              "priceDesc",
              "rating",
              "reviews",
              "newest"
            ],
            "type": "string",
            "description": "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).",
            "default": "popular"
          },
          "minPrice": {
            "title": "Minimum price (yen)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products priced at or above this lowest price. Leave empty for no minimum."
          },
          "maxPrice": {
            "title": "Maximum price (yen)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products priced at or below this lowest price. Leave empty for no maximum."
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "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": {
            "title": "Include sponsored rows",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "urls": {
            "title": "Links",
            "type": "array",
            "description": "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.",
            "default": [
              "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"
            ],
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Add product details",
            "type": "boolean",
            "description": "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).",
            "default": true
          },
          "includePriceHistory": {
            "title": "Add price history",
            "type": "boolean",
            "description": "Adds the daily average and lowest price series of the last two years to each product. Applies when Add product details is on.",
            "default": true
          },
          "maxReviews": {
            "title": "Max reviews per product",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "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.",
            "default": 20
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "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": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "The one default cap on the run (20). Maximum rows to return across all searches and links. 0 means unlimited.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "default": {
              "useApifyProxy": true
            }
          },
          "resumeFromRunId": {
            "title": "Resume from run ID",
            "type": "string",
            "description": "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": {
            "title": "Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Optional name for a monitoring campaign. Runs sharing a key share their incremental state. Leave empty to scope it automatically to the search."
          },
          "changeScope": {
            "title": "Change scope (incremental mode only)",
            "enum": [
              "all",
              "priceAndStock"
            ],
            "type": "string",
            "description": "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.",
            "default": "all"
          },
          "compactUpdates": {
            "title": "Compact UPDATED rows (incremental mode only)",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit expired products (incremental mode only)",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after missed scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "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.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "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.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "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": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}