# Flaconi Scraper - German Perfume and Beauty Prices and EAN (`studio-amba/flaconi-scraper`) Actor

Scrape product data from flaconi.de, the German online perfumery. Get EAN barcodes, current and list prices, discounts, stock levels, ratings and review counts for every size of perfume, skincare, makeup and haircare products.

- **URL**: https://apify.com/studio-amba/flaconi-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 result scrapeds

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/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

## Flaconi Scraper

Pull product data from flaconi.de, the German online perfumery. The actor returns one row per size with the EAN barcode, current price, list price, discount, stock level, rating and review count.

Flaconi sells perfume, skincare, makeup, haircare and body care from several thousand brands, including many that are hard to find at the big drugstore chains. Every row carries the EAN, so you can match a Flaconi listing to the same product at Douglas, Notino, Lookfantastic or any other shop.

### How to scrape Flaconi data

There are two ways to tell the actor which products to read.

1. Paste product pages into `productUrls`, for example `https://www.flaconi.de/haare/kerastase/nutritive/kerastase-nutritive-discovery-set-haarpflegeset.html`.
2. Leave `productUrls` empty and fill `urlKeywords`. The actor reads the shop's public product list and keeps products whose address contains one of your words. The address holds the category, the brand and the product name, so `kerastase`, `parfum/dior` or `hypnotic-poison` all work.

The actor stops at `maxResults`. If you leave everything empty, it reads the first 50 products in the product list.

Search result pages, the shop's internal API and any address with a query string are not read. The site's robots.txt does not allow them, so the actor does not request them.

### Input

| Field | Type | Description |
|---|---|---|
| `productUrls` | list of URLs | Flaconi product pages |
| `urlKeywords` | list of words | Used when no URLs are given. Keeps products whose address contains one of the words |
| `maxResults` | number | Maximum number of rows (default 50) |
| `brightDataApiKey` | secret text | Optional. Falls back to the actor's own key when empty |
| `brightDataZone` | text | Optional. Name of the Bright Data Web Unlocker zone, default `web_unlocker1` |

A product with three sizes gives three rows, because each size has its own EAN and price.

### What you get back

| Field | Description |
|---|---|
| `productId` | Product group ID, shared by all sizes of one product |
| `sku` | Variant number, also the value after `?variant=` in `url` |
| `ean` | EAN/GTIN-13 barcode of this size |
| `name` | Product name including size |
| `brand` | Brand name |
| `variant` | Size, for example `50 ml` or `1 Stk` |
| `price` | Current selling price in EUR |
| `originalPrice` | List price, only when the product is on sale |
| `discountPercent` | Percent below the list price |
| `onSale` | Whether the site marks this size as on sale |
| `currency` | ISO currency code (EUR) |
| `inStock` | Whether this size is in stock |
| `stockAmount` | Units in stock as shown by the shop |
| `rating` | Average review score out of 5 |
| `reviewCount` | Number of reviews on the product |
| `category` | Product category such as Parfum, Haare or Pflege |
| `imageUrl` | Main product image |
| `url` | Product page address for this size |
| `scrapedAt` | Time of the read |
| `country`, `language` | `de`, `de` |

Rating and review count belong to the whole product, so all sizes of one product share them. Products without reviews have empty rating fields.

### Example output

```json
{
  "productId": "90004838-C",
  "sku": "90004838-0007305",
  "ean": "3474637215620",
  "name": "Kérastase Nutritive Discovery Set Haarpflegeset 1 Stk",
  "brand": "Kérastase",
  "variant": "1 Stk",
  "price": 31.69,
  "originalPrice": 52,
  "discountPercent": 39,
  "onSale": true,
  "currency": "EUR",
  "inStock": true,
  "stockAmount": 810,
  "rating": 4.62,
  "reviewCount": 167,
  "category": "Haare",
  "imageUrl": "https://cdn.flaconi.net/media/catalog/product/3/4/3474637215620_c_live.jpeg",
  "url": "https://www.flaconi.de/haare/kerastase/nutritive/kerastase-nutritive-discovery-set-haarpflegeset.html?variant=90004838-0007305",
  "scrapedAt": "2026-10-29T20:34:17.773Z",
  "country": "de",
  "language": "de"
}
```

