Parfum-Empfehlungs-API: ähnliche Parfums per API finden

Ähnliche-Parfums-API

GET /api/v1/similar?perfume= nimmt den Namen eines Parfums aus dem Index und liefert die Parfums, die ihm am nächsten kommen. Jedes Ergebnis sagt, welche Duftnoten und Akkorde es teilt und wie nah es ist: „very close“ = sehr nah, „similar vibe“ = ähnliche Ausstrahlung, „same spirit“ = gleicher Geist. Gezeigt sind zwei von vierzehn Ergebnissen, gekürzt, vom 21. Oktober 2026.

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

Übergeben Sie house=, wenn ein Name mehrdeutig ist, gender=, um Herren-, Damen- oder Unisex-Parfums zu behalten, other_houses_only=true, um das Parfumhaus des Ausgangsparfums auszuschließen, sowie limit= und cursor= zum Blättern.

Das Ergebnis steuern

steer= verschiebt das Ergebnis in eine Richtung weg vom Ausgangsparfum: fresher, sweeter, darker, lighter, longer_lasting oder more_projection. Die letzten beiden brauchen ein Parfum, das im Index ist. Der Grund in jedem Ergebnis nennt die Richtung.

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

{
  "target": {
    "name": "Aventus",
    "house": "Creed"
  },
  "results": [
    {
      "perfume": {
        "name": "Club de Nuit Intense Man EDT",
        "house": "Armaf",
        "gender": "men",
        "family": "Fruity woody",
        "accords": ["citrus", "fruity", "smoky"]
      },
      "closeness": "very close",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "why": "shares pineapple, bergamot, apple, black currant; fresher than the starting point"
    },
    {
      "perfume": {
        "name": "Club de Nuit Intense Man Parfum",
        "house": "Armaf",
        "gender": "men",
        "family": "Fruity woody",
        "accords": ["fruity", "smoky", "woody"]
      },
      "closeness": "very close",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "why": "shares pineapple, bergamot, apple, black currant; fresher than the starting point"
    }
  ],
  "total": 1989,
  "source": "10ML Fragrance Index"
}

Ähnliche Parfums allein aus Duftnoten

Für ein Parfum, das nicht im Index ist, übergeben Sie statt eines Namens seine notes= und accords=. Das Ergebnis ordnet den Index nach dieser Liste.

curl "https://mcp.10ml.com/api/v1/similar?notes=vanilla,saffron&limit=2"

{
  "target": {
    "name": "your notes",
    "notes": ["vanilla", "saffron"]
  },
  "results": [
    {
      "perfume": {
        "name": "Vanille & Ambre",
        "house": "Berdoues",
        "gender": "unisex",
        "family": "Vanilla amber",
        "accords": ["vanilla", "amber", "sweet"]
      },
      "closeness": "very close",
      "shared_notes": ["vanilla", "saffron"],
      "why": "shares vanilla, saffron"
    },
    {
      "perfume": {
        "name": "Liquid Brun",
        "house": "French Avenue",
        "gender": "unisex",
        "family": "Gourmand spicy",
        "accords": ["warm spicy", "sweet", "vanilla"]
      },
      "closeness": "very close",
      "shared_notes": [],
      "why": "a similar overall profile"
    }
  ],
  "total": 2612,
  "source": "10ML Fragrance Index"
}

Alternativen von anderen Parfumhäusern

GET /api/v1/alternatives?perfume= liefert die Alternativen der Redaktion zu einem berühmten Parfum, immer von anderen Parfumhäusern, jeweils mit dem Grund, warum sie nah dran sind. closeness= behält nur „very close“ = sehr nah, „similar vibe“ = ähnliche Ausstrahlung, „same spirit“ = gleicher Geist.

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

Empfehlungen nach dem Geschmack einer Person

Empfehlungen nach Geschmack sind keine REST-Route: Sie kommen vom Tool recommend_perfumes des MCP-Servers. Es nimmt die Parfums, die eine Person liebt oder nicht mag, die Duftnoten, die sie mag oder meidet, sowie Geschlecht, Jahreszeit, Anlass, Stil und Familie, und nennt zu jeder Empfehlung den Grund. Der MCP-Endpunkt https://mcp.10ml.com/mcp beantwortet auch einen einfachen JSON-RPC-POST, jeder Code kann ihn also aufrufen. Die Antwort unten ist der structuredContent der Antwort, gekürzt.

curl -X POST https://mcp.10ml.com/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"recommend_perfumes","arguments":{"likes":["Dior Sauvage"],"avoided_notes":["patchouli"],"season":"summer","limit":2}}}'

{
  "total": 3916,
  "picks": [
    {
      "perfume": {
        "name": "L'Immensité",
        "house": "Louis Vuitton",
        "gender": "men",
        "family": "Aromatic aquatic",
        "accords": ["fresh", "aquatic", "amber"],
        "key_notes": ["sage", "labdanum", "ambroxan", "amber", "ginger"]
      },
      "why": "shares bergamot, labdanum, ambroxan with Sauvage Eau de Parfum; suits summer"
    },
    {
      "perfume": {
        "name": "Jean Lowe Immortel",
        "house": "Maison Alhambra",
        "gender": "men",
        "family": "Fresh aromatic",
        "accords": ["fresh", "aromatic", "woody"],
        "key_notes": []
      },
      "why": "suits summer"
    }
  ],
  "taste": {
    "liked_perfumes": ["Sauvage Eau de Parfum"],
    "liked_notes": [],
    "avoided_notes": ["patchouli"]
  },
  "source": "10ML Fragrance Index"
}

Ein Assistent macht denselben Aufruf für Sie: Fragen Sie Claude oder ChatGPT „Mein Signature-Duft ist Dior Sauvage, was kommt als Nächstes?“, sobald Sie den Parfum-MCP-Server hinzugefügt haben.

Nach Duftnoten, Jahreszeit und Anlass filtern

GET /api/v1/perfumes listet Parfums nach notes_include, notes_exclude, accords, family, gender, season, occasion und style sowie nach Freitext. Das Beispiel unten behält Parfums, die Bergamotte und Ambroxan zugleich enthalten.

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

Welche Route für welche Frage

Der Index umfasst 5.400+ Parfums und 285 Duftnoten. Die Seite zur Parfum-API dokumentiert jeden Endpunkt, und der Ratgeber zur Fragrantica API Alternative zeigt die übrigen Daten, die Entwickler suchen.

Weiterlesen

• Parfum-API
• Fragrantica API Alternative
• Parfum-MCP-Server
• Was ist ein Parfum-MCP-Server?
• Parfum-MCP-Server im Vergleich

Fragen