Fragrantica Scraper: perfume notes, accords, ratings, votes and perfumers

Fragrantica Scraper collects perfumes from fragrantica.com, the largest perfume encyclopedia. Search by keyword, or filter by brand, note, olfactory family, perfumer, gender, launch year and number of votes, or paste perfume and designer links. Each perfume comes back as one clean row: name, brand, launch year, gender, collection, average rating, rating votes and reviews, image, and (by default) the full note pyramid (top, middle, base), the main accords with their strength from 0 to 100, the olfactory family, the perfumers, the description and the perfumes people also like. No account or cookies are needed.

It is used to build fragrance databases and recommendation engines, to compare a brand's line-up, to research which notes and accords are trending in new launches, to feed dupe and "smells like" finders, to enrich e-commerce catalogs with notes and ratings, and as structured data for AI assistants.

At a glance

What	Price
Perfume delivered	US$ 2.00 per 1,000 perfumes (US$ 0.002 each)
Run start	US$ 0.005 per run

• 500 perfumes with notes and accords = US$ 1.005.
• Error rows and duplicates are never charged. maxItems is a hard cap, and a spending limit set on the run stops it cleanly with everything delivered so far.
• With includeDetails off a run returns about 200 perfumes in a few seconds (search fields only).

Quick start

{
  "searchQueries": ["vanilla"],
  "maxItems": 100
}

Highest rated women's perfumes launched since 2015 that contain Tonka Bean and have at least 500 votes:

{
  "notes": ["Tonka Bean"],
  "gender": "female",
  "yearFrom": 2015,
  "minVotes": 500,
  "sortBy": "rating",
  "maxItems": 200
}

Every perfume of a brand, and single perfumes:

{
  "startUrls": [
    "https://www.fragrantica.com/designers/Tom-Ford.html",
    "https://www.fragrantica.com/perfume/Maison-Francis-Kurkdjian/Baccarat-Rouge-540-33519.html"
  ],
  "maxItems": 0
}

Input