### Use cases

- Compare Flaconi prices to other shops by EAN.
- Track list price and discount percent on a brand over time.
- Check which sizes of a brand are in stock and how many units are left.
- Build a product catalogue with barcodes, images and ratings.
- Monitor review counts and ratings for your own brand.

### Cost and speed

The actor reads one product page per product, about 1.4 MB each, with three requests at the same time. Twenty products take about one minute. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

The shop is protected by a Cloudflare challenge, so the actor reaches it through Bright Data Web Unlocker. That cost is part of the per-result price.

### Notes and limits

- Prices are in EUR for the German storefront. Other country storefronts are not covered.
- The product list on the site has about 30,000 pages. A keyword filter reads only the matching ones.
- A keyword that matches only a few products returns fewer rows than `maxResults`.
- `originalPrice` comes from the shop's own list price field. It is empty when the shop shows no discount.
- Some pages do not show product data, such as discontinued products. These are skipped and logged.
- The actor reads publicly visible pages only. It does not log in and does not use cookies.
- You are responsible for how you use the data. Check Flaconi's terms and the rules that apply to your use case. We are not responsible for restrictions the source website imposes.

### Frequently asked questions

#### Does it return EAN barcodes?

Yes. The `ean` field holds the barcode of each size, taken from the product page.

#### Can I search by keyword?

Yes, with `urlKeywords`. The actor filters the product list by address, which holds the category, brand and product name. It does not use the site's search page, because the site's robots.txt does not allow it.

#### Why are there more rows than products?

Each size is its own row, because each has its own EAN and price.

#### Can I scrape a whole brand?

Put the brand into `urlKeywords`, for example `dior`. Raise `maxResults` to the number of rows you need.

#### How often can I run it?

As often as you like. Daily runs on a fixed list of product pages give a clean price history.

#### Why is a rating empty?

The product has no reviews yet.

### Related scrapers

- [Notino Scraper](https://apify.com/studio-amba/notino-scraper) for Notino beauty prices
- [Douglas DE Scraper](https://apify.com/studio-amba/douglas-de-scraper) for Douglas Germany
- [Lookfantastic Scraper](https://apify.com/studio-amba/lookfantastic-scraper) for Lookfantastic UK
- [Sephora Scraper](https://apify.com/studio-amba/sephora-scraper) for Sephora France and Spain
- [dm Scraper](https://apify.com/studio-amba/dm-scraper) for dm drugstore products

# Actor input Schema

## `productUrls` (type: `array`):

Product pages from flaconi.de, e.g. https://www.flaconi.de/haare/kerastase/nutritive/kerastase-nutritive-discovery-set-haarpflegeset.html. Each size of a product becomes one row.

## `urlKeywords` (type: `array`):

Used when no product URLs are given. The actor reads the shop's product list and keeps products whose address contains one of these words, e.g. kerastase or hypnotic-poison. Brand and category are part of the address. Leave empty to read the first products in the list.

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

Maximum number of rows (one row per size).

## `brightDataApiKey` (type: `string`):

Bright Data API key used to reach flaconi.de. Falls back to the actor's own BRIGHT_DATA_API_KEY environment variable if left empty.

## `brightDataZone` (type: `string`):

Name of the Bright Data Web Unlocker zone. Default is web_unlocker1.

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

Not used. This actor reaches Flaconi through Bright Data Web Unlocker. Kept for input-shape compatibility.

## Actor input object example

```json
{
  "urlKeywords": [
    "kerastase"
  ],
  "maxResults": 20,
  "brightDataZone": "web_unlocker1",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 = {
    "urlKeywords": [
        "kerastase"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/flaconi-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 = {
    "urlKeywords": ["kerastase"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/flaconi-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 '{
  "urlKeywords": [
    "kerastase"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/flaconi-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/flaconi-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/TYjLISRQJcfXdnQwk/builds/GFyOuUyBPxNycgdV7/openapi.json
