# Jomashop Luxury Watch Listings Scraper (`automation-lab/jomashop-luxury-watch-listings-scraper`) Actor Scrape public Jomashop watch listings with SKUs, prices, discounts, stock status, images, and optional product descriptions. - **URL**: https://apify.com/automation-lab/jomashop-luxury-watch-listings-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Jomashop Luxury Watch Listings Scraper Extract public Jomashop luxury watch catalog listings with prices, SKUs, brand/model/reference hints, stock status, images, and optional description/spec text. ### What does Jomashop Luxury Watch Listings Scraper do? Jomashop Luxury Watch Listings Scraper collects structured product listing data from the public Jomashop watch catalog. It uses Jomashop's public GraphQL catalog endpoint to paginate product rows without opening a browser. Use it to monitor retail prices, compare discounts, build ecommerce catalogs, and track stock changes across thousands of watch listings. ### Who is it for? - 🕰️ Watch dealers tracking grey-market inventory and retail spreads. - 📈 Ecommerce analysts comparing list prices, final prices, and discounts. - 🛒 Marketplace sellers building product matching and arbitrage workflows. - 💼 Data teams enriching internal SKU databases with public catalog metadata. - 🔔 Price-monitoring teams looking for repeatable daily or weekly watch exports. ### Why use this actor? - HTTP-only scraping path for low compute cost. - Public Jomashop catalog data, no login required. - SKU-first output designed for product matching. - Includes final price, list price, discount amount, discount percent, and stock status. - Optional detail mode for product descriptions and specification text. ### What data can I extract? | Field | Description | | --- | --- | | `productUrl` | Jomashop product page URL | | `sku` | Jomashop SKU | | `name` | Product listing name | | `brand` | Parsed brand hint from the name | | `model` | Parsed model/name hint | | `reference` | Parsed reference/SKU-like value | | `category` | Category label | | `categoryId` | Magento category ID used for the query | | `finalPrice` | Current listed sale/final price | | `listPrice` | Regular/list price when available | | `discountAmount` | Discount amount in listing currency | | `discountPercent` | Discount percentage | | `currency` | Listing currency, usually USD | | `stockStatus` | Jomashop stock status | | `imageUrls` | Product image URLs | | `description` | Optional detail description text | | `shortDescription` | Optional short description | | `specsText` | Optional specification/description text | | `source` | `jomashop.com` | | `scrapedAt` | ISO timestamp | ### How much does it cost to scrape Jomashop watch listings? This actor uses pay-per-event pricing. A small start event is charged once per run, and each saved product listing is charged as one result. Formula-derived pricing with platform minimums starts at about $0.36 per 1,000 saved listings on the BRONZE tier, before Apify plan discounts and tier-specific adjustments. ### How to use it 1. Open the actor on Apify. 2. Keep the default watches category URL or provide another public Jomashop category URL. 3. Set `maxItems` to the number of listings you want. 4. Keep `includeDetails` disabled for fast price-monitoring exports. 5. Enable `includeDetails` when you also need description/spec text. 6. Run the actor. 7. Download the dataset as JSON, CSV, Excel, XML, or via API. ### Input options #### `startUrls` Optional list of public Jomashop category URLs. The default is: ```json [{ "url": "https://www.jomashop.com/watches.html" }] ```` #### `categoryId` Direct Jomashop/Magento category ID. The default `871` points to the public watches category. #### `maxItems` Maximum number of product listings to save. Start with 50 for a sample run, then increase for monitoring or full exports. #### `pageSize` Number of products requested per GraphQL page. Values between 50 and 100 are efficient for larger runs. #### `includeDetails` When enabled, the actor performs one extra GraphQL query per product to collect description/spec text. Leave it disabled for the cheapest and fastest listing-only runs. ### Example input ```json { "startUrls": [{ "url": "https://www.jomashop.com/watches.html" }], "categoryId": "871", "maxItems": 50, "pageSize": 50, "includeDetails": false } ``` ### Example output ```json { "productUrl": "https://www.jomashop.com/tissot-carson-watch-t1224071105100.html", "sku": "TIST1224071105100", "name": "Tissot Carson Automatic Black Dial Men's Watch T122.407.11.051.00", "brand": "Tissot", "model": "Carson Automatic Black Dial", "reference": "T122.407.11.051.00", "category": "Watches", "categoryId": "871", "finalPrice": 419, "listPrice": 419, "discountAmount": 0, "discountPercent": 0, "currency": "USD", "stockStatus": "IN_STOCK", "imageUrls": ["https://cdn2.jomashop.com/media/catalog/product/...jpg"], "description": null, "shortDescription": null, "specsText": null, "source": "jomashop.com", "scrapedAt": "2026-06-07T00:00:00.000Z" } ``` ### Tips for best results - Use `includeDetails: false` for regular price monitoring. - Use `includeDetails: true` only when you need product description/spec text. - Increase `maxItems` gradually when testing new categories. - Keep `pageSize` at 50 or 100 for efficient pagination. - Use SKU and reference fields for matching against internal product databases. ### Integrations - 📊 Send CSV exports to Google Sheets or Excel for pricing analysis. - 🧩 Use the dataset API in product matching pipelines. - 🔔 Schedule daily runs and compare `finalPrice`, `discountPercent`, and `stockStatus`. - 🏷️ Join output rows with marketplace listings by SKU, brand, model, or reference. - 🛍️ Feed ecommerce catalog enrichment jobs with public image and price metadata. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/jomashop-luxury-watch-listings-scraper').call({ startUrls: [{ url: 'https://www.jomashop.com/watches.html' }], categoryId: '871', maxItems: 50, pageSize: 50, includeDetails: false, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items.slice(0, 3)); ``` ### API usage with Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('automation-lab/jomashop-luxury-watch-listings-scraper').call(run_input={ 'startUrls': [{'url': 'https://www.jomashop.com/watches.html'}], 'categoryId': '871', 'maxItems': 50, 'pageSize': 50, 'includeDetails': False, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items[:3]) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~jomashop-luxury-watch-listings-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"startUrls":[{"url":"https://www.jomashop.com/watches.html"}],"categoryId":"871","maxItems":50,"pageSize":50,"includeDetails":false}' ``` ### MCP usage Use this actor from Apify MCP tools in Claude Desktop, Claude Code, or other MCP clients. MCP server URL: ```text https://mcp.apify.com/?tools=automation-lab/jomashop-luxury-watch-listings-scraper ``` Claude Code setup: ```bash claude mcp add apify-jomashop "https://mcp.apify.com/?tools=automation-lab/jomashop-luxury-watch-listings-scraper" ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-jomashop": { "url": "https://mcp.apify.com/?tools=automation-lab/jomashop-luxury-watch-listings-scraper" } } } ``` Example prompts: - "Run the Jomashop watch scraper for 100 products and summarize the biggest discounts." - "Compare today's Jomashop output with yesterday's dataset by SKU." - "Find in-stock watches over $1,000 with discount percent above 20%." ### Scheduling Set up an Apify schedule to run the actor daily, weekly, or monthly. Price and stock-monitoring workflows work best when the same input is used repeatedly and results are compared by SKU. ### Data quality notes Brand, model, and reference are parsed from public product names and SKUs. Jomashop does not always expose every watch attribute as a separate listing field, so treat parsed values as helpful matching hints rather than manufacturer-certified normalized attributes. ### FAQ #### Is this an official Jomashop API? No. The actor uses public catalog responses that are visible without an account. It is not affiliated with or endorsed by Jomashop. #### Does it require a proxy? The current implementation is HTTP-only and did not require a proxy during development or cloud validation. ### Troubleshooting #### Why are descriptions empty? Descriptions are only collected when `includeDetails` is enabled. Listing-only mode is faster and cheaper but intentionally skips per-product detail queries. #### Why did I get fewer products than `maxItems`? The category may contain fewer reachable products than requested, or the public endpoint may return duplicate SKUs that are skipped to keep the dataset clean. #### Can I scrape another Jomashop category? Yes. Provide a public Jomashop category URL or a direct category ID. The actor is optimized for watches, but the GraphQL listing fields are also useful for other retail categories. ### Legality This actor collects publicly available catalog data. You are responsible for using the data in compliance with applicable laws, Jomashop's terms, and Apify's terms. Avoid collecting personal data and do not use the actor for prohibited purposes. ### Related scrapers Explore other Automation Lab actors for ecommerce, marketplace, and price-monitoring workflows: - https://apify.com/automation-lab/amazon-product-scraper - https://apify.com/automation-lab/ebay-scraper - https://apify.com/automation-lab/shopify-scraper ### Changelog - Initial version: public Jomashop GraphQL listing pagination, pricing fields, image URLs, stock status, and optional product details. ### Support If you need a field that is visible on Jomashop but missing from the dataset, open an issue with an example product URL and the field name. ### Limits The actor depends on Jomashop's public catalog endpoint. If Jomashop changes its GraphQL schema or blocks public catalog access, the actor may need an update. ### Version Current actor version: `0.1`. # Actor input Schema ## `startUrls` (type: `array`): Optional public Jomashop category URLs. The actor tries to detect the Magento category ID from the page. Leave the prefilled watches URL for the main watches catalog. ## `categoryId` (type: `string`): Direct Jomashop/Magento category ID. Defaults to 871, the public Watches category, when no ID is found in start URLs. ## `maxItems` (type: `integer`): Maximum number of watch listings to save. ## `pageSize` (type: `integer`): Products requested per GraphQL page. Lower values are useful for testing; 50-100 is efficient for larger exports. ## `includeDetails` (type: `boolean`): When enabled, the actor performs one extra GraphQL query per product to collect description/spec text. Disable for fastest price monitoring runs. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.jomashop.com/watches.html" } ], "categoryId": "871", "maxItems": 20, "pageSize": 50, "includeDetails": false } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.jomashop.com/watches.html" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/jomashop-luxury-watch-listings-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.jomashop.com/watches.html" }] } # Run the Actor and wait for it to finish run = client.actor("automation-lab/jomashop-luxury-watch-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.jomashop.com/watches.html" } ] }' | apify call automation-lab/jomashop-luxury-watch-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/jomashop-luxury-watch-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jomashop Luxury Watch Listings Scraper", "description": "Scrape public Jomashop watch listings with SKUs, prices, discounts, stock status, images, and optional product descriptions.", "version": "0.1", "x-build-id": "Kfc5tF6j86qkdwIL6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~jomashop-luxury-watch-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-jomashop-luxury-watch-listings-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/automation-lab~jomashop-luxury-watch-listings-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-jomashop-luxury-watch-listings-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/automation-lab~jomashop-luxury-watch-listings-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-jomashop-luxury-watch-listings-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": { "startUrls": { "title": "Jomashop category URLs", "type": "array", "description": "Optional public Jomashop category URLs. The actor tries to detect the Magento category ID from the page. Leave the prefilled watches URL for the main watches catalog.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categoryId": { "title": "Category ID", "type": "string", "description": "Direct Jomashop/Magento category ID. Defaults to 871, the public Watches category, when no ID is found in start URLs.", "default": "871" }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of watch listings to save.", "default": 20 }, "pageSize": { "title": "GraphQL page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Products requested per GraphQL page. Lower values are useful for testing; 50-100 is efficient for larger exports.", "default": 50 }, "includeDetails": { "title": "Fetch product detail descriptions", "type": "boolean", "description": "When enabled, the actor performs one extra GraphQL query per product to collect description/spec text. Disable for fastest price monitoring runs.", "default": 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 } } }, "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 } } } } } } } } } } ```