{
  "openapi": "3.0.1",
  "info": {
    "title": "Japan Used Watch Market — Search, Stats, History & Alerts",
    "description": "Search, benchmark and monitor Japan's used watch shops (WATCHNIAN, Hard Off) in one schema: canonical brands, reference numbers, normalized grades, box & warranty card, JPY/USD. Median prices per model, daily price history, NEW / PRICE_DROP alerts to Slack, Discord, n8n.",
    "version": "0.1",
    "x-build-id": "Kzb8kVksFsZLwBmKC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/keiya_dev~japan-used-watch-market/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-keiya_dev-japan-used-watch-market",
        "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/keiya_dev~japan-used-watch-market/runs": {
      "post": {
        "operationId": "runs-sync-keiya_dev-japan-used-watch-market",
        "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/keiya_dev~japan-used-watch-market/run-sync": {
      "post": {
        "operationId": "run-sync-keiya_dev-japan-used-watch-market",
        "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",
          "sources"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "stats",
              "monitor",
              "history"
            ],
            "type": "string",
            "description": "search = return listings. stats = model stats of in-stock listings (count, min / median / max by shop & condition grade). monitor = compare against the last run and emit only NEW / PRICE_DROP / PRICE_UP / SOLD_OUT events (use with a Schedule). history = daily min / median / count per model, by shop and condition grade, from stored daily snapshots (no crawling; needs keywords, brands or models). History is collected since 2026-11-05 (WATCHNIAN daily, Off Mall weekly) — treat the first 30 days as indicative.",
            "default": "search"
          },
          "sources": {
            "title": "Shops",
            "type": "array",
            "description": "Which shops to search. WATCHNIAN (Ippuukishi, ~3,900 used watches, with box / warranty-card info from product pages) and Hard Off Off Mall (~24,000 wristwatches on sale, nationwide stores).",
            "items": {
              "type": "string",
              "enum": [
                "watchnian",
                "offmall"
              ],
              "enumTitles": [
                "WATCHNIAN (ウォッチニアン, formerly 一風騎士) — all used watches",
                "Hard Off Off Mall (ハードオフ オフモール) — wristwatches on sale"
              ]
            },
            "default": [
              "watchnian",
              "offmall"
            ]
          },
          "keywords": {
            "title": "Keywords (OR)",
            "type": "array",
            "description": "Only keep listings whose brand + title contains any of these (case-insensitive, English or Japanese; reference numbers work too). Leave empty to get everything. Examples: \"Grand Seiko\", \"SBGA211\", \"Speedmaster\", \"16233\", \"G-SHOCK\".",
            "items": {
              "type": "string"
            }
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Optional exact brand filter (canonical English names, e.g. Rolex, Omega, Grand Seiko, Seiko, Casio G-SHOCK, Citizen, Cartier, TAG Heuer).",
            "items": {
              "type": "string"
            }
          },
          "models": {
            "title": "Model keys (history mode)",
            "type": "array",
            "description": "History mode: only these exact model keys, as shown in the \"model\" field of stats mode (\"brand ref\", e.g. \"omega 3510.50\", \"grand seiko sbga211\", \"rolex 16233\").",
            "items": {
              "type": "string"
            }
          },
          "days": {
            "title": "Days of history (history mode)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "History mode: how many days back to return, counting today (JST).",
            "default": 90
          },
          "minPriceJpy": {
            "title": "Min price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop listings cheaper than this."
          },
          "maxPriceJpy": {
            "title": "Max price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop listings more expensive than this."
          },
          "grades": {
            "title": "Condition grades",
            "type": "array",
            "description": "Keep only these normalized grades. NEW > UNUSED > SA (like new) > A > AB > B > C > JUNK (not working / parts); ANTIQUE = ungraded antique pieces.",
            "items": {
              "type": "string",
              "enum": [
                "NEW",
                "UNUSED",
                "SA",
                "A",
                "AB",
                "B",
                "C",
                "JUNK",
                "ANTIQUE"
              ]
            }
          },
          "includeSoldOut": {
            "title": "Include sold-out listings",
            "type": "boolean",
            "description": "Search mode: also return listings marked sold out. Both shops list watches on sale only, so this rarely changes anything.",
            "default": false
          },
          "fullScan": {
            "title": "Full scan (monitor mode)",
            "type": "boolean",
            "description": "Monitor mode only. Off (default): lists are read newest-first and stop after 20 already-known listings in a row (normally 1 request per shop per run). On: read every page (WATCHNIAN ≈ 66 pages, ~3 min; Off Mall ≈ 800 pages, ~27 min) to catch every PRICE_DROP / PRICE_UP / SOLD_OUT. Tip: frequent light runs plus a daily full scan of WATCHNIAN only.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor ID (monitor mode)",
            "type": "string",
            "description": "Optional. Each monitor keeps its own snapshot, keyed by its filters (keywords, brands, grades, price range, includeSoldOut). Set a monitorId to separate several schedules that use the same filters, or to keep the snapshot when you edit the filters. Letters, digits and - _ . only."
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many matching listings across all selected shops (0 = no limit). WATCHNIAN has ~3,900 used watches, Off Mall ~24,000. In search mode each returned WATCHNIAN listing also costs one product-page request (for box / warranty card). Ignored in monitor mode.",
            "default": 200
          },
          "jpyPerUsd": {
            "title": "JPY per USD",
            "minimum": 1,
            "type": "number",
            "description": "Exchange rate used for priceUsd. Leave empty to fetch the current rate automatically."
          },
          "alertWebhookUrl": {
            "title": "Alert webhook URL (monitor mode)",
            "type": "string",
            "description": "Optional. In monitor mode every batch of monitor events is POSTed as JSON to this URL. Works with Slack/Discord incoming webhooks, n8n, Make, Zapier."
          },
          "alertEvents": {
            "title": "Monitor events to output",
            "type": "array",
            "description": "Monitor mode: only these event types are written to the dataset, charged, and sent to the webhook.",
            "items": {
              "type": "string",
              "enum": [
                "NEW",
                "PRICE_DROP",
                "PRICE_UP",
                "SOLD_OUT"
              ]
            },
            "default": [
              "NEW",
              "PRICE_DROP"
            ]
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Off by default (direct connection). Datacenter proxies are more likely to be challenged by the shop's bot protection; switch to residential proxy only if runs get blocked.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}