# Wristcheck Luxury Watch Scraper (`lulzasaur/wristcheck-scraper`) Actor

Scrape luxury watch listings from Wristcheck.com — new and pre-owned Rolex, Patek Philippe, AP and more. Per listing: brand, model, collection, reference number, year, condition, WC grade, price (USD/HKD), box/papers, case size, image and URL. Filter by keyword, status, price; sort options.

- **URL**: https://apify.com/lulzasaur/wristcheck-scraper.md
- **Developed by:** [lulz bot](https://apify.com/lulzasaur) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 watch listing results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Wristcheck Luxury Watch Scraper

Scrape luxury watch listings from **[Wristcheck](https://wristcheck.com)** — the Hong Kong / New York based marketplace for new and pre-owned luxury watches (Rolex, Patek Philippe, Audemars Piguet, Omega, Cartier, Richard Mille and 100+ other brands).

Every record includes the brand, model, collection, **reference number**, production/purchase **year**, **condition** (Unworn / Pre-owned) plus Wristcheck's own **WC grade**, **price in USD and HKD**, box & papers status, case diameter and the direct listing URL.

### Why this scraper?

- **Price research** — pull asking prices for any reference (e.g. `116610LN`) in seconds
- **Sold-price history** — set status to `sold` to collect past sale listings for market analysis
- **Deal hunting** — sort by price, filter by budget, spot under-retail listings (`underRetail: true`)
- **Inventory monitoring** — schedule runs to track new arrivals with the `newest` sort
- **Dataset building** — feed watch-market dashboards, comps tools and ML models

### Input

| Field | Type | Description |
|---|---|---|
| `searchQueries` | array | Free-text searches — brand, model or reference number, e.g. `"rolex submariner"`, `"patek nautilus"`, `"116610LN"`. Use one empty string `""` to browse the whole catalog. |
| `status` | select | `available` (default, for sale now), `sold` (past sales / price history), or `all`. |
| `sortBy` | select | `relevance` (default), `newest`, `price_asc`, `price_desc`. |
| `minPriceUsd` / `maxPriceUsd` | integer | Optional USD price bounds. |
| `maxResults` | integer | Cap across all queries combined (default 100). |
| `proxyConfiguration` | object | Optional. The catalog API is open — direct access (no proxy) is the default and most reliable. |

#### Example input

```json
{
    "searchQueries": ["rolex submariner", "omega speedmaster"],
    "status": "available",
    "sortBy": "price_asc",
    "maxResults": 100
}
```

### Output

One dataset item per watch listing:

```json
{
    "id": "variant_01KZFM4CG7S779YFGJ2MBE6XJ4",
    "title": "Submariner Date Black Dial",
    "brand": "Rolex",
    "collection": "Submariner",
    "model": "Submariner Date Black Dial",
    "referenceNumber": "126610LN",
    "sku": "W123456",
    "condition": "Pre-owned",
    "wcGrade": "9.0",
    "year": 2021,
    "priceUsd": 14600,
    "priceHkd": 113636,
    "currency": "USD",
    "status": "available",
    "gender": "MEN",
    "caseDiameterMm": 41,
    "hasBox": true,
    "hasPapers": true,
    "servicePapers": false,
    "limitedEdition": false,
    "underRetail": false,
    "categories": ["sports-watches"],
    "shippingOrigin": "hk",
    "image": "https://res.cloudinary.com/wc-photo/image/upload/...",
    "url": "https://wristcheck.com/buy/rolex/submariner-date-black-dial?p=variant_01KZFM4CG7S779YFGJ2MBE6XJ4",
    "searchQuery": "rolex submariner",
    "source": "wristcheck.com",
    "scrapedAt": "2026-08-17T12:00:00.000Z"
}
```

### Field notes

- **`wcGrade`** — Wristcheck's in-house condition grade (10.0 = like new, down to 6.0; `BRAND_NEW` for unworn stock).
- **`condition`** — `Unworn` (new/unworn) or `Pre-owned`.
- **`year`** — the year purchased/produced as stated on the listing (may be null for some pieces).
- **`priceUsd` / `priceHkd`** — null for sold listings where the price is no longer displayed.
- **`status: sold`** records are useful for building sale-history comps.

### Tips

- Reference-number searches work: `"126610LN"`, `"5711/1A"`, `"15500ST"`.
- To export the entire available catalog, run with `searchQueries: [""]` and a high `maxResults`.
- Schedule daily `newest` runs and diff on `id` to get an alert feed of fresh arrivals.

### Not affiliated

This actor is not affiliated with or endorsed by Wristcheck. It collects only publicly visible listing data. Use responsibly and respect the site's terms of service.

# Actor input Schema

## `searchQueries` (type: `array`):

One or more free-text searches, e.g. 'rolex submariner', 'patek nautilus', 'omega speedmaster', or a reference number like '116610LN'. Leave a single empty string "" to browse the entire catalog.

## `status` (type: `string`):

Filter by availability. 'available' = currently for sale, 'sold' = past sales (great for price history), 'all' = both.

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

Order of results.

## `minPriceUsd` (type: `integer`):

Only return listings priced at or above this USD amount.

## `maxPriceUsd` (type: `integer`):

Only return listings priced at or below this USD amount.

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

Maximum number of watch listings to return across all queries combined. Default 100.

## `proxyConfiguration` (type: `object`):

Proxy settings. Wristcheck's search API is open and works best with direct access (no proxy). Only enable a proxy for very large runs.

## Actor input object example

```json
{
  "searchQueries": [
    "rolex submariner",
    "omega speedmaster"
  ],
  "status": "available",
  "sortBy": "relevance",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (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 = {
    "searchQueries": [
        "rolex submariner",
        "omega speedmaster"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("lulzasaur/wristcheck-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 = {
    "searchQueries": [
        "rolex submariner",
        "omega speedmaster",
    ],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("lulzasaur/wristcheck-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 '{
  "searchQueries": [
    "rolex submariner",
    "omega speedmaster"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call lulzasaur/wristcheck-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lulzasaur/wristcheck-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/qgXgP0tscVfb0gegB/builds/bdLHWiVor200uoXec/openapi.json