# Diptyque Scraper (`aboo.script/diptyqueparis-scraper`) Actor

⚡ Fast Diptyque scraper. No login, no API key. Get official candles, perfumes, home and body products by keyword, collection, search or product URL in 41 markets with local prices, sizes, SKUs, barcodes, stock, key notes, olfactive family and images. Perfect for luxury price monitoring.

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

## Pricing

from $2.80 / 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

## Diptyque Scraper

![Diptyque Scraper](https://i.ibb.co/bjrPGtc7/diptyqueparis-banner.png)

**Diptyque Scraper** extracts official product data from [Diptyque](https://www.diptyqueparis.com/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a Diptyque collection, search or product URL, or type a few keywords, and get the name, price and currency, size, SKU, barcode, stock status, key notes, olfactive family and images of every product. No account or login required.

### Introduction

[Diptyque](https://www.diptyqueparis.com/) is the Parisian luxury house known for its scented candles, eaux de parfum, home fragrances and body care. It sells through separate online stores for the United States, the United Kingdom, Canada, Japan, Hong Kong and more than 30 European and international markets, each with its own prices and currency.

This Diptyque scraper collects the same public information you see in your browser and turns it into a ready-to-use dataset. Use it to track Diptyque prices across markets, monitor new launches and limited editions, or build a fragrance product catalog. Run it once, schedule it daily, or connect it to your own tools.

### What data can you extract from Diptyque?

- 🏷️ Product name, scent line, product type and brand
- 🔢 Product ID, SKU and barcode (EAN)
- 💲 Price as shown on the site, numeric price, compare-at price and currency
- 🌍 Market and country of the store
- 📦 Stock status (in stock or out of stock)
- 📏 Size of the product and links to every other size of the same scent
- 🌸 Key notes, olfactive family, main scent and burning time (candles)
- 🏅 Badges such as Best-seller, New or Limited edition
- 📝 Short and long description, plus story, commitments, directions for use and ingredients
- 🧩 Variants with SKU, barcode, price, availability and weight
- 🖼️ Main image and full image gallery
- 🗓️ Publication and creation dates
- 🔗 Direct URL of each product

### Use Cases

- 📈 **Price monitoring**: compare Diptyque prices and currencies between the US, UK, Europe, Japan, Hong Kong and Canada.
- 🕵️ **Competitor and brand research**: follow new launches, limited editions and best-sellers in fragrances and candles.
- 🛒 **Retail and resale**: match products by SKU or barcode and keep your catalog up to date.
- 🗂️ **Product catalog building**: build a complete Diptyque database with notes, sizes, ingredients and images.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Diptyque step by step

1. Paste one or more Diptyque URLs into **Start URLs**, or type keywords into **Search queries**.
2. If you use search queries, choose the **Market** whose prices and language you want.
3. Set **Max 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**: Diptyque URLs to scrape. Supported pages: a store home page (for example `https://us.diptyqueparis.com/en-us`, the whole catalog), collection pages (`https://us.diptyqueparis.com/en-us/collections/eaux-de-parfum`), search pages (`https://us.diptyqueparis.com/en-us/search?q=baies`) and single product pages. The store and market in the URL (us., uk., ams., jp., hk. or diptyqueparis.com with /en-eu, /fr-fr, /de-de, ...) set the language, prices and currency.
- **Search queries**: keywords to search in the Diptyque catalog, one per line. A product matches when every word appears in its name, type, tags or description. Each query is scraped separately.
- **Market**: the store market (language and country) used for search queries, for example United States, United Kingdom, France, Japan or Norway. Start URLs always use the market in the URL.
- **Max results**: how many products to collect for each start URL or search query. Use 0 for no limit.

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

### Input Examples

Scrape a collection page from Diptyque:

```json
{
  "startUrls": [{ "url": "https://us.diptyqueparis.com/en-us/collections/eaux-de-parfum" }],
  "maxResults": 5
}
```

Search by keywords in the US store:

```json
{
  "searchQueries": ["candle"],
  "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://us.diptyqueparis.com/en-us/products/eau-de-parfum-orpheon-orphp75c",
  "productId": "10330435322170",
  "handle": "eau-de-parfum-orpheon-orphp75c",
  "sku": "ORPHP75C",
  "barcode": "3700431426321",
  "name": "Orphéon - Eau de parfum",
  "line": "Orphéon",
  "productType": "Eau de parfum",
  "brand": "Diptyque",
  "market": "en-us",
  "country": "US",
  "price": "US $260",
  "priceNumeric": 260,
  "priceMax": null,
  "compareAtPrice": null,
  "currency": "USD",
  "available": true,
  "availability": "In Stock",
  "size": "75 ml",
  "sizes": [
    {
      "size": "75 ml",
      "url": "https://us.diptyqueparis.com/en-us/products/eau-de-parfum-orpheon-orphp75c",
      "selected": true
    },
    {
      "size": "200 ml",
      "url": "https://us.diptyqueparis.com/en-us/products/eau-de-parfum-exceptional-format-orpheon-largeedpor",
      "selected": false
    }
  ],
  "keyNotes": ["Juniper berry", "Cedar", "Tonka bean", "Jasmine"],
  "attributes": [
    { "name": "Olfactive family", "value": "Woody" },
    { "name": "Main scent", "value": "Juniper berry" }
  ],
  "badges": ["Best-seller"],
  "description": "At the heart of this composition are the warmth of tonka bean, the depth of cedar, the richness of jasmine and the vivacity of juniper berries.",
  "longDescription": "An olfactory portrait of a legendary bar where the founders of Diptyque loved to get toget...",
  "information": [
    {
      "title": "Story",
      "text": "Orphéon, a smoky portrait of a blooming creative friendship in a bygone Parisian..."
    },
    {
      "title": "Commitments",
      "text": "Made in France All of our fragrances are made in France. Refillable bottle Our i..."
    },
    {
      "title": "Ingredients",
      "text": "alcohol denat. (sd alcohol 40-b) - parfum (fragrance) - aqua (water) - benzyl sa..."
    }
  ],
  "variants": [
    {
      "variantId": "53612651970874",
      "title": null,
      "sku": "ORPHP75C",
      "barcode": "3700431426321",
      "price": 260,
      "compareAtPrice": null,
      "available": true,
      "weightGrams": 381
    }
  ],
  "image": "https://cdn.shopify.com/s/files/1/0991/4784/1850/files/diptyque-orpheon-eau-de-parfum-75ml-orphp75c-1.jpg?v=1781571350",
  "images": [
    "https://cdn.shopify.com/s/files/1/0991/4784/1850/files/diptyque-orpheon-eau-de-parfum-75ml-orphp75c-1.jpg?v=1781571350",
    "https://cdn.shopify.com/s/files/1/0991/4784/1850/files/diptyque-orpheon-eau-de-parfum-75ml-orphp75c-2.jpg?v=1781571349"
  ],
  "tags": ["Parfum"],
  "publishedAt": "2026-06-19T12:03:11.000Z",
  "createdAt": "2026-06-16T07:23:48.000Z"
}
```

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

### Notes

- Collection pages are scraped in the store's default order. Filters and sorting chosen on a collection page are not applied yet.
- Category landing pages (URLs with `/pages/`), store locator, gift finder and scent finder pages are not supported and are skipped. Open the collection behind them ("See all") and use that URL instead.
- Each size of a scent is a separate product on Diptyque. The `sizes` field lists every size with its link, so you can scrape them all.
- Text follows the language of the market (for example French on /fr-fr, Japanese on jp.diptyqueparis.com), and attribute names such as "Olfactive family" are translated too.
- Old addresses like `https://www.diptyqueparis.com/en_us/` are accepted and open the matching store home page.
- "Set to compose" gift boxes show a price of 0 because their price depends on the products you put inside.
- Some products have no key notes, badges or size, so those fields are returned empty or as `null`.

### Why use the Diptyque Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🌍 **Every Diptyque market**: US, UK, Canada, Japan, Hong Kong and more than 30 European and international markets, each with local prices and currency.
- 🌸 **Fragrance details included**: key notes, olfactive family, burning time, ingredients and all sizes, not only the price.
- 🧹 **Clean data**: numbers are real numbers, dates use one standard format, and text is free of HTML.
- 💸 **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 products can I scrape?

You can set any number in **Max results**, or 0 for no limit. A store home page URL returns the whole catalog of that market.

#### Do I need a Diptyque 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 URL from the market you want (for example `https://uk.diptyqueparis.com/en-uk/...` for GBP or `https://diptyqueparis.com/en-no/...` for NOK), or pick that market in **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 and a market for searches. If you need other filters, such as collection filters, price range or olfactive family, 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 to scrape other fragrance platforms?

- [Fragrantica Scraper](https://apify.com/aboo.script/fragrantica-scraper): perfumes with notes, accords, ratings and longevity.
- [Fragrantica Reviews Scraper](https://apify.com/aboo.script/fragrantica-reviews-scraper): user reviews of perfumes.
- [Fragrantica Notes Scraper](https://apify.com/aboo.script/fragrantica-notes-scraper): fragrance notes and their descriptions.
- [Fragrantica Perfumers Scraper](https://apify.com/aboo.script/fragrantica-perfumers-scraper): perfumer profiles and their creations.
- [Fragrantica Designers Scraper](https://apify.com/aboo.script/fragrantica-designers-scraper): perfume brands and their collections.

***

**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: [Diptyque](https://www.diptyqueparis.com/)

# Actor input Schema

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

Diptyque home (e.g. https://us.diptyqueparis.com/en-us for the whole catalog), collection (https://us.diptyqueparis.com/en-us/collections/eaux-de-parfum), search (https://us.diptyqueparis.com/en-us/search?q=baies) or product URLs. The store and market in the URL (us., uk., jp., hk., ams. or diptyqueparis.com with /en-eu, /fr-fr, ...) set the language, prices and currency.

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

Keywords to search in the Diptyque catalog (e.g. baies, candle, eau de parfum). A product matches when every word is in its name, type, tags or description. Each query is scraped separately in the selected market.

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

Store market (language and country) used for search queries. Start URLs always use the market in the URL.

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

Maximum number of products to scrape per start URL or search query. Use 0 for unlimited.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://us.diptyqueparis.com/en-us/collections/eaux-de-parfum"
    }
  ],
  "searchQueries": [
    "candle"
  ],
  "market": "en-us",
  "maxResults": 5
}
```

# 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://us.diptyqueparis.com/en-us/collections/eaux-de-parfum"
        }
    ],
    "searchQueries": [
        "candle"
    ],
    "maxResults": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/diptyqueparis-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://us.diptyqueparis.com/en-us/collections/eaux-de-parfum" }],
    "searchQueries": ["candle"],
    "maxResults": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/diptyqueparis-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://us.diptyqueparis.com/en-us/collections/eaux-de-parfum"
    }
  ],
  "searchQueries": [
    "candle"
  ],
  "maxResults": 5
}' |
apify call aboo.script/diptyqueparis-scraper --silent --output-dataset

```

## MCP server setup

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