API parfémů zdarma a API vůní

Ve zkratce

Cena

Zdarma

Registrace

Žádná. Bez API klíče, bez účtu

Protokoly

MCP (Streamable HTTP) a REST, popsané v OpenAPI 3.1

Rozsah

Přes 5 400 parfémů, 249 domů, 285 vysvětlených not

Profily

Pyramida not (hlavová, srdeční a základní), akordy, vonná rodina, roční období a příležitosti; 481 úplných redakčních profilů navíc uvádí trvanlivost, projekci a parfuméry

Rozhraní

15 nástrojů jen pro čtení s výstupními schématy, 6 promptů, zdroje a doplňování

Jazyky

10: angličtina, němčina, francouzština, španělština, italština, rumunština, řečtina, maďarština, čeština a polština

Dostupné v

oficiálním MCP Registry, adresáři konektorů Claude, npm a PyPI

Soukromí

Žádné cookies, žádné sledování, žádná historie požadavků

REST API: rychlý start

Obyčejné požadavky GET, odpověď v JSON, otevřené CORS, bez klíče. Stejné odpovědi jako nástroje MCP. Vyhledání jednoho parfému:

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

Odpověď (odkazy vynechány):

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

Endpointy

Osm tras GET jen pro čtení pod https://mcp.10ml.com/api/v1. Seznamy se stránkují pomocí limit a cursor; locale přepne odkazy na 10ml.com do jiného jazyka. Skutečné odpovědi, zkrácené, z 21. října 2026.

Ukázkové požadavky a odpovědi

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

Úplné schéma: https://mcp.10ml.com/openapi.json

API vonných not

API vonných not má dvě trasy. GET /api/v1/notes/{note} vysvětlí kteroukoli z 285 not v indexu, v mnoha pravopisech a jazycích (Bergamotte najde bergamot). GET /api/v1/perfumes?notes_include= vypíše parfémy postavené na jedné či více notách, od nejvýraznější, a notes_exclude noty vynechá. Vyhledání parfému s format=detailed vrátí jeho pyramidu not: hlavovou, srdeční a základní.

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 podobnosti parfémů

API podobnosti parfémů řadí parfémy podle sdílených not, akordů a stylu a uvádí, co který sdílí a jak je blízký: „very close“ = velmi blízký, „similar vibe“ = podobný ráz, „same spirit“ = stejný duch. GET /api/v1/similar?perfume= vychází z parfému v indexu, nebo z not a akordů, které předáte pro jinou vůni; steer posune výsledek k svěžejšímu, sladšímu, tmavšímu, lehčímu, trvanlivějšímu nebo s výraznější projekcí (fresher, sweeter, darker, lighter, longer_lasting, more_projection). GET /api/v1/alternatives?perfume= vrací alternativy ke slavnému parfému, které sestavují redaktoři, vždy z jiných domů.

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

Srovnání s dalšími API parfémů

Co každá služba uvádí na svém webu, přečteno 21. října 2026.

Rozsahy jsou čísla, která o sobě služby uvádějí samy a 10ML je neověřovalo; u 10ML jde o velikost jeho vlastního indexu. Plány a limity se mění, proto si službu před nasazením ověřte.

Použití z klienta MCP

Stejný index je také vzdálený MCP server pro asistenty. Adresa je v každém klientovi stejná: https://mcp.10ml.com/mcp

• Claude (claude.ai a Claude Desktop)

  Otevřete „Customize“, poté „Connectors“ a přidejte 10ML Perfume Finder z adresáře, nebo zvolte „+ Add“, poté „Add custom connector“ a vložte adresu URL.

  Otevřít v adresáři Claude

• Claude Code

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

• ChatGPT

  Na webu otevřete v ChatGPT „Plugins“, klepněte na tlačítko plus a zvolte „Add custom MCP server“: pojmenujte ho 10ML Perfume Finder, vložte adresu URL a zvolte bez ověřování.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose a Zed přijímají stejnou adresu. Stránka MCP serveru parfémů nabízí instalace jedním kliknutím a všechny klienty.

Příklady otázek

Skutečné odpovědi z 10ML Fragrance Index, 20. a 21. října 2026.

• Jak voní Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 od Maison Francis Kurkdjian (2015, parfémovaná voda, unisex) je ambrová květinová vůně: zářivá, vzdušná ambra s cukrově sladkým nádechem připomínajícím cukrovou vatu nad minerálními dřevy. Hlava: šafrán a jasmín. Srdce: amberwood a šedá ambra. Základ: jedlová pryskyřice a cedr. Nejlépe na podzim, v zimě a na jaře, na večery a rande.

• Co voní jako Creed Aventus?

  find_similar_perfumes

  Nejblíže je Armaf Club de Nuit Intense Man Parfum („very close“ = velmi blízký: sdílí ananas, bergamot, jablko a černý rybíz). Armaf Club de Nuit Intense Man EDT a Nishane Hacivat mají podobný ráz; Hacivat díky ananasu, bergamotu, jasmínu a pačuli.

• Jak voní bergamot a co se k němu hodí?

  explain_note

  Bergamot je citrusová nota: jiskrný, lehce květinový citrus se zelenou, čajovou hořkostí. Hodí se k levanduli, vetiveru, neroli, černému pepři, pižmu a cedru.

Limity a spravedlivé použití

Je zdarma, bez API klíče, účtu či kvóty, kterou by bylo třeba hlídat, a každý endpoint je jen pro čtení. Může platit omezení četnosti požadavků v rámci spravedlivého použití (viz podmínky), proto hromadné úlohy spouštějte v rozumném tempu a stažená data ukládejte do mezipaměti: odpovědi REST nesou hlavičku s pětiminutovou mezipamětí. Seznamy se stránkují pomocí limit a cursor. Žádné cookies, žádné sledování, žádná historie požadavků.

PodmínkySoukromí

Uvedení zdroje

Zobrazujete data v aplikaci, na webu nebo v článku? Uveďte je jako 10ML Fragrance Index s odkazem na tuto stránku a server jako 10ML Perfume Finder.

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

Jak si stojí

V našem srovnání se 40 otázkami (20. října 2026) u MCP serverů parfémů, které odpovídají bez klíče, získal 10ML Perfume Finder 39 z 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 při dodržení jeho limitu a Parfica 7. Větší indexy vedou v rozsahu: ScentVerdict uvádí přes 31 000 parfémů, Perfume Picks přes 13 000 a ScentRev přes 126 000, oproti 5 406 v 10ML Fragrance Index. ScentRev, Noteboxd, Fragella a Fraganty vyžadují klíč nebo přihlášení a nešlo je hodnotit.

Úplné výsledky a metodika

Otázky