Δωρεάν API αρωμάτων

Με μια ματιά

Τιμή

Δωρεάν

Εγγραφή

Καμία. Χωρίς API key, χωρίς λογαριασμό

Πρωτόκολλα

MCP (Streamable HTTP) και REST, περιγραφή σε OpenAPI 3.1

Κάλυψη

5.400+ αρώματα, 249 οίκοι, 285 νότες με επεξήγηση

Προφίλ

Πυραμίδα νοτών (κορυφής, καρδιάς και βάσης), συγχορδίες, οικογένεια, εποχές και περιστάσεις· 481 πλήρη συντακτικά προφίλ προσθέτουν διάρκεια, εκπομπή και δημιουργούς αρωμάτων

Διεπαφή

15 εργαλεία μόνο για ανάγνωση με output schemas, 6 prompts, resources και completions

Γλώσσες

10: αγγλικά, γερμανικά, γαλλικά, ισπανικά, ιταλικά, ρουμανικά, ελληνικά, ουγγρικά, τσεχικά και πολωνικά

Διαθέσιμο σε

το επίσημο MCP Registry, τον κατάλογο συνδέσεων του Claude, το npm και το PyPI

Απόρρητο

Χωρίς cookies, χωρίς tracking, χωρίς ιστορικό αιτημάτων

REST API: γρήγορη εκκίνηση

Απλά αιτήματα GET, απάντηση σε JSON, ανοιχτό CORS, χωρίς κλειδί. Οι ίδιες απαντήσεις με τα εργαλεία MCP. Αναζητήστε ένα άρωμα:

curl "https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed"

const res = await fetch("https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed");
const { perfume } = await res.json();
console.log(perfume.name, perfume.pyramid);

import requests

r = requests.get(
    "https://mcp.10ml.com/api/v1/perfumes/Baccarat Rouge 540",
    params={"format": "detailed"},
    timeout=10,
)
perfume = r.json()["perfume"]
print(perfume["name"], perfume["pyramid"])

Απάντηση (χωρίς τους συνδέσμους):

{
  "found": true,
  "exact": true,
  "perfume": {
    "id": "maison-francis-kurkdjian-baccarat-rouge-540-edp",
    "name": "Baccarat Rouge 540",
    "house": "Maison Francis Kurkdjian",
    "year": 2015,
    "gender": "unisex",
    "family": "Amber floral",
    "accords": ["amber", "woody", "sweet", "floral", "musky"],
    "key_notes": ["amberwood", "ambergris", "fir resin", "cedar", "saffron"],
    "character": "A glowing, airy amber with a sugared, almost cotton-candy sweetness over mineral woods. Instantly recognisable and famously long-lasting.",
    "concentration": "EDP",
    "pyramid": {
      "top": ["saffron", "jasmine"],
      "heart": ["amberwood", "ambergris"],
      "base": ["fir resin", "cedar"]
    },
    "seasons": ["autumn", "winter", "spring"],
    "occasions": ["evening", "date night", "special occasion"],
    "longevity": 5,
    "projection": 5,
    "perfumers": ["Francis Kurkdjian"]
  },
  "source": "10ML Fragrance Index"
}

Endpoints

Οκτώ διαδρομές GET μόνο για ανάγνωση στο https://mcp.10ml.com/api/v1. Οι λίστες σελιδοποιούνται με limit και cursor· το locale αλλάζει τους συνδέσμους του 10ml.com σε άλλη γλώσσα. Πραγματικές απαντήσεις, περικομμένες, από τις 21 Οκτωβρίου 2026.

Παραδείγματα αιτημάτων και απαντήσεων

curl "https://mcp.10ml.com/api/v1/perfumes?q=fresh%20citrus%20summer%20cologne&limit=2"

{
  "total": 626,
  "results": [
    {
      "id": "paris-corner-ciao-citrus",
      "name": "Ciao Citrus",
      "house": "Paris Corner",
      "gender": "unisex",
      "family": "Citrus floral",
      "accords": ["citrus", "fresh", "white floral"],
      "key_notes": ["orange blossom", "lily of the valley", "musk", "sandalwood", "grapefruit"],
      "character": "Grapefruit and bergamot over orange blossom and lily of the valley, drying to musk, sandalwood and amber.",
      "profile": "core"
    },
    {
      "id": "maison-crivelli-citrus-batikanga-edp",
      "name": "Citrus Batikanga",
      "house": "Maison Crivelli",
      "gender": "unisex",
      "family": "Citrus spicy",
      "accords": ["citrus", "fresh", "spicy"],
      "key_notes": ["citrus", "bergamot"],
      "character": "Bitter orange, kalamansi and bergamot are pressed fresh, then a pinch of chili and a vetiver-cedar base keep it lively.",
      "profile": "core"
    }
  ],
  "filters": {
    "season": "summer"
  },
  "relaxed": false,
  "source": "10ML Fragrance Index"
}

