API profumi gratuita e API fragranze

In breve

Prezzo

Gratis

Registrazione

Nessuna. Niente chiave API, niente account

Protocolli

MCP (Streamable HTTP) e REST, descritti in OpenAPI 3.1

Copertura

oltre 5.400 profumi, 249 case, 285 note spiegate

Profili

Piramide olfattiva (note di testa, di cuore e di fondo), accordi, famiglia, stagioni e occasioni; 481 profili editoriali completi aggiungono durata, proiezione e profumieri

Interfaccia

15 tool di sola lettura con output schema, 6 prompt, risorse e completamenti

Lingue

10: inglese, tedesco, francese, spagnolo, italiano, rumeno, greco, ungherese, ceco e polacco

Presente in

MCP Registry ufficiale, directory dei connettori di Claude, npm e PyPI

Privacy

Nessun cookie, nessun tracciamento, nessuna cronologia delle richieste

API REST: avvio rapido

Semplici richieste GET, risposta in JSON, CORS aperto, nessuna chiave. Le stesse risposte dei tool MCP. Cerca un profumo:

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

Risposta (link omessi):

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

Endpoint

Otto rotte GET di sola lettura sotto https://mcp.10ml.com/api/v1. Le liste sono paginate con limit e cursor; locale porta i link di 10ml.com in un’altra lingua. Risposte vere, accorciate, del 21 ottobre 2026.

Richieste e risposte di esempio

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 completo: https://mcp.10ml.com/openapi.json

API note olfattive

L’API per le note olfattive ha due rotte. GET /api/v1/notes/{note} spiega una qualsiasi delle 285 note dell’indice, in molte grafie e lingue (Bergamotte trova bergamot). GET /api/v1/perfumes?notes_include= elenca i profumi costruiti attorno a una o più note, dai più marcati, e notes_exclude esclude le note indicate. Una ricerca di profumo con format=detailed restituisce la sua piramide olfattiva: note di testa, di cuore e di fondo.

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 per profumi simili

L’API per profumi simili ordina i profumi per note, accordi e stile in comune e indica cosa condivide ciascuno e quanto è vicino: «very close» = molto vicino, «similar vibe» = mood simile, «same spirit» = stesso spirito. GET /api/v1/similar?perfume= parte da un profumo dell’indice, oppure da note e accordi che passi per qualsiasi altra fragranza; steer sposta il risultato verso fresher, sweeter, darker, lighter, longer_lasting o more_projection. GET /api/v1/alternatives?perfume= restituisce gli equivalenti scelti dalla redazione per un profumo famoso, sempre di altre 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"
}

Confronto con altre API per profumi

Quello che ogni servizio dichiara sul proprio sito, letto il 21 ottobre 2026.

Le dimensioni sono i numeri che ogni servizio dichiara per sé e non sono stati verificati da 10ML; quella di 10ML è la dimensione del proprio indice. Piani e limiti cambiano: controlla il servizio prima di sviluppare.

Usalo da un client MCP

Lo stesso indice è anche un server MCP remoto per gli assistenti. L’indirizzo è lo stesso in ogni client: https://mcp.10ml.com/mcp

• Claude (claude.ai e Claude Desktop)

  Apri «Customize», poi «Connectors», e aggiungi 10ML Perfume Finder dalla directory, oppure scegli «+ Add», poi «Add custom connector», e incolla l’URL.

  Apri nella directory di Claude

• Claude Code

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

• ChatGPT

  Sul web, apri «Plugins» in ChatGPT, premi il pulsante più e scegli «Add custom MCP server»: chiamalo 10ML Perfume Finder, incolla l’URL e scegli nessuna autenticazione.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose e Zed usano lo stesso indirizzo. La pagina del server MCP per profumi ha le installazioni con un clic e tutti i client.

Domande di esempio

Risposte vere dal 10ML Fragrance Index, 20 e 21 ottobre 2026.

• Che odore ha Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 di Maison Francis Kurkdjian (2015, eau de parfum, unisex) è un floreale ambrato: un ambra luminosa e aerea, con una dolcezza zuccherina, quasi da zucchero filato, su legni minerali. Testa: zafferano e gelsomino. Cuore: legno d’ambra e ambra grigia. Fondo: resina di abete e cedro. Perfetto in autunno, inverno e primavera, per le serate e gli appuntamenti.

• Quale profumo assomiglia a Creed Aventus?

  find_similar_perfumes

  Il più vicino è Armaf Club de Nuit Intense Man Parfum («very close» = molto vicino: condivide ananas, bergamotto, mela e ribes nero). Armaf Club de Nuit Intense Man EDT e Nishane Hacivat hanno lo stesso mood; Hacivat con ananas, bergamotto, gelsomino e patchouli.

• Che odore ha il bergamotto e con cosa si abbina?

  explain_note

  Il bergamotto è una nota di agrumi: frizzante, leggermente floreale, con un amaro verde che ricorda il tè. Si abbina a lavanda, vetiver, neroli, pepe nero, muschio e cedro.

Limiti e uso corretto

È gratuita, senza chiave API, account o quota da gestire, e ogni endpoint è di sola lettura. Può essere applicato un limite di frequenza per uso corretto (vedi i termini): mantieni i job batch a un ritmo moderato e metti in cache ciò che scarichi, perché le risposte REST hanno un’intestazione di cache di cinque minuti. Le liste sono paginate con limit e cursor. Nessun cookie, nessun tracciamento, nessuna cronologia delle richieste.

TerminiPrivacy

Citazione della fonte

Mostri i dati in un’app, in un sito o in un articolo? Citali come 10ML Fragrance Index con un link a questa pagina e indica il server come 10ML Perfume Finder.

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

Il confronto con gli altri

Nel nostro confronto di 40 domande (20 ottobre 2026) tra i server MCP per profumi che rispondono senza chiave, 10ML Perfume Finder ha totalizzato 39 su 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 una volta rispettato il suo limite di frequenza e Parfica 7. Gli indici più grandi vincono per ampiezza: ScentVerdict dichiara oltre 31.000 profumi, Perfume Picks oltre 13.000 e ScentRev oltre 126.000, contro i 5.406 del 10ML Fragrance Index. ScentRev, Noteboxd, Fragella e Fraganty richiedono una chiave o un accesso e non è stato possibile valutarli.

Risultati completi e metodo

Domande frequenti