# Fraganty.ai

> The open encyclopedic fragrance database. 109,425 perfumes, 7,444 brands, 2,612 perfumers, and 2,565 fragrance notes — freely accessible via website and API.

## About

Fraganty is the most comprehensive open fragrance database. Every perfume entry includes olfactory notes (top, heart, base) with intensity, accords with strength percentages, community ratings and vote distributions, seasonal and day/night recommendations, similar perfume suggestions, and perfumer credits.

## Website Sections

- [Home](https://fraganty.ai/): Search and browse 109,425 perfumes
- [Explore](https://fraganty.ai/explore): Browse all perfumes with filters
- [Brands](https://fraganty.ai/brands): 7,444 fragrance brands directory
- [Perfumers](https://fraganty.ai/perfumers): 2,612 perfumer profiles with their creations
- [Notes](https://fraganty.ai/notes): 2,565 fragrance notes and ingredients encyclopedia
- [About](https://fraganty.ai/about): About Fraganty, data sources, contact
- [API Documentation](https://fraganty.ai/api-docs): Full REST API documentation
- [Tools](https://fraganty.ai/tools): Free perfume tools — comparison, recommendations, embeddable widgets, API access
- [Insights](https://fraganty.ai/insights): Fragrance industry data insights and statistics
- [Reviews](https://fraganty.ai/reviews): 9,758 editorial perfume reviews with notes, accords, community sentiment analysis
- [Dupes & Alternatives](https://fraganty.ai/dupes): Find affordable alternatives to luxury perfumes

## Languages

Fraganty is available in 19 languages. The default language is English (no URL prefix).
Non-English locales use a URL prefix: /{locale}/

Available locales:
- English (en): https://fraganty.ai/ (default, no prefix)
- Deutsch (de): https://fraganty.ai/de/
- Español (es): https://fraganty.ai/es/
- Français (fr): https://fraganty.ai/fr/
- Čeština (cs): https://fraganty.ai/cs/
- Italiano (it): https://fraganty.ai/it/
- Русский (ru): https://fraganty.ai/ru/
- Polski (pl): https://fraganty.ai/pl/
- Português (pt): https://fraganty.ai/pt/
- Ελληνικά (el): https://fraganty.ai/el/
- 汉语 (zh): https://fraganty.ai/zh/
- 日本語 (ja): https://fraganty.ai/ja/
- Nederlands (nl): https://fraganty.ai/nl/
- Srpski (sr): https://fraganty.ai/sr/
- Română (ro): https://fraganty.ai/ro/
- العربية (ar): https://fraganty.ai/ar/
- Українська (uk): https://fraganty.ai/uk/
- Монгол (mn): https://fraganty.ai/mn/
- עברית (he): https://fraganty.ai/he/

## REST API

Base URL: https://fraganty.ai/api
Authentication: API key required (free). Request yours at api@fraganty.ai
  Include via X-API-Key header or api_key query parameter.
CORS: Enabled for all origins
Format: JSON

### Endpoints

- GET /api/perfumes — Search and list perfumes (params: q, brand, page, limit)
- GET /api/perfumes/:slug — Full perfume details including notes, accords, rating, seasons, similar perfumes
- GET /api/perfumes/:slug/insights — Community insights for a perfume
- GET /api/brands — List all brands with perfume counts (params: q)
- GET /api/notes — List all fragrance notes with frequency counts (params: limit)
- GET /api/perfumers — List all perfumers with perfume counts
- GET /api/perfumers/:slug — Perfumer details with paginated perfumes (params: page, limit)

### Authentication

All API endpoints require a free API key. Request one at api@fraganty.ai.
Pass the key in either:
  - Header: X-API-Key: YOUR_KEY
  - Query parameter: ?api_key=YOUR_KEY

### Example Queries

Search for rose perfumes:
  curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/perfumes?q=rose&limit=5

Get full details for a perfume:
  curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/perfumes/bleu-de-chanel-eau-de-parfum

List top brands:
  curl -H "X-API-Key: YOUR_KEY" https://fraganty.ai/api/brands

### Response Format

Perfume list: { data: [...], total, page, pages }
Perfume detail: { id, name, brand, year, concentration, gender, description, notes: { top, middle, base }, accords, seasons, dayNight, rating, ratingDistribution, similarPerfumes, perfumers }
Brands: { data: [{ name, slug, count }] }
Notes: { data: [{ name, count }] }
Perfumers: { data: [{ name, slug, count }] }

## Data Structure

Each perfume contains:
- Identification: name, brand, year, concentration (EDP/EDT/Parfum/Cologne), gender
- Olfactory pyramid: top notes, heart notes, base notes — each with intensity percentage
- Accords: named scent categories with strength (0-100) and color
- Community ratings: 1-5 scale with vote distribution (love/like/ok/dislike/hate)
- Recommendations: season suitability (winter/spring/summer/fall %) and day/night preference
- Relationships: similar perfumes, same-brand suggestions, perfumer credits
- Media: product image URL

## Dupes & Affordable Alternatives
Fraganty provides algorithmically-ranked affordable alternatives for luxury/premium perfumes.
Scoring: accord cosine similarity (40%), note Jaccard overlap (30%), curated similar perfume data (20%), rating proximity (10%).
Price tiers: luxury, premium, mid-range, budget.
URLs: /dupes-for/{slug}, /dupes/brand/{brand-slug}

## Browse by Year
Explore perfumes by release year or decade.
URLs: /perfumes-from (hub), /perfumes-from/{year}, /perfumes-from/decade/{decade}s

## Browse by Concentration
Filter perfumes by concentration type.
URL: /concentration/{type} (eau-de-parfum, eau-de-toilette, parfum, cologne, elixir, extrait, eau-fraiche)

## Accord + Gender Combinations
Find perfumes by scent profile and gender.
URL: /best-perfumes-for/{accord}-{gender} (e.g. woody-men, floral-women, fresh-unisex)

## Note + Gender Filtering
Filter note-based perfume lists by gender.
URL: /notes/{note-name}/{gender} (e.g. /notes/vanilla/men, /notes/rose/women)

## Rankings
- [Top Rated](https://fraganty.ai/top-rated): Highest rated perfumes (min 100 votes)
- [Most Popular](https://fraganty.ai/most-popular): Most voted perfumes

## Machine-Readable Resources

- [llms.txt](https://fraganty.ai/llms.txt): This file
- [sitemap.xml](https://fraganty.ai/sitemap-index.xml): Full sitemap index
- [robots.txt](https://fraganty.ai/robots.txt): Crawler permissions
- [API](https://fraganty.ai/api/perfumes): REST API (JSON)

## Contact

hello@fraganty.ai