curl "https://mcp.10ml.com/api/v1/houses?type=middle-eastern&limit=2"

{
  "total": 25,
  "houses": [
    {
      "id": "lattafa",
      "name": "Lattafa",
      "country": "United Arab Emirates",
      "type": "middle-eastern",
      "founded": 1992,
      "perfumes_in_index": 200,
      "known_for": ["Khamrah", "Yara", "Asad", "Fakhar"]
    },
    {
      "id": "al-haramain",
      "name": "Al Haramain",
      "country": "Saudi Arabia",
      "type": "middle-eastern",
      "perfumes_in_index": 159,
      "known_for": ["Amber Oud Gold Edition", "L'Aventure", "Detour Noir", "Amber Oud Ruby"]
    }
  ],
  "source": "10ML Fragrance Index"
}

curl "https://mcp.10ml.com/api/v1/houses/Lattafa"

{
  "found": true,
  "house": {
    "id": "lattafa",
    "name": "Lattafa",
    "country": "United Arab Emirates",
    "type": "middle-eastern",
    "founded": 1992,
    "perfumes_in_index": 200,
    "known_for": ["Khamrah", "Yara", "Asad", "Fakhar"],
    "style": "One of the biggest Gulf houses, offering sweet, rich perfumes.",
    "aliases": ["Lattafa Perfumes"]
  },
  "signature_perfumes": [
    {
      "name": "Khamrah",
      "house": "Lattafa",
      "family": "Amber gourmand"
    },
    {
      "name": "Bade'e Al Oud Oud for Glory",
      "house": "Lattafa",
      "family": "Oud"
    }
  ],
  "source": "10ML Fragrance Index"
}

curl "https://mcp.10ml.com/api/v1/guides?q=layering&limit=1"

{
  "total": 1,
  "guides": [
    {
      "title": "Perfume layering guide: rules and pairings",
      "type": "how-to",
      "topics": ["layering"],
      "url": "https://10ml.com/guides/perfume-layering-guide?utm_source=mcp&utm_medium=ai-assistant&utm_campaign=search_guides",
      "translated": true
    }
  ],
  "source": "10ML Fragrance Index"
}

Πλήρες σχήμα: https://mcp.10ml.com/openapi.json

API νοτών αρωμάτων

Το API νοτών αρωμάτων έχει δύο διαδρομές. Το GET /api/v1/notes/{note} εξηγεί οποιαδήποτε από τις 285 νότες του index, σε πολλές γραφές και γλώσσες (το Bergamotte βρίσκει το bergamot). Το GET /api/v1/perfumes?notes_include= παραθέτει τα αρώματα που βασίζονται σε μία ή περισσότερες νότες, με πρώτα τα πιο έντονα, και το notes_exclude αφήνει νότες εκτός. Η αναζήτηση ενός αρώματος με format=detailed επιστρέφει την πυραμίδα νοτών: κορυφής, καρδιάς και βάσης.

curl "https://mcp.10ml.com/api/v1/notes/bergamot"

{
  "found": true,
  "note": {
    "id": "bergamot",
    "name": "bergamot",
    "family": "citrus",
    "origin": "natural",
    "smells_like": "Sparkling, slightly floral citrus with a green, tea-like bitterness.",
    "mood": "bright, polished, uplifting",
    "also_called": ["bergamotto", "Bergamotte", "bergamote", "bergamota", "bergamotă"],
    "pairs_with": ["lavender", "vetiver", "neroli", "black pepper", "musk", "cedar"],
    "similar_notes": ["lemon", "orange", "bitter orange", "mandarin", "tangerine"]
  },
  "famous_perfumes": [
    {
      "name": "Aventus",
      "house": "Creed",
      "family": "Chypre fruity"
    },
    {
      "name": "Silver Mountain Water",
      "house": "Creed",
      "family": "Fresh green"
    }
  ],
  "source": "10ML Fragrance Index"
}

