# Chopard Scraper (`aboo.script/chopard-scraper`) Actor

Scrape Chopard jewelry and watches from the official store in any market.

- **URL**: https://apify.com/aboo.script/chopard-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Chopard Scraper

![Chopard Scraper](https://i.ibb.co/KpzKY464/chopard-banner.png)

**Chopard Scraper** extracts jewelry, watches and accessories from the official [Chopard](https://www.chopard.com/) online store into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a Chopard category, search or product URL, or type a few keywords, and get the local price and currency, stock status, ring sizes, collection, material, full specifications, descriptions and images for every product. No account or login required.

### Introduction

[Chopard](https://www.chopard.com/) is a Swiss luxury house known for its fine jewelry (Happy Diamonds, Ice Cube, Happy Hearts) and watches (Alpine Eagle, L.U.C, Happy Sport). Its official store covers more than 40 countries, each with its own prices, currency and language, which makes it a reliable source for luxury pricing and product data.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from Chopard?

- 🏷️ Product name, reference number, summary and full description
- 💲 Price, price range for products with sizes, price on request flag, currency and market
- 📦 Stock status and the purchase button shown on the website
- 💍 Ring sizes with their reference, price and availability
- 🗂️ Category, subcategory, collection, gender and material
- ⌚ Watch details: case diameter, water resistance and movement
- 📋 Full specifications as listed on the product page (case and dial, movement, strap, stones, dimensions, perfume notes and more)
- ✨ New, limited edition and boutique exclusive flags
- 🖼️ High resolution images
- 🔗 Direct URL to each product page

### Use Cases

- 📈 **Market research**: compare Chopard prices across countries and currencies, and follow price changes over time.
- 🕵️ **Competitor monitoring**: track new creations, limited editions and stock levels of a leading luxury brand.
- 🛍️ **Retail and resale**: check official retail prices and references when pricing pre-owned jewelry and watches.
- 🗂️ **Database building**: build your own catalog of Chopard jewelry and watches with full specifications and images.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Chopard step by step

1. Paste one or more Chopard URLs into **Start URLs**, or type keywords into **Search queries**.
2. For search queries, choose the **Market** and, if you want, a sort order and a price range.
3. Set **Maximum number of results** to how many products you want per URL or per query.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Chopard URLs to scrape. Supported pages: category pages (for example jewelry, rings or watches), search result pages (with `?q=`) and single product pages. Any filters and sort order you apply on the website (collection, material, price range, availability) are kept in the results. The country, currency and language follow the market part of the URL, for example `/en-us/`, `/fr-fr/` or `/ja-jp/`.
- **Search queries**: keywords to search on Chopard, one per line. Each query is scraped separately.
- **Maximum number of results**: how many products to collect for each start URL or search query. Set 0 for no limit.
- **Market**: the store used for search queries. It sets the prices, currency and language.
- **Sort by**: sort order for search queries (price high to low, name A to Z, name Z to A). Leave empty for the default order.
- **Minimum price** and **Maximum price**: price range for search queries, in the currency of the selected market.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape a category page from Chopard:

```json
{
  "startUrls": [{ "url": "https://www.chopard.com/en-us/jewellery" }],
  "maxResults": 5
}
```

Search by keywords:

```json
{
  "searchQueries": ["ring"],
  "market": "en-us",
  "maxResults": 5
}
```

### Output

Each product is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://www.chopard.com/en-us/ring/%4082A192-1200.html",
  "productId": "@82A192-1200",
  "name": "Happy Diamonds Icons",
  "summary": "Ring, ethical white gold, diamonds",
  "brand": "Chopard",
  "market": "en-us",
  "country": "US",
  "language": "en",
  "currency": "USD",
  "price": 3880,
  "priceFormatted": "$3,880.00",
  "priceMax": 4020,
  "priceMaxFormatted": "$4,020.00",
  "originalPrice": null,
  "originalPriceFormatted": null,
  "priceOnRequest": false,
  "available": true,
  "availability": "In Stock",
  "callToAction": null,
  "isWatch": false,
  "category": "Jewellery",
  "subcategory": "Rings",
  "collection": "Happy Diamonds",
  "gender": "Women",
  "material": "18K ethical white gold",
  "caseDiameter": null,
  "waterResistance": null,
  "movement": null,
  "isNew": true,
  "limitedEdition": false,
  "boutiqueExclusive": false,
  "sizes": [
    { "size": "49", "label": "49 (5)", "variantId": "82A192-1206", "price": 4020, "available": true },
    { "size": "50", "label": "50 (5 ¼)", "variantId": "82A192-1207", "price": 4020, "available": true }
  ],
  "availableSizes": ["49", "50", "51", "52"],
  "specifications": [
    { "group": "Details", "name": "Metal", "value": "18K ethical white gold" },
    { "group": "Details", "name": "White Diamonds Carat", "value": "0.32 ct for size 52" },
    { "group": "General", "name": "Gender", "value": "Women" }
  ],
  "description": "Happy Diamonds jewelry is as unique as it is playful. The happy diamonds are entirely free between two sapphire crystals, thus enabling them to dance ...",
  "mainImage": "https://objects-prod.cdn.chopard.com/ProductsAssets/Web/@82A192-1200_01.png",
  "images": [
    "https://objects-prod.cdn.chopard.com/ProductsAssets/Web/@82A192-1200_01.png",
    "https://objects-prod.cdn.chopard.com/ProductsAssets/Web/@82A192-1200_04.png"
  ]
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Only chopard.com store pages (and chopard.cn for China) are supported. The home page, content pages and other websites are skipped.
- Many high jewelry and complication watches are sold on request: their price is empty and `priceOnRequest` is `true`.
- Products with sizes (rings) show a price range in `price` and `priceMax`, with the price and availability of each size in `sizes`. The purchase button text is empty for them because it depends on the chosen size.
- Some markets, such as International, China and Russia, do not sell online: products there are shown as not available, and the price is the store reference price when one exists.
- Product names, descriptions and specifications are in the language of the market. `category`, `subcategory` and `availability` are always in English.
- Watch fields (case diameter, water resistance, movement) are empty for jewelry and accessories.
- A product found by several start URLs or queries in the same run is saved only once.

### Why use the Chopard Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🌍 **Every market**: more than 40 country stores with local prices, currency and language.
- 🎯 **Keeps your filters**: paste any category or search URL from your browser and get exactly what you see there.
- 🧹 **Clean data**: prices are real numbers, specifications are grouped, and descriptions are plain text.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of products.

#### Do I need a Chopard account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### How do I get prices in another currency?

Use a start URL from the market you want (for example `/en-gb/` for pounds or `/ja-jp/` for yen), or choose the **Market** for search queries.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh prices and stock automatically.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search queries, market, sort order and price range. If you need other filters or inputs, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Chopard](https://www.chopard.com/)

# Actor input Schema

## `startUrls` (type: `array`):

Chopard category pages (filters and sort in the URL are kept), search URLs (with ?q=) or product pages. The country, currency and language follow the market part of the URL, for example /en-us/, /fr-fr/ or /ja-jp/.

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

Keywords to search on Chopard, for example "happy diamonds" or "alpine eagle". Each query is scraped separately.

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

Maximum number of products to scrape per start URL or search query. Set 0 for no limit.

## `market` (type: `string`):

Store market used for search queries. It sets the prices, currency and language. Start URLs use the market in their own URL.

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

Sort order for search queries. Leave empty for the default relevance order.

## `minPrice` (type: `integer`):

Only products with a price from this value, in the currency of the selected market. Applies to search queries.

## `maxPrice` (type: `integer`):

Only products with a price up to this value, in the currency of the selected market. Applies to search queries.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.chopard.com/en-us/jewellery"
    }
  ],
  "searchQueries": [
    "ring"
  ],
  "maxResults": 5,
  "market": "en-us"
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.chopard.com/en-us/jewellery"
        }
    ],
    "searchQueries": [
        "ring"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/chopard-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 = {
    "startUrls": [{ "url": "https://www.chopard.com/en-us/jewellery" }],
    "searchQueries": ["ring"],
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/chopard-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 '{
  "startUrls": [
    {
      "url": "https://www.chopard.com/en-us/jewellery"
    }
  ],
  "searchQueries": [
    "ring"
  ]
}' |
apify call aboo.script/chopard-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/chopard-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/SB5cUHDJcr9sFKe3G/builds/gsOStvF9GLR6lo9m7/openapi.json
