# Perfumes Club Scraper - Spanish Perfume and Beauty Prices, EAN (`studio-amba/perfumesclub-scraper`) Actor

Scrape product data from perfumesclub.com, the Spanish online perfume, cosmetics and parapharmacy shop. Get prices in EUR, recommended price, EAN, brand, size, category, rating, review count and stock status for every size variant.

- **URL**: https://apify.com/studio-amba/perfumesclub-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 $1.20 / 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.
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

## Perfumes Club Scraper

Pull product data from perfumesclub.com, a Spanish online shop for perfume, cosmetics and parapharmacy. The actor returns one row per product size with the EAN barcode, the selling price in EUR, the recommended price, the discount, category, rating, review count and stock status.

Perfumes Club sells fragrance, skincare, make-up, hair care and sun care from several thousand brands. If you track Spanish beauty prices or match Spanish products against shops in other countries by EAN, this actor gives you a repeatable feed.

### How to scrape Perfumes Club data

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

1. Paste product pages into `productUrls`, for example `https://www.perfumesclub.com/es/nivea/nivea-sol-leche-f30/p_00000001001/`.
2. Leave `productUrls` empty and fill `urlKeywords` with brand names or words from the product address, for example `nivea` or `la-roche-posay`. The actor reads the matching products from the public product sitemap.
3. Leave both empty. The actor reads the first products from the sitemap.

The actor stops at `maxResults`. If you leave everything empty, it reads the first 50 rows.

A product page lists several sizes. Each size has its own EAN and price, so each size becomes one row.

Search result pages are not read. The actor requests product pages and sitemaps, and it stays away from the paths that robots.txt excludes. Requests are spaced out at about one per second.

### Input

| Field | Type | Description |
|---|---|---|
| `productUrls` | list of text | Product pages from perfumesclub.com. Up to 100. |
| `urlKeywords` | list of text | Brand names or address words. Used when `productUrls` is empty. |
| `maxResults` | number | Maximum number of rows. Default 50. |
| `proxyConfiguration` | object | Proxy for the requests. Default is Apify Proxy. |

Example input:

```json
{
    "urlKeywords": ["nivea"],
    "maxResults": 100
}
```

### Output

Each row is one product size. Example:

```json
{
    "productId": "153963",
    "sku": "153963-100ml",
    "ean": "0000042419655",
    "name": "SUN PROTEGE & HIDRATA leche solar SPF30",
    "size": "100 ml",
    "brand": "Nivea",
    "category": "Protector solar corporal",
    "price": 6.79,
    "originalPrice": 8.75,
    "discountPercent": 22.4,
    "currency": "EUR",
    "rating": 4.17,
    "reviewCount": 6,
    "inStock": true,
    "availability": "InStock",
    "imageUrl": "https://i1.perfumesclub.com/grande/153963.jpg",
    "url": "https://www.perfumesclub.com/es/nivea/nivea-sol-leche-f30/p_00000001001/",
    "country": "es",
    "language": "es"
}
```

| Field | Description |
|---|---|
| `productId`, `sku` | Perfumes Club article number of the size, and the same number with the size. |
| `ean` | EAN or GTIN barcode as published by the shop. |
| `name`, `size`, `brand`, `category` | Product name, content of the size, brand and category. |
| `price` | Selling price in EUR, VAT included. |
| `originalPrice`, `discountPercent` | Recommended price and the percentage between the two. Empty when the selling price is not lower. |
| `rating`, `reviewCount` | Average rating out of 5 and number of reviews. |
| `inStock`, `availability` | Stock status as published. |
| `imageUrl`, `url` | Image of the size and product page. |

### What the data does not contain

Seller names, delivery times and unit prices per 100 ml are not in the output.

### Pricing

The actor is billed per result. You pay for each row that is returned, and a run that returns nothing costs only the Apify platform usage.

### Tips

- Use `urlKeywords` with a brand name to read one brand. The brand is part of every product address.
- Use the `ean` field to match products against other shops, in Spain or in other countries. Some EANs carry leading zeros, as the shop publishes them.
- Schedule the actor daily or weekly to build a price history.
- Pages that carry no structured product data are skipped without a row and counted in the run log.
- The cost of a run settles after the run SUCCEEDED, so the usage figure on a running job is not final.
- A keyword that matches no product ends the run with a message saying no products matched.

### Is it legal to scrape Perfumes Club?

The actor reads public product pages that anyone can open without logging in. It collects product information only, no personal data. Check your own use of the data against the site terms and the laws that apply to you.

### FAQ

**Does it need a login?** No.

**How many products does the site have?** The product sitemap lists about 24,000 addresses, and most of them carry two or three sizes.

**Does it return prices in other currencies?** No. Prices are in euro.

**Which fields are always filled?** Name, price, currency, URL, product ID, SKU, brand, availability and EAN.

**What is the difference between price and originalPrice?** `price` is the selling price. `originalPrice` is the recommended price the shop shows, when it is higher.

**Can I get a whole brand?** Yes. Set `urlKeywords` to the brand and `maxResults` to a high number. The run reads one page per product.

**Why do two rows share a URL?** One page holds several sizes. Each size has its own SKU and EAN.

### Support

Open an issue on the actor page if a field is missing or a product is read wrong.

# Actor input Schema

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

Product pages from perfumesclub.com, for example https://www.perfumesclub.com/es/nivea/nivea-sol-leche-f30/p_00000001001/. Each size of a product becomes one row.

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

Used when no product URLs are given. The actor reads the shop sitemap and keeps products whose address contains one of these words, for example nivea or la-roche-posay. Leave empty to read the first products in the sitemap.

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

Maximum number of rows (one row per product size).

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

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "urlKeywords": [
    "nivea"
  ],
  "maxResults": 20,
  "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": [
        "nivea"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

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

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

```

## MCP server setup

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