# Watchfinder Pre-Owned Luxury Watch Scraper (`lulzasaur/watchfinder-scraper`) Actor

Scrape pre-owned luxury watches from Watchfinder & Co. (watchfinder.com). Per listing: brand, model/series, reference number, price, condition, year, box & papers, seller, image and URL. Search by brand or keyword like 'rolex submariner', 'omega', 'patek philippe'.

- **URL**: https://apify.com/lulzasaur/watchfinder-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 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

## Watchfinder Pre-Owned Luxury Watch Scraper

Scrape pre-owned and vintage luxury watches from [Watchfinder & Co.](https://www.watchfinder.com), one of the world's largest certified pre-owned watch retailers. Search by brand or keyword and get clean, structured listing data including price, reference number, year and box-and-papers status.

### What it does

For each search query (e.g. `rolex submariner`, `omega speedmaster`, `patek philippe`), the actor pages through Watchfinder's catalog and returns every matching watch with:

- **title** — brand + model line + reference
- **brand** — e.g. Rolex, Omega, Patek Philippe, Audemars Piguet
- **model** — model line / collection (e.g. Submariner, Speedmaster, Nautilus)
- **modelName** — brand + model line convenience field
- **referenceNumber** — manufacturer reference number
- **sku** — Watchfinder stock number
- **price** — asking price (USD)
- **condition** — Pre-Owned or Unworn
- **year** — year of manufacture
- **boxAndPapers** — Box & Papers / Box only / Papers only / Watch only
- **hasBox** / **hasPapers** — boolean flags
- **seller** — Watchfinder & Co.
- **image** — product image URL
- **url** — listing URL
- **searchQuery**, **source**, **scrapedAt** — provenance

Use an empty string `""` as a query to browse the entire pre-owned catalog.

### Input

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

- **searchQueries** (array) — brand or keyword searches. Empty string browses everything.
- **maxResults** (integer) — max listings across all queries combined (default 100).
- **proxyConfiguration** (object) — optional. Watchfinder serves plain server-rendered HTML and works best with direct access; a proxy is only needed for very large runs.

### Output

Each item is one watch listing pushed to the dataset. Example:

```json
{
  "title": "Rolex Submariner 1680",
  "brand": "Rolex",
  "model": "Submariner",
  "modelName": "Rolex Submariner",
  "referenceNumber": "1680",
  "sku": "422126",
  "price": 10950,
  "currency": "USD",
  "condition": "Pre-Owned",
  "year": 1977,
  "boxAndPapers": "Watch only",
  "hasBox": false,
  "hasPapers": false,
  "seller": "Watchfinder & Co.",
  "image": "https://www.watchfinder.com/media/catalog/product/...",
  "url": "https://www.watchfinder.com/watches/rolex/submariner/1680/422126",
  "source": "watchfinder.com"
}
```

### Pricing

This actor uses **pay per result**: a small per-item charge for each watch listing returned, plus a tiny actor start fee. Failed runs that return no results are not billed for items.

# Actor input Schema

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

One or more brand or keyword searches, e.g. 'rolex submariner', 'omega', 'patek philippe', 'audemars piguet'. Each query is matched against Watchfinder's catalog. Use an empty string "" to browse the entire pre-owned catalog.

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

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

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

Proxy settings. Watchfinder serves listings as plain server-rendered HTML and works best with direct access; a proxy is only recommended for very large runs to distribute volume.

## Actor input object example

```json
{
  "searchQueries": [
    "rolex submariner",
    "omega speedmaster"
  ],
  "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/watchfinder-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/watchfinder-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/watchfinder-scraper --silent --output-dataset

```

## MCP server setup

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