# Fragrantica Perfume Scraper (`crawlerbros/fragrantica-scraper`) Actor

Extract perfume data from Fragrantica.com like name, brand, year, perfumer, fragrance pyramid (top/middle/base notes), main accords, ratings, and reviews. No proxy required.

- **URL**: https://apify.com/crawlerbros/fragrantica-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Other, E-commerce, Developer tools
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 11 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

## Fragrantica Perfume Scraper

Extract perfume data from **Fragrantica.com** — the world's largest perfume database. Returns name, brand, year, perfumer, full fragrance pyramid (top/middle/base notes), main accords, and aggregated ratings.

### Features

- **17 output fields** per perfume — flat schema with typed defaults (zero nulls)
- **Two input modes** — direct perfume URLs, or designer pages (auto-expanded)
- **Full fragrance pyramid** — top notes, middle/heart notes, base notes
- **Main accords** with rankings
- **Ratings** — average value + total count
- **Perfumer (nose) names** extracted from the description
- **Launch year**
- **Gender classification** (for women / for men / unisex)
- **DataDome bypass** via curl_cffi Chrome 131 + RESIDENTIAL/US proxy (hardcoded, applied automatically). Sessions rotate on failure.

### Input

| Field | Type | Description |
|---|---|---|
| `perfumeUrls` | Array | Direct perfume URLs (e.g., `https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html`) |
| `designerUrls` | Array | Designer/brand pages (e.g., `https://www.fragrantica.com/designers/Chanel.html`) — automatically expanded to all perfumes from that brand |
| `maxItems` | Integer | Maximum perfumes to return (default 20, max 500) |

#### Example Input

Single perfume:
```json
{
    "perfumeUrls": [
        "https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html"
    ],
    "maxItems": 1
}
````

Brand catalog:

```json
{
    "designerUrls": [
        "https://www.fragrantica.com/designers/Tom-Ford.html"
    ],
    "maxItems": 50
}
```

### Output

Each perfume has **17 fields**. All fields are always present — empty strings, zero, or empty array as typed defaults, never `null`.

#### Identity

| Field | Type | Description |
|---|---|---|
| `id` | Integer | Fragrantica perfume ID |
| `url` | String | Perfume page URL |
| `name` | String | Perfume name |
| `brand` | String | Brand / designer |
| `fullName` | String | Full title (Name + Brand + gender) |
| `gender` | String | `for women`, `for men`, or `for women and men` |
| `year` | Integer | Launch year |

#### Composition

| Field | Type | Description |
|---|---|---|
| `perfumers` | Array | Perfumer / nose names |
| `topNotes` | Array | Top notes |
| `middleNotes` | Array | Middle / heart notes |
| `baseNotes` | Array | Base notes |
| `allNotes` | Array | All notes combined |
| `mainAccords` | Array | Main accord names (e.g., `floral`, `woody`, `citrus`) |

#### Ratings & Media

| Field | Type | Description |
|---|---|---|
| `ratingValue` | Number | Average user rating (1-5 scale) |
| `ratingCount` | Integer | Total number of ratings |
| `imageUrl` | String | Cover image URL |

#### Metadata

| Field | Type | Description |
|---|---|---|
| `scrapedAt` | String | ISO 8601 scrape timestamp |

### FAQ

**Q: Do I need a proxy?**
No configuration needed — a US residential proxy is hardcoded and applied automatically. Fragrantica is fronted by DataDome which blocks Apify datacenter IPs with `403`. The scraper combines RESIDENTIAL/US traffic with curl\_cffi Chrome 131 TLS impersonation, with automatic session rotation on each failed attempt (up to 5 retries per URL).

**Q: How do I find a designer URL?**
The format is `https://www.fragrantica.com/designers/{Brand-Name}.html` (e.g., `Chanel.html`, `Tom-Ford.html`, `Dior.html`). Spaces become hyphens.

**Q: How many perfumes per brand?**
Major brands like Chanel and Dior have 150-300 perfumes. The scraper expands the designer page and scrapes up to `maxItems` perfumes.

**Q: How fresh is the data?**
Fragrantica updates ratings and reviews continuously — new data is reflected within hours.

### Use Cases

- **Perfume market research** — track new launches by brand or accord
- **E-commerce enrichment** — pull perfume metadata for product catalogs
- **Accord analysis** — find perfumes with specific note combinations
- **Rating aggregation** — compare brands by average ratings
- **Recommendation systems** — match perfumes by shared notes / perfumers

# Actor input Schema

## `perfumeUrls` (type: `array`):

Direct Fragrantica perfume URLs (e.g., https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html).

## `designerUrls` (type: `array`):

Designer/brand pages to expand (e.g., https://www.fragrantica.com/designers/Chanel.html). All perfumes from each designer will be scraped.

## `maxItems` (type: `integer`):

Maximum number of perfumes to return.

## Actor input object example

```json
{
  "perfumeUrls": [
    "https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html"
  ],
  "maxItems": 3
}
```

# Actor output Schema

## `perfumes` (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 = {
    "perfumeUrls": [
        "https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html"
    ],
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/fragrantica-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 = {
    "perfumeUrls": ["https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html"],
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/fragrantica-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 '{
  "perfumeUrls": [
    "https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html"
  ],
  "maxItems": 3
}' |
apify call crawlerbros/fragrantica-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/fragrantica-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Fragrantica Perfume Scraper",
        "description": "Extract perfume data from Fragrantica.com like name, brand, year, perfumer, fragrance pyramid (top/middle/base notes), main accords, ratings, and reviews. No proxy required.",
        "version": "1.0",
        "x-build-id": "SoVfRmSTZqCXieh5o"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~fragrantica-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-fragrantica-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/crawlerbros~fragrantica-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-fragrantica-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/crawlerbros~fragrantica-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-fragrantica-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": {
                    "perfumeUrls": {
                        "title": "Perfume URLs",
                        "type": "array",
                        "description": "Direct Fragrantica perfume URLs (e.g., https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "designerUrls": {
                        "title": "Designer URLs",
                        "type": "array",
                        "description": "Designer/brand pages to expand (e.g., https://www.fragrantica.com/designers/Chanel.html). All perfumes from each designer will be scraped.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of perfumes to return.",
                        "default": 20
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```