Fragrantica Perfume Scraper

Extract structured perfume data from Fragrantica.com — the world's largest fragrance encyclopedia. Returns name, brand, year, perfumers, fragrance pyramid notes, main accords, community ratings, and bottle images, ready for analysis or catalog enrichment.

What It Does

Fragrantica catalogues over 100,000 perfumes with community-rated notes, accords, and demographic data. This actor gets that data out. You give it a list of perfume URLs, brand pages, or both. It returns one clean record per perfume.

Two input modes:

• Direct perfume URLs (startUrls) — fetch specific perfumes by URL
• Designer/brand pages (designerUrls) — scrape all perfumes from a brand, paginated automatically

Output

Each record contains 17 fields:

Field	Type	Description
perfume_id	string	Numeric Fragrantica ID extracted from URL
perfume_url	string	Canonical URL of the perfume detail page
name	string	Perfume name
brand	string	Brand/designer name
year	string	Year of launch
perfumers	string	Comma-separated nose/perfumer names
top_notes	string	Comma-separated top (head) notes
middle_notes	string	Comma-separated middle (heart) notes
base_notes	string	Comma-separated base notes
main_accords	string	Comma-separated main fragrance accords
rating_value	number	Average community rating (0–5)
rating_count	number	Number of community ratings
gender_vote	string	Community gender vote (e.g., "mostly women")
seasons	string	Comma-separated recommended seasons
description	string	Fragrantica editorial/community description
image_url	string	Bottle image URL
scraped_at	string	ISO timestamp when the record was scraped

Example Record

{
  "perfume_id": "611",
  "perfume_url": "https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html",
  "name": "Coco Mademoiselle Chanel for women",
  "brand": "Chanel",
  "year": "2001",
  "perfumers": "Jacques Polge",
  "top_notes": "Orange, Mandarin Orange, Bergamot, Orange Blossom",
  "middle_notes": "Turkish Rose, Jasmine, Mimosa, Ylang-Ylang",
  "base_notes": "Patchouli, White Musk, Vanilla, Vetiver, Tonka Bean, Opoponax",
  "main_accords": null,
  "rating_value": 4.11,
  "rating_count": 32,
  "gender_vote": null,
  "seasons": null,
  "description": "Coco Mademoiselle by Chanel is a Oriental Floral fragrance for women...",
  "image_url": "https://fimgs.net/mdimg/perfume-social-cards/en-social-611.jpeg",
  "scraped_at": "2026-06-06T03:30:31.534Z"
}

Input Parameters

Parameter	Type	Default	Description
startUrls	array	—	Direct perfume page URLs to scrape
designerUrls	array	—	Brand pages to expand into all perfumes
maxItems	integer	10	Maximum perfumes to return

At least one of startUrls or designerUrls is required.

Example: Single Perfume

{
  "startUrls": [
    { "url": "https://www.fragrantica.com/perfume/Chanel/Coco-Mademoiselle-611.html" }
  ],
  "maxItems": 1
}

Example: Full Brand Catalog

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

Use Cases

• Perfume market research — track launch year distribution, brand portfolio size, nose attribution
• E-commerce enrichment — add fragrance pyramid data to product catalogs
• Accord analysis — find perfumes sharing specific note combinations
• Rating aggregation — compare average ratings across brands or note families
• Recommendation engine training — match perfumes by shared notes, accords, and demographic data

Technical Notes

Fragrantica is protected by Cloudflare Turnstile. The actor handles bypass automatically using a residential proxy session — no configuration needed on your end. Notes are extracted from the structured description text, which is more reliable than Fragrantica's client-rendered note pyramid widget.

Pricing

Pay-per-event pricing at $0.002 per perfume record (at the FREE/BRONZE tier). A 100-perfume run costs approximately $0.20, plus a $0.10 platform start fee.