Ingyenes parfüm API és illat API

Dióhéjban

Ár

Ingyenes

Regisztráció

Nincs. Nem kell API-kulcs, sem fiók

Protokollok

MCP (Streamable HTTP) és REST, OpenAPI 3.1 leírással

Lefedettség

5 400+ parfüm, 249 ház, 285 magyarázott illatjegy

Profilok

Illatpiramis (fej-, szív- és alapjegyek), akkordok, illatcsalád, évszakok és alkalmak; 481 teljes szerkesztői profil tartósságot, kisugárzást és parfümőröket is ad

Felület

15 csak olvasható tool kimeneti sémával, 6 prompt, erőforrások és kiegészítések

Nyelvek

10: angol, német, francia, spanyol, olasz, román, görög, magyar, cseh és lengyel

Listázva itt

a hivatalos MCP Registry, a Claude csatlakozókönyvtára, az npm és a PyPI

Adatvédelem

Nincsenek sütik, nincs követés, nincs kérési előzmény

REST API gyorsindító

Sima GET-kérések, JSON válasz, nyitott CORS, kulcs nélkül. Ugyanazok a válaszok, mint az MCP tooloknál. Egy parfüm lekérdezése:

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

Válasz (a linkek nélkül):

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

Végpontok

Nyolc csak olvasható GET útvonal a https://mcp.10ml.com/api/v1 alatt. A listák a limit és a cursor paraméterrel lapozhatók; a locale átváltja a 10ml.com linkeket egy másik nyelvre. Valódi, megrövidített válaszok, 2026. október 21-éről.

Példakérések és válaszok

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

Teljes séma: https://mcp.10ml.com/openapi.json

Illatjegy API

Az illatjegy API-nak két útvonala van. A GET /api/v1/notes/{note} az index bármelyik 285 illatjegyét elmagyarázza, sokféle írásmóddal és nyelven (a Bergamotte megtalálja a bergamottot). A GET /api/v1/perfumes?notes_include= az egy vagy több illatjegy köré épülő parfümöket listázza, a legmarkánsabbal kezdve, a notes_exclude pedig kihagy illatjegyeket. A format=detailed paraméterű parfümlekérdezés az illatpiramist adja: fej-, szív- és alapjegyek.

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

Parfümhasonlósági API

A parfümhasonlósági API közös illatjegyek, akkordok és stílus szerint rangsorolja a parfümöket, és megmondja, mi közös bennük és mennyire közel állnak: „very close” = nagyon közel, „similar vibe” = hasonló hangulat, „same spirit” = rokon szellem. A GET /api/v1/similar?perfume= az indexben szereplő parfümből indul ki, vagy bármely más illathoz általad megadott illatjegyekből és akkordokból; a steer a fresher, sweeter, darker, lighter, longer_lasting vagy more_projection értékkel tolja el az eredményt. A GET /api/v1/alternatives?perfume= egy híres parfüm szerkesztői alternatíváit adja vissza, mindig más házaktól.

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

Más parfüm API-kkal összevetve

Amit mindegyik szolgáltatás a saját oldalán állít, 2026. október 21-én olvasva.

A méretek az egyes szolgáltatások saját állításai, a 10ML nem ellenőrizte őket; a 10ML-é a saját indexének mérete. A csomagok és korlátok változnak, ezért építés előtt nézd meg a szolgáltatást.

Használat MCP kliensből

Ugyanez az index távoli MCP szerverként is elérhető asszisztensek számára. A cím minden kliensben ugyanaz: https://mcp.10ml.com/mcp

• Claude (claude.ai és Claude Desktop)

  Nyisd meg a „Customize”, majd a „Connectors” részt, és add hozzá a 10ML Perfume Findert a könyvtárból, vagy válaszd a „+ Add”, majd az „Add custom connector” lehetőséget, és illeszd be az URL-t.

  Megnyitás a Claude könyvtárában

• Claude Code

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

• ChatGPT

  Weben nyisd meg a ChatGPT „Plugins” részét, kattints a plusz gombra, majd az „Add custom MCP server” lehetőségre: nevezd el 10ML Perfume Finderként, illeszd be az URL-t, és válaszd a hitelesítés nélküli lehetőséget.

A Cursor, a VS Code, a Gemini CLI, a Windsurf, a Cline, a Goose és a Zed ugyanazt a címet kapja. A parfüm MCP szerver oldala tartalmazza az egykattintásos telepítéseket és az összes klienst.

Példakérdések

Valódi válaszok a 10ML Fragrance Indexből, 2026. október 20. és 21.

• Milyen illata van a Baccarat Rouge 540-nek?

  get_perfume

  A Maison Francis Kurkdjian Baccarat Rouge 540-e (2015, eau de parfum, uniszex) ámbrás virágos illat: ragyogó, légies borostyán cukros, szinte vattacukorszerű édességgel ásványos fák felett. Fejjegyek: sáfrány és jázmin. Szívjegyek: amberwood és szürke ámbra. Alapjegyek: fenyőgyanta és cédrus. Ősszel, télen és tavasszal, estére és randevúkra a legjobb.

• Mi illatozik úgy, mint a Creed Aventus?

  find_similar_perfumes

  A legközelebbi az Armaf Club de Nuit Intense Man Parfum („very close” = nagyon közel áll: közös az ananász, a bergamott, az alma és a fekete ribizli). Az Armaf Club de Nuit Intense Man EDT és a Nishane Hacivat ugyanazt a hangulatot hozza; a Hacivat az ananásszal, bergamottal, jázminnal és pacsulival.

• Milyen illata van a bergamottnak, és mivel illik össze?

  explain_note

  A bergamott citrusos illatjegy: szikrázó, kissé virágos citrus zöld, teaszerű keserűséggel. Jól megy a levendulával, a vetiverrel, a nerolival, a fekete borsal, a pézsmával és a cédrussal.

Korlátok és tisztességes használat

Ingyenes, nincs API-kulcs, fiók vagy kezelendő keret, és minden végpont csak olvasható. Méltányos használati korlátozás előfordulhat (lásd a feltételeket), ezért a tömeges lekéréseket tartsd udvarias ütemben, és gyorsítótárazd, amit lekérsz: a REST-válaszok ötperces gyorsítótár-fejlécet kapnak. A listák a limit és a cursor paraméterrel lapozhatók. Nincsenek sütik, nincs követés, nincs kérési előzmény.

FeltételekAdatvédelem

Forrásmegjelölés

Alkalmazásban, oldalon vagy cikkben mutatod az adatokat? Jelöld meg forrásként a 10ML Fragrance Indexet, linkelj erre az oldalra, a szervert pedig 10ML Perfume Finderként említsd.

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

Hogyan áll a többiekhez képest

A kulcs nélkül válaszoló parfüm MCP szerverek 40 kérdéses tesztjében (2026. október 20.) a 10ML Perfume Finder 39-et ért el a 40-ből, a ScentVerdict 36-ot, a Parfum Bible 33-at, a Perfume Picks 32-t a sebességkorlát betartása mellett, a Parfica pedig 7-et. A nagyobb indexek a lefedettségben vezetnek: a ScentVerdict 31 000+, a Perfume Picks 13 000+, a ScentRev 126 000+ parfümöt állít, szemben a 10ML Fragrance Index 5 406 parfümjével. A ScentRev, a Noteboxd, a Fragella és a Fraganty kulcsot vagy bejelentkezést kér, ezért nem pontozhattuk őket.

Teljes eredmények és módszer

Kérdések