Machine Readiness
Stored receipt and evidence
27
90
0
0
0
Samples
No stored offer samples.
Samples
No stored action samples.
Samples
No stored product samples.
Document
# As a condition of accessing this website, you agree to abide by the following # content signals: # (a) If a Content-Signal = yes, you may collect content for the corresponding # use. # (b) If a Content-Signal = no, you may not collect content for the # corresponding use. # (c) If the website operator does not include a Content-Signal for a # corresponding use, the website operator neither grants nor restricts # permission via Content-Signal with respect to the corresponding use. # The content signals and their meanings are: # search: building a search index and providing search results (e.g., returning # hyperlinks and short excerpts from your website's contents). Search does not # include providing AI-generated search summaries. # ai-input: inputting content into one or more AI models (e.g., retrieval # augmented generation, grounding, or other real-time taking of content for # generative AI search answers). # ai-train: training or fine-tuning AI models. # ANY RESTRICTIONS EXPRESSED VIA CONTENT SIGNALS ARE EXPRESS RESERVATIONS OF # RIGHTS UNDER ARTICLE 4 OF THE EUROPEAN UNION DIRECTIVE 2019/790 ON COPYRIGHT # AND RELATED RIGHTS IN THE DIGITAL SINGLE MARKET. # BEGIN Cloudflare Managed content User-agent: * Content-Signal: search=yes,ai-train=no Allow: / User-agent: Amazonbot Disallow: / User-agent: Applebot-Extended Disallow: / User-agent: Bytespider Disallow: / User-agent: CCBot Disallow: / User-agent: ClaudeBot Disallow: / User-agent: CloudflareBrowserRenderingCrawler Disallow: / User-agent: Google-Extended Disallow: / User-agent: GPTBot Disallow: / User-agent: meta-externalagent Disallow: / # END Cloudflare Managed Content User-Agent: Googlebot Allow: / Disallow: /api/ Disallow: /compare/ User-Agent: Bingbot Allow: / Disallow: /api/ Disallow: /compare/ User-Agent: ChatGPT-User Allow: / User-Agent: Claude-Web Allow: / User-Agent: Claude-SearchBot Allow: / User-Agent: PerplexityBot Allow: / User-Agent: Applebot-Extended Allow: / User-Agent: GPTBot Allow: / User-Agent: Google-Extended Allow: / User-Agent: ClaudeBot Allow: / User-Agent: CCBot Allow: / User-Agent: anthropic-ai Allow: / User-Agent: * Allow: / Disallow: /api/ Disallow: /compare/ Host: https://fraganty.ai Sitemap: https://fraganty.ai/sitemap-index.xml
Document
# 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
CORS: Enabled for all origins
Format: JSON
### Open Endpoints (no authentication)
These endpoints are freely accessible without an API key — ideal for AI agents and quick lookups:
- GET /api/search?q=:query — Autocomplete search for perfumes and brands (params: q, limit). Returns perfume names, brands, slugs, images, and buy URLs.
- POST /api/chat — Conversational AI endpoint. Send a JSON body with messages array. The AI assistant can search perfumes, filter by notes/accords/brands, and provide perfume recommendations. Streaming response.
- GET /api/health — Service health check
### Authenticated Endpoints (free API key required)
Request a free API key at api@fraganty.ai.
Pass the key via X-API-Key header or api_key query parameter.
- 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)
### 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
Autocomplete (no key needed):
curl https://fraganty.ai/api/search?q=sauvage&limit=5
### 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 }
Search: { perfumes: [{ name, brand, slug, image, buyUrl }], brands: [{ name, slug }] }
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
## Embeddable Widget
Embed a perfume info card on any website:
https://fraganty.ai/api/widget/:slug
Returns an HTML snippet with perfume image, name, brand, rating, top notes, and a link back.
## AI Agent Access
Fraganty is designed to be accessible by AI agents, LLMs, and automated systems:
- robots.txt allows all major AI crawlers (GPTBot, ClaudeBot, ChatGPT-User, PerplexityBot, etc.)
- /api/search is open without authentication for quick perfume lookups
- /api/chat provides a conversational AI interface with tool-use for perfume search, filtering, and recommendations
- All structured data (notes, accords, ratings, seasons) is available via the REST API
- Every perfume page includes Schema.org Product markup with AggregateRating
For AI agents that need perfume data: use /api/search for quick lookups, or request a free API key at api@fraganty.ai for full database access.
## Machine-Readable Resources
- [llms.txt](https://fraganty.ai/llms.txt): This file — site overview for LLMs
- [llms-full.txt](https://fraganty.ai/llms-full.txt): Extended reference — top 500 perfumes, 200 brands, 100 perfumers, glossary
- [sitemap.xml](https://fraganty.ai/sitemap-index.xml): Full sitemap index (109,425+ URLs)
- [robots.txt](https://fraganty.ai/robots.txt): Crawler permissions (all AI crawlers allowed)
- [API Documentation](https://fraganty.ai/api-docs): Interactive REST API docs
## Contact
hello@fraganty.ai
api@fraganty.ai (API key requests)
Document
Not stored for this site.