curl "https://mcp.10ml.com/api/v1/perfumes?notes_include=bergamot,ambroxan&limit=2"

{
  "total": 90,
  "results": [
    {
      "name": "Imagination",
      "house": "Louis Vuitton",
      "family": "Citrus woody",
      "key_notes": ["ginger", "cinnamon", "amberwood", "ambroxan", "citron"]
    },
    {
      "name": "L'Immensité",
      "house": "Louis Vuitton",
      "family": "Aromatic aquatic",
      "key_notes": ["sage", "labdanum", "ambroxan", "amber", "ginger"]
    }
  ],
  "filters": {
    "notes_include": "bergamot, ambroxan"
  },
  "relaxed": false,
  "source": "10ML Fragrance Index"
}

API ομοιότητας αρωμάτων

Το API ομοιότητας αρωμάτων κατατάσσει τα αρώματα με βάση κοινές νότες, συγχορδίες και στυλ, και λέει τι μοιράζεται το καθένα και πόσο κοντά είναι: very close, similar vibe ή same spirit. Το GET /api/v1/similar?perfume= ξεκινά από ένα άρωμα του index ή από νότες και συγχορδίες που δίνετε για οποιοδήποτε άλλο άρωμα· το steer κατευθύνει το αποτέλεσμα προς fresher, sweeter, darker, lighter, longer_lasting ή more_projection. Το GET /api/v1/alternatives?perfume= επιστρέφει τις εναλλακτικές των συντακτών σε ένα διάσημο άρωμα, πάντα από άλλους οίκους.

curl "https://mcp.10ml.com/api/v1/similar?perfume=Creed+Aventus&limit=2"

{
  "results": [
    {
      "perfume": {
        "name": "Club de Nuit Intense Man Parfum",
        "house": "Armaf",
        "family": "Fruity woody"
      },
      "closeness": "very close",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "shared_accords": ["fruity", "woody", "smoky", "fresh"],
      "why": "shares pineapple, bergamot, apple, black currant"
    },
    {
      "perfume": {
        "name": "Club de Nuit Intense Man EDT",
        "house": "Armaf",
        "family": "Fruity woody"
      },
      "closeness": "similar vibe",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "shared_accords": ["fruity", "woody", "smoky", "musky"],
      "why": "shares pineapple, bergamot, apple, black currant"
    }
  ],
  "total": 14,
  "source": "10ML Fragrance Index"
}

curl "https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus&limit=2"

{
  "total": 5,
  "original": {
    "name": "Creed Aventus",
    "id": "creed-aventus-edp"
  },
  "alternatives": [
    {
      "name": "Armaf Club de Nuit Intense Man",
      "closeness": "very close",
      "why": "Pineapple, lemon, birch smoke and musk make it smell similar, a popular alternative at a different weight.",
      "id": "armaf-club-de-nuit-intense-man-parfum",
      "house": "Armaf",
      "source": "editors"
    },
    {
      "name": "Al Haramain L'Aventure",
      "closeness": "very close",
      "why": "Fruity-smoky opening over woods and musk follows the same blueprint.",
      "id": "al-haramain-laventure",
      "house": "Al Haramain",
      "source": "editors"
    }
  ],
  "source": "10ML Fragrance Index"
}

Σύγκριση με άλλα API αρωμάτων

Όσα δηλώνει κάθε υπηρεσία στον δικό της ιστότοπο, όπως διαβάστηκαν στις 21 Οκτωβρίου 2026.

Τα μεγέθη είναι οι αριθμοί που δηλώνει κάθε υπηρεσία για τον εαυτό της και δεν ελέγχθηκαν από το 10ML· για το 10ML είναι το μέγεθος του δικού του index. Τα πλάνα και τα όρια αλλάζουν, οπότε ελέγξτε την υπηρεσία πριν χτίσετε.

Χρήση από πελάτη MCP

Το ίδιο index λειτουργεί και ως απομακρυσμένος MCP server για βοηθούς. Η διεύθυνση είναι ίδια σε κάθε πελάτη: https://mcp.10ml.com/mcp

• Claude (claude.ai και Claude Desktop)

  Ανοίξτε «Customize», έπειτα «Connectors», και προσθέστε το 10ML Perfume Finder από τον κατάλογο, ή επιλέξτε «+ Add», έπειτα «Add custom connector», και επικολλήστε το URL.

  Άνοιγμα στον κατάλογο του Claude

• Claude Code

  claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp

• ChatGPT

  Στο web, ανοίξτε «Plugins» στο ChatGPT, πατήστε το κουμπί συν και επιλέξτε «Add custom MCP server»: ονομάστε το 10ML Perfume Finder, επικολλήστε το URL και επιλέξτε No authentication (χωρίς ταυτοποίηση).

Τα Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose και Zed δέχονται την ίδια διεύθυνση. Η σελίδα του MCP server αρωμάτων έχει τις εγκαταστάσεις με ένα κλικ και κάθε πελάτη.

Παραδείγματα ερωτήσεων

Πραγματικές απαντήσεις από το 10ML Fragrance Index, 20 και 21 Οκτωβρίου 2026.

• Τι μυρίζει το Baccarat Rouge 540;

  get_perfume

  Το Baccarat Rouge 540 της Maison Francis Kurkdjian (2015, eau de parfum, unisex) είναι ένα ανθικό άρωμα με κεχριμπάρι: λαμπερό και αέρινο, με ζαχαρένια γλύκα, σχεδόν σαν μαλλί της γριάς, πάνω από ορυκτά ξύλα. Κορυφή: σαφράν και γιασεμί. Καρδιά: amberwood και ambergris. Βάση: ρητίνη ελάτου και κέδρος. Ιδανικό για φθινόπωρο, χειμώνα και άνοιξη, για βραδινές εξόδους και ραντεβού.

• Τι μοιάζει με το Creed Aventus;

  find_similar_perfumes

  Πιο κοντινό είναι το Armaf Club de Nuit Intense Man Parfum (πολύ κοντινό: μοιράζεται ανανά, περγαμόντο, μήλο και μαύρο φραγκοστάφυλο). Το Armaf Club de Nuit Intense Man EDT και το Nishane Hacivat έχουν την ίδια αίσθηση· το Hacivat μέσω ανανά, περγαμόντου, γιασεμιού και πατσουλί.

• Τι μυρίζει το περγαμόντο και με τι ταιριάζει;

  explain_note

  Το περγαμόντο είναι νότα εσπεριδοειδούς: αφρώδες, ελαφρώς ανθικό εσπεριδοειδές με πράσινη, τσαγερή πικράδα. Ταιριάζει με λεβάντα, βετιβέρ, νερολί, μαύρο πιπέρι, μόσχο και κέδρο.

Όρια και δίκαιη χρήση

Είναι δωρεάν, χωρίς API key, λογαριασμό ή quota να διαχειριστείτε, και κάθε endpoint είναι μόνο για ανάγνωση. Μπορεί να ισχύει περιορισμός ρυθμού δίκαιης χρήσης (δείτε τους όρους), οπότε κρατήστε τις μαζικές εργασίες σε ευγενικό ρυθμό και αποθηκεύστε προσωρινά (cache) όσα ανακτάτε: οι απαντήσεις REST έχουν header cache πέντε λεπτών. Οι λίστες σελιδοποιούνται με limit και cursor. Χωρίς cookies, χωρίς tracking, χωρίς ιστορικό αιτημάτων.

ΌροιΑπόρρητο

Αναφορά πηγής

Εμφανίζετε τα δεδομένα σε εφαρμογή, ιστότοπο ή άρθρο; Αναφέρετε το 10ML Fragrance Index με σύνδεσμο προς αυτή τη σελίδα και τον server ως 10ML Perfume Finder.

Perfume data: <a href="https://10ml.com/perfume-api">10ML Fragrance Index</a>

Πώς συγκρίνεται

Στη δοκιμή μας με 40 ερωτήσεις (20 Οκτωβρίου 2026) στους MCP server αρωμάτων που απαντούν χωρίς κλειδί, το 10ML Perfume Finder πέτυχε 39 στις 40, το ScentVerdict 36, το Parfum Bible 33, το Perfume Picks 32 όταν τηρήθηκε το όριο ρυθμού του και το Parfica 7. Τα μεγαλύτερα index προηγούνται σε εύρος: το ScentVerdict δηλώνει 31.000+ αρώματα, το Perfume Picks 13.000+ και το ScentRev 126.000+, έναντι 5.406 στο 10ML Fragrance Index. Τα ScentRev, Noteboxd, Fragella και Fraganty απαιτούν κλειδί ή σύνδεση και δεν βαθμολογήθηκαν.

Πλήρη αποτελέσματα και μέθοδος

Ερωτήσεις