Field	What it does
searchQueries	Perfume names, brands or words, one per line. Each keyword is one search.
brands	Only these brands, as the site writes them (Dior, Tom Ford, Maison Francis Kurkdjian).
gender	Any, for women, for men or unisex.
notes	Only perfumes that have all these notes (Tonka Bean, Oud, Bergamot).
olfactoryFamilies	Only these families (Oriental Vanilla, Woody Aromatic, Floral Fruity).
perfumers	Only perfumes signed by these perfumers (Francis Kurkdjian, Alberto Morillas).
yearFrom, yearTo	Launch year range.
minVotes	Minimum number of rating votes.
sortBy	Most popular, highest rated, longest lasting or strongest sillage (the site's own orders).
startUrls	Perfume links, designer pages (every perfume of the brand) or search links from the site.
includeDetails	Note pyramid, accords, perfumers, family, description, similar perfumes (default on; opens each perfume page).
maxItems	Cap for the whole run (default 50; 0 = no cap).
proxyConfiguration	Apify Proxy by default.

searchQuery, keyword, query, brand, designers, ingredients, maxResults, urls and perfumeUrls are accepted too, so inputs written for other Fragrantica tools keep working.

Output

One row per perfume (type: perfume):

Field	What it is
perfumeId, url	Fragrantica perfume id and link
name, brand, collection	Perfume name, brand and the brand's collection (Private Blend...)
year, gender	Launch year; female, male or unisex
rating, ratingCount, reviewsCount	Average rating out of 5, rating votes and English reviews
imageUrl	Bottle image
accords	Main accords with their strength ({"name": "woody", "strength": 100})
mainAccords	The same accords as a plain list, strongest first
topNotes, middleNotes, baseNotes	The note pyramid (empty when the perfume has a flat note list)
notes	Every note of the perfume (the pyramid in order, or the flat list)
olfactoryFamily	Family as the site classifies it (Oriental Woody, Aromatic Fougere...)
perfumers	Perfumers (noses) credited for the perfume
description	The site's description of the perfume
alsoLike	Perfumes that people who like this one also like (name, brand, link)
sourceQuery	Which keyword or link produced this row

Fields from accords to alsoLike come with includeDetails on.

One real row (description and lists shortened):

{
  "type": "perfume",
  "perfumeId": 1826,
  "name": "Oud Wood",
  "brand": "Tom Ford",
  "url": "https://www.fragrantica.com/perfume/Tom-Ford/Oud-Wood-1826.html",
  "year": 2007,
  "gender": "unisex",
  "collection": "Private Blend",
  "rating": 4.28,
  "ratingCount": 17775,
  "reviewsCount": 1879,
  "accords": [{"name": "woody", "strength": 100}, {"name": "warm spicy", "strength": 69}, {"name": "oud", "strength": 69}],
  "mainAccords": ["woody", "warm spicy", "oud", "aromatic", "vanilla", "balsamic", "fresh spicy", "amber"],
  "notes": ["Agarwood (Oud)", "Brazilian Rosewood", "Cardamom", "Sandalwood", "Sichuan Pepper", "Vanilla", "Vetiver", "Tonka Bean", "Amber"],
  "olfactoryFamily": "Oriental Woody",
  "perfumers": ["Richard Herpin"],
  "description": "Oud Wood by Tom Ford is a Oriental Woody fragrance for women and men. Oud Wood was launched in 2007...",
  "alsoLike": [{"name": "Noir Extreme", "brand": "Tom Ford", "url": "https://www.fragrantica.com/perfume/Tom-Ford/Noir-Extreme-29675.html"}]
}

Errors you may see

Every error is a row with errorCode and is never charged:

errorCode	Meaning
INVALID_INPUT	A field has a wrong value (for example an unknown gender or sort)
INVALID_URL	The link is not a Fragrantica perfume, designer or search link
NOT_FOUND	A perfume or designer that does not exist on Fragrantica
NO_RESULTS	No perfume for this keyword and filters (notes, families and perfumers must be spelled as on the site)
NOT_REACHED	The run timeout, the cost guard or maxItems arrived before this link
BLOCKED	The site refused every attempt; run it again in a few minutes

Integrations, scheduling and AI agents

• Schedule a brand or a note search weekly in Apify schedules to catch new launches and follow how ratings and votes move.
• Export as JSON, CSV, Excel or XML, or read the dataset from the Apify API.
• Connect it to Make, n8n, Zapier or Google Sheets through Apify integrations, for example to enrich a shop catalog.
• AI agents: call it as a tool through the Apify MCP server in Claude, ChatGPT, Cursor or any MCP client, for example "find unisex perfumes with oud and vanilla rated above 4 with more than 1,000 votes and group them by family".

FAQ

Do I need a Fragrantica account? No. The Actor uses the site's public search and public perfume pages.

How many perfumes can I get? The site search returns up to 1,000 perfumes per search. For a whole brand use its designer page or the brands filter; to go past 1,000, split by gender, year range or note.

Why is the note pyramid empty for some perfumes? Many perfumes list their notes without top, middle and base levels. Those have the full list in notes and empty pyramid fields.

Why did my note filter return nothing? Notes, families and perfumers must be written as the site shows them: Tonka Bean, Oriental Vanilla, Francis Kurkdjian. Lowercase words are capitalized for you.

Are longevity, sillage and season votes included? No. The site does not publish those in a form that can be read reliably, so they are left out rather than guessed.

Is it legal? The Actor reads public perfume data only. Perfumers appear only as the public name credited on the perfume; no user, review author or member data is returned. You are responsible for how you use the data under the laws that apply to you.

Something broke or a field is missing? Open an issue on the Actor page with the input you used; issues are answered quickly.

Limitations

• Up to 1,000 perfumes per search, a limit of the site's own search.
• Each perfume page is opened at a pace the site accepts, so runs with includeDetails take about 1 to 3 seconds per perfume.
• When the site refuses the default proxy, perfume pages may be skipped: rows then carry the search fields only.

Changelog

• 16 Oct 2026: first version. Keyword, brand, gender, note, family, perfumer, year and votes filters, four sort orders, perfume, designer and search links, note pyramid, accords with strength, perfumers and similar perfumes, free error rows.