API parfumuri gratuit și API pentru note olfactive

Pe scurt

Preț

Gratuit

Înregistrare

Niciuna. Fără cheie API, fără cont

Protocoale

MCP (Streamable HTTP) și REST, descrise în OpenAPI 3.1

Acoperire

Peste 5.400 de parfumuri, 249 de case, 285 de note explicate

Profiluri

Piramida olfactivă (note de cap, de inimă și de bază), acorduri, familie olfactivă, sezoane și ocazii; 481 de profiluri editoriale complete adaugă persistența, proiecția și parfumierii

Interfață

15 instrumente doar pentru citire, cu scheme de ieșire, 6 prompturi, resurse și completări

Limbi

10: engleză, germană, franceză, spaniolă, italiană, română, greacă, maghiară, cehă și poloneză

Listat în

Registrul oficial MCP, directorul de conectori Claude, npm și PyPI

Confidențialitate

Fără cookie-uri, fără urmărire, fără istoric al cererilor

Pornire rapidă cu API-ul REST

Cereri GET simple, răspuns JSON, CORS deschis, fără cheie. Aceleași răspunsuri ca instrumentele MCP. Caută un parfum:

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

Răspuns (fără linkuri):

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

Endpointuri

Opt rute GET doar pentru citire, sub https://mcp.10ml.com/api/v1. Listele sunt paginate cu limit și cursor; locale comută linkurile 10ml.com pe altă limbă. Răspunsuri reale, scurtate, din 21 octombrie 2026.

Exemple de cereri și răspunsuri

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

Schema completă: https://mcp.10ml.com/openapi.json

API pentru note olfactive

API-ul pentru note olfactive are două rute. GET /api/v1/notes/{note} explică oricare dintre cele 285 de note din index, în multe grafii și limbi (Bergamotte găsește bergamot). GET /api/v1/perfumes?notes_include= listează parfumurile construite în jurul uneia sau mai multor note, cele mai proeminente primele, iar notes_exclude lasă notele deoparte. O căutare de parfum cu format=detailed returnează piramida olfactivă: note de cap, de inimă și de bază.

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 de similaritate pentru parfumuri

API-ul de similaritate ordonează parfumurile după notele, acordurile și stilul comune și spune ce are în comun fiecare și cât de apropiat este: „very close” = foarte apropiat, „similar vibe” = atmosferă similară, „same spirit” = același spirit. GET /api/v1/similar?perfume= pornește de la un parfum din index sau de la notele și acordurile pe care le transmiți pentru orice alt parfum; steer mută rezultatul spre fresher, sweeter, darker, lighter, longer_lasting sau more_projection. GET /api/v1/alternatives?perfume= returnează alternativele editorilor la un parfum celebru, întotdeauna de la alte case.

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

Comparat cu alte API-uri de parfumuri

Ce spune fiecare serviciu pe propriul site, citit la 21 octombrie 2026.

Dimensiunile sunt cifrele pe care fiecare serviciu le declară pentru sine și nu au fost verificate de 10ML; cifra 10ML este dimensiunea propriului index. Planurile și limitele se schimbă, așa că verifică serviciul înainte de a construi.

Folosește-l dintr-un client MCP

Același index este și un server MCP la distanță pentru asistenți. Adresa este aceeași în orice client: https://mcp.10ml.com/mcp

• Claude (claude.ai și Claude Desktop)

  Deschide „Customize”, apoi „Connectors”, și adaugă 10ML Perfume Finder din director, sau alege „+ Add”, apoi „Add custom connector”, și lipește adresa URL.

  Deschide în directorul Claude

• Claude Code

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

• ChatGPT

  Pe web, deschide „Plugins” în ChatGPT, apasă butonul plus, apoi „Add custom MCP server”: numește-l 10ML Perfume Finder, lipește adresa URL și alege fără autentificare.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose și Zed preiau aceeași adresă. Pagina serverului MCP de parfumuri are instalările dintr-un clic și toți clienții.

Exemple de întrebări

Răspunsuri reale din 10ML Fragrance Index, 20 și 21 octombrie 2026.

• Cum miroase Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 de la Maison Francis Kurkdjian (2015, eau de parfum, unisex) este un floral ambrat: o ambră luminoasă și aerată, cu o dulceață zaharată, aproape de vată de zahăr, peste lemne minerale. Cap: șofran și iasomie. Inimă: lemn de amber și ambră cenușie. Bază: rășină de brad și cedru. Se potrivește toamna, iarna și primăvara, pentru seri și întâlniri.

• Ce miroase ca Creed Aventus?

  find_similar_perfumes

  Cel mai apropiat este Armaf Club de Nuit Intense Man Parfum („very close” = foarte apropiat: are în comun ananasul, bergamota, mărul și coacăzele negre). Armaf Club de Nuit Intense Man EDT și Nishane Hacivat au aceeași atmosferă; Hacivat prin ananas, bergamotă, iasomie și paciuli.

• Cum miroase bergamota și cu ce se asortează?

  explain_note

  Bergamota este o notă citrică: citrică spumoasă, ușor florală, cu o amăreală verde, ca de ceai. Se asortează cu lavandă, vetiver, neroli, piper negru, mosc și cedru.

Limite și utilizare echitabilă

Este gratuit, fără cheie API, cont sau cotă de administrat, iar fiecare endpoint este doar pentru citire. Se poate aplica o limitare echitabilă a ratei (vezi termenii), așa că ține procesările în masă la un ritm rezonabil și păstrează în cache ce descarci: răspunsurile REST au un antet de cache de cinci minute. Listele sunt paginate cu limit și cursor. Fără cookie-uri, fără urmărire, fără istoric al cererilor.

TermeniConfidențialitate

Atribuire

Afișezi datele într-o aplicație, pe un site sau într-un articol? Menționează sursa ca 10ML Fragrance Index, cu un link către această pagină, și citează serverul ca 10ML Perfume Finder.

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

Cum se compară

În benchmarkul nostru cu 40 de întrebări (20 octombrie 2026) al serverelor MCP de parfumuri care răspund fără cheie, 10ML Perfume Finder a obținut 39 din 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 după ce i-a fost respectată limita de rată și Parfica 7. Indexurile mai mari sunt înaintea noastră la acoperire: ScentVerdict declară peste 31.000 de parfumuri, Perfume Picks peste 13.000 și ScentRev peste 126.000, față de 5.406 în 10ML Fragrance Index. ScentRev, Noteboxd, Fragella și Fraganty cer o cheie sau autentificare și nu au putut fi evaluate.

Rezultate complete și metodă

Întrebări