Kostenlose Parfum-API und Duft-API

Auf einen Blick

Preis

Kostenlos

Registrierung

Keine. Kein API-Key, kein Konto

Protokolle

MCP (Streamable HTTP) und REST, beschrieben in OpenAPI 3.1

Abdeckung

5.400+ Parfums, 249 Parfumhäuser, 285 erklärte Duftnoten

Profile

Duftpyramide (Kopf-, Herz- und Basisnoten), Akkorde, Duftfamilie, Jahreszeiten und Anlässe; 481 vollständige redaktionelle Profile ergänzen Haltbarkeit, Projektion und Parfümeure

Schnittstelle

15 Read-only-Tools mit Output-Schemas, 6 Prompts, Ressourcen und Completions

Sprachen

10: Englisch, Deutsch, Französisch, Spanisch, Italienisch, Rumänisch, Griechisch, Ungarisch, Tschechisch und Polnisch

Gelistet in

der offiziellen MCP Registry, Claudes Konnektor-Verzeichnis, npm und PyPI

Datenschutz

Keine Cookies, kein Tracking, kein Anfrageverlauf

REST-API: Schnellstart

Einfache GET-Anfragen, JSON zurück, offenes CORS, kein Key. Dieselben Antworten wie die MCP-Tools. Ein Parfum nachschlagen:

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"])

Antwort (ohne Links):

{
  "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"
}

Endpunkte

Acht Read-only-GET-Routen unter https://mcp.10ml.com/api/v1. Listen werden mit limit und cursor paginiert; locale schaltet die Links auf 10ml.com auf eine andere Sprache um. Echte, gekürzte Antworten vom 21. Oktober 2026.

Beispielanfragen und Antworten

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"
}

Vollständiges Schema: https://mcp.10ml.com/openapi.json

Duftnoten-API

Die Duftnoten-API hat zwei Routen. GET /api/v1/notes/{note} erklärt jede der 285 Duftnoten im Index, in vielen Schreibweisen und Sprachen (Bergamotte findet bergamot). GET /api/v1/perfumes?notes_include= listet die Parfums, die um eine oder mehrere Duftnoten gebaut sind, die präsenteste zuerst, und notes_exclude lässt Duftnoten weg. Ein Parfum-Abruf mit format=detailed liefert seine Duftpyramide: Kopf, Herz und Basis.

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"
}

Parfum-Ähnlichkeits-API

Die Parfum-Ähnlichkeits-API ordnet Parfums nach gemeinsamen Noten, Akkorden und Stil und sagt, was jedes teilt und wie nah es ist: „very close“ = sehr nah, „similar vibe“ = ähnliche Ausstrahlung, „same spirit“ = gleicher Geist. GET /api/v1/similar?perfume= geht von einem Parfum im Index aus oder von Duftnoten und Akkorden, die Sie für jeden anderen Duft mitgeben; steer verschiebt das Ergebnis in Richtung fresher, sweeter, darker, lighter, longer_lasting oder more_projection. GET /api/v1/alternatives?perfume= liefert die Alternativen der Redaktion zu einem berühmten Parfum, immer von anderen Parfumhäusern.

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"
}

Im Vergleich mit anderen Parfum-APIs

Was jeder Dienst auf seiner eigenen Website angibt, gelesen am 21. Oktober 2026.

Die Größen sind die Zahlen, die jeder Dienst für sich selbst nennt, und wurden von 10ML nicht geprüft; bei 10ML ist es die Größe des eigenen Index. Tarife und Limits ändern sich, prüfen Sie den Dienst also, bevor Sie darauf bauen.

Aus einem MCP-Client nutzen

Derselbe Index ist auch ein Remote-MCP-Server für Assistenten. Die Adresse ist in jedem Client dieselbe: https://mcp.10ml.com/mcp

• Claude (claude.ai und Claude Desktop)

  Öffnen Sie „Customize“, dann „Connectors“, und fügen Sie 10ML Perfume Finder aus dem Verzeichnis hinzu, oder wählen Sie „+ Add“, dann „Add custom connector“, und fügen Sie die URL ein.

  In Claudes Verzeichnis öffnen

• Claude Code

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

• ChatGPT

  Öffnen Sie im Web in ChatGPT „Plugins“, wählen Sie die Plus-Schaltfläche, dann „Add custom MCP server“: Name 10ML Perfume Finder, URL einfügen, keine Authentifizierung.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose und Zed nehmen dieselbe Adresse. Die Parfum-MCP-Server-Seite hat die Ein-Klick-Installationen und jeden Client.

Beispielfragen

Echte Antworten aus dem 10ML Fragrance Index, 20. und 21. Oktober 2026.

• Wie riecht Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 von Maison Francis Kurkdjian (2015, Eau de Parfum, unisex) ist ein blumiger Amber-Duft: ein leuchtender, luftiger Amber mit einer zuckrigen, fast zuckerwatteartigen Süße über mineralischen Hölzern. Kopf: Safran und Jasmin. Herz: Amberholz und Ambra. Basis: Tannenharz und Zeder. Am besten im Herbst, Winter und Frühling, für Abende und Dates.

• Was riecht wie Creed Aventus?

  find_similar_perfumes

  Am nächsten kommt Armaf Club de Nuit Intense Man Parfum („very close“ = sehr nah: teilt Ananas, Bergamotte, Apfel und schwarze Johannisbeere). Armaf Club de Nuit Intense Man EDT und Nishane Hacivat haben dieselbe Ausstrahlung; Hacivat über Ananas, Bergamotte, Jasmin und Patschuli.

• Wie riecht Bergamotte, und was passt dazu?

  explain_note

  Bergamotte ist eine Zitrusnote: spritzig, leicht blumig, mit einer grünen, teeartigen Bitterkeit. Sie passt zu Lavendel, Vetiver, Neroli, schwarzem Pfeffer, Moschus und Zeder.

Limits und Fair Use

Die Nutzung ist kostenlos, ohne API-Key, Konto oder Kontingent, und jeder Endpunkt ist read-only. Es kann ein Fair-Use-Rate-Limit gelten (siehe Nutzungsbedingungen); halten Sie bei Massenabfragen also ein moderates Tempo ein und cachen Sie, was Sie abrufen: REST-Antworten werden mit einem Cache-Header für fünf Minuten ausgeliefert. Listen sind mit limit und cursor paginiert. Keine Cookies, kein Tracking, kein Anfrageverlauf.

NutzungsbedingungenDatenschutz

Quellenangabe

Sie zeigen die Daten in einer App, auf einer Website oder in einem Artikel? Nennen Sie als Quelle den 10ML Fragrance Index mit einem Link auf diese Seite, und zitieren Sie den Server als 10ML Perfume Finder.

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

Im Vergleich

In unserem Benchmark mit 40 Fragen (20. Oktober 2026) unter den Parfum-MCP-Servern, die ohne Key antworten, erreichte 10ML Perfume Finder 39 von 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 bei eingehaltenem Rate-Limit und Parfica 7. Größere Indizes liegen bei der Breite vorn: ScentVerdict nennt 31.000+ Parfums, Perfume Picks 13.000+ und ScentRev 126.000+, gegenüber 5.406 im 10ML Fragrance Index. ScentRev, Noteboxd, Fragella und Fraganty verlangen einen Key oder eine Anmeldung und konnten nicht bewertet werden.

Alle Ergebnisse und die Methode

Ratgeber

• Was ist ein Parfum-MCP-Server?
• Claude Parfum-Connector
• ChatGPT Parfum-App
• Fragrantica API Alternative
• Parfum-Empfehlungs-API

Fragen