{
  "openapi": "3.0.1",
  "info": {
    "title": "⌚ Luxury Watch Price & Arbitrage Scraper [From 💰$0.85/1K]",
    "description": "[From $0.85/1K] Scrape and compare luxury watch listings across Chrono24, eBay, WatchCharts, Bob's Watches & Watchfinder. Filter by Reference, Dial, Bezel, Bracelet, Condition & Year with FMV arbitrage discount %.",
    "version": "0.0",
    "x-build-id": "lUhm0LMhjdlqubt69"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/misterkhan~luxury-watch-marketplace-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-misterkhan-luxury-watch-marketplace-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/misterkhan~luxury-watch-marketplace-scraper/runs": {
      "post": {
        "operationId": "runs-sync-misterkhan-luxury-watch-marketplace-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/misterkhan~luxury-watch-marketplace-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-misterkhan-luxury-watch-marketplace-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": {
          "brand": {
            "title": "Watch Brand",
            "type": "string",
            "description": "Primary watch brand (e.g. 'Rolex', 'Omega', 'Audemars Piguet', 'Patek Philippe', 'Cartier', 'Tudor').",
            "default": "Rolex"
          },
          "collection": {
            "title": "Collection / Family",
            "type": "string",
            "description": "Watch collection or model line (e.g. 'Datejust 41', 'Submariner Date', 'GMT-Master II', 'Cosmograph Daytona', 'Speedmaster Professional', 'Royal Oak').",
            "default": "Datejust 41"
          },
          "model": {
            "title": "Model / Nickname Keyword (Optional)",
            "type": "string",
            "description": "Optional collector nickname or variant keyword (e.g. 'Wimbledon', 'Pepsi', 'Batgirl', 'Starbucks', 'Panda', 'Moonwatch')."
          },
          "reference": {
            "title": "Reference Number",
            "type": "string",
            "description": "Exact manufacturer reference number (e.g. '126334', '126610LN', '126710BLRO', '116500LN', '310.30.42.50.01.002', '15500ST').",
            "default": "126334"
          },
          "includePlatforms": {
            "title": "Include Marketplaces",
            "uniqueItems": true,
            "type": "array",
            "description": "Select which luxury watch marketplaces to scrape fresh on every run.",
            "items": {
              "type": "string",
              "enum": [
                "chrono24",
                "ebay",
                "ebay_sold",
                "bobswatches",
                "watchfinder",
                "watchcharts"
              ],
              "enumTitles": [
                "Chrono24 (Active Listings)",
                "eBay (Active Wristwatch Listings)",
                "eBay (Sold / Completed Comps)",
                "Bob's Watches (Certified Pre-Owned)",
                "Watchfinder & Co. (Global Inventory)",
                "WatchCharts (Marketplace & Forum Comps)"
              ]
            },
            "default": [
              "chrono24",
              "ebay",
              "bobswatches",
              "watchfinder"
            ]
          },
          "excludePlatforms": {
            "title": "Exclude Marketplaces",
            "uniqueItems": true,
            "type": "array",
            "description": "Select any marketplaces to explicitly exclude from the run.",
            "items": {
              "type": "string",
              "enum": [
                "chrono24",
                "ebay",
                "ebay_sold",
                "bobswatches",
                "watchfinder",
                "watchcharts"
              ],
              "enumTitles": [
                "Chrono24 (Active Listings)",
                "eBay (Active Wristwatch Listings)",
                "eBay (Sold / Completed Comps)",
                "Bob's Watches (Certified Pre-Owned)",
                "Watchfinder & Co. (Global Inventory)",
                "WatchCharts (Marketplace & Forum Comps)"
              ]
            },
            "default": []
          },
          "dial": {
            "title": "💎 [Deep Filter] Dial Color / Style",
            "type": "string",
            "description": "Filter by normalized dial color or style (e.g. 'Wimbledon', 'Mint Green', 'Blue Index', 'Blue Roman', 'White Index', 'Panda', 'Slate Grey', 'Black Index', 'Mother of Pearl', 'Meteorite'). Activates Deep Horological Spec Filtering."
          },
          "bracelet": {
            "title": "💎 [Deep Filter] Bracelet / Strap Type",
            "type": "string",
            "description": "Filter by bracelet or strap configuration (e.g. 'Jubilee', 'Oyster', 'President', 'Oysterflex', 'Leather Strap')."
          },
          "bezel": {
            "title": "💎 [Deep Filter] Bezel Type",
            "type": "string",
            "description": "Filter by bezel style (e.g. 'Fluted', 'Smooth', 'Ceramic', 'Diamond')."
          },
          "condition": {
            "title": "💎 [Deep Filter] Condition Cohort",
            "enum": [
              "ALL",
              "UNWORN",
              "MINT",
              "PRE_OWNED"
            ],
            "type": "string",
            "description": "Filter by normalized condition grade across all platforms.",
            "default": "ALL"
          },
          "completeness": {
            "title": "💎 [Deep Filter] Box & Papers Completeness",
            "enum": [
              "ALL",
              "FULL_SET",
              "BOX_ONLY",
              "PAPERS_ONLY",
              "WATCH_ONLY"
            ],
            "type": "string",
            "description": "Filter by delivery scope (Full Set with Box & Papers vs Watch Only).",
            "default": "ALL"
          },
          "yearMin": {
            "title": "💎 [Deep Filter] Minimum Production Year",
            "minimum": 1950,
            "maximum": 2026,
            "type": "integer",
            "description": "Minimum production or warranty card year (e.g. 2021)."
          },
          "yearMax": {
            "title": "💎 [Deep Filter] Maximum Production Year",
            "minimum": 1950,
            "maximum": 2026,
            "type": "integer",
            "description": "Maximum production or warranty card year (e.g. 2026)."
          },
          "sellerCountry": {
            "title": "💎 [Deep Filter] Seller Country (ISO Code)",
            "type": "string",
            "description": "Filter by 2-letter seller country code or name (e.g. 'US', 'JP', 'GB', 'DE', 'CH', 'HK')."
          },
          "priceMinUsd": {
            "title": "Minimum Price (USD)",
            "minimum": 100,
            "type": "integer",
            "description": "Minimum asking price in USD (automatically filters out low-cost spare links/straps).",
            "default": 1000
          },
          "priceMaxUsd": {
            "title": "Maximum Price (USD)",
            "minimum": 100,
            "type": "integer",
            "description": "Optional maximum asking price ceiling in USD."
          },
          "strictReferenceMatch": {
            "title": "Strict Reference Number Guard",
            "type": "boolean",
            "description": "When enabled (default), rejects sibling references that marketplaces inject into search results (e.g. rejects Smooth Bezel 126300 when searching Fluted Bezel 126334).",
            "default": true
          },
          "enrichChrono24Details": {
            "title": "💎 [Deep Filter] Deep-Enrich Chrono24 Spec Sheets",
            "type": "boolean",
            "description": "When enabled, visits individual Chrono24 '--id*.htm' watch detail pages to extract full specification tables when card titles omit production year or dial details.",
            "default": false
          },
          "sortBy": {
            "title": "Sort Output By",
            "enum": [
              "deal_score",
              "price_asc",
              "price_desc",
              "match_score"
            ],
            "type": "string",
            "description": "Order of returned marketplace listings.",
            "default": "deal_score"
          },
          "maxItems": {
            "title": "Maximum Total Listings",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum number of unified watch listings to return across all selected platforms (Free tier cap: 25 listings/run).",
            "default": 40
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}