API parfum gratuite et API de notes olfactives

En bref

Prix

Gratuit

Inscription

Aucune. Pas de clé API, pas de compte

Protocoles

MCP (Streamable HTTP) et REST, décrits en OpenAPI 3.1

Couverture

5 400+ parfums, 249 maisons, 285 notes expliquées

Fiches

Pyramide olfactive (notes de tête, de cœur et de fond), accords, famille, saisons et occasions ; 481 fiches éditoriales complètes ajoutent la tenue, le sillage et les parfumeurs

Interface

15 outils en lecture seule avec schémas de sortie, 6 prompts, des ressources et des complétions

Langues

10 : anglais, allemand, français, espagnol, italien, roumain, grec, hongrois, tchèque et polonais

Référencé dans

le MCP Registry officiel, l’annuaire des connecteurs de Claude, npm et PyPI

Confidentialité

Pas de cookies, pas de suivi, pas d’historique des requêtes

API REST : démarrage rapide

De simples requêtes GET, du JSON en retour, CORS ouvert, sans clé. Les mêmes réponses que les outils MCP. Consulter 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éponse (liens omis) :

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

Points de terminaison

Huit routes GET en lecture seule sous https://mcp.10ml.com/api/v1. Les listes sont paginées avec limit et cursor ; locale bascule les liens 10ml.com vers une autre langue. Vraies réponses, abrégées, du 21 octobre 2026.

Exemples de requêtes et de réponses

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

Schéma complet : https://mcp.10ml.com/openapi.json

API de notes olfactives

L’API de notes olfactives compte deux routes. GET /api/v1/notes/{note} explique chacune des 285 notes de l’index, sous de nombreuses graphies et dans de nombreuses langues (Bergamotte trouve bergamot). GET /api/v1/perfumes?notes_include= liste les parfums construits autour d’une ou plusieurs notes, du plus marqué au moins marqué, et notes_exclude écarte des notes. Une consultation de parfum avec format=detailed renvoie sa pyramide olfactive : tête, cœur et fond.

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 similarité de parfums

L’API de similarité classe les parfums selon les notes, accords et style partagés, et indique ce que chacun partage et à quel point il est proche : « very close » = très proche, « similar vibe » = même ambiance, « same spirit » = même esprit. GET /api/v1/similar?perfume= part d’un parfum de l’index, ou des notes et accords que vous transmettez pour n’importe quel autre parfum ; steer oriente le résultat vers fresher, sweeter, darker, lighter, longer_lasting ou more_projection. GET /api/v1/alternatives?perfume= renvoie les alternatives des rédacteurs à un parfum célèbre, toujours issues d’autres maisons.

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

Comparée aux autres API parfum

Ce que chaque service indique sur son propre site, relevé le 21 octobre 2026.

Les tailles sont les chiffres que chaque service annonce pour lui-même et n’ont pas été vérifiés par 10ML ; pour 10ML, c’est la taille de son propre index. Les offres et les limites changent : vérifiez le service avant de construire dessus.

L’utiliser depuis un client MCP

Le même index est aussi un serveur MCP distant pour les assistants. L’adresse est la même dans tous les clients : https://mcp.10ml.com/mcp

• Claude (claude.ai et Claude Desktop)

  Ouvrez « Customize », puis « Connectors », et ajoutez 10ML Perfume Finder depuis l’annuaire, ou choisissez « + Add », puis « Add custom connector », et collez l’URL.

  Ouvrir dans l’annuaire de Claude

• Claude Code

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

• ChatGPT

  Sur le web, ouvrez « Plugins » dans ChatGPT, appuyez sur le bouton plus, puis « Add custom MCP server » : nommez-le 10ML Perfume Finder, collez l’URL et choisissez aucune authentification.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose et Zed prennent la même adresse. La page du serveur MCP parfum propose les installations en un clic et tous les clients.

Exemples de questions

De vraies réponses du 10ML Fragrance Index, 20 et 21 octobre 2026.

• Quelle odeur a Baccarat Rouge 540 ?

  get_perfume

  Baccarat Rouge 540 de Maison Francis Kurkdjian (2015, eau de parfum, mixte) est un ambré floral : un ambre lumineux et aérien, d’une douceur sucrée presque barbe à papa, sur des bois minéraux. Tête : safran et jasmin. Cœur : amberwood et ambre gris. Fond : résine de sapin et cèdre. Idéal en automne, en hiver et au printemps, pour les soirées et les rendez-vous en amoureux.

• Qu’est-ce qui sent comme Creed Aventus ?

  find_similar_perfumes

  Le plus proche est Armaf Club de Nuit Intense Man Parfum (« very close » = très proche : ananas, bergamote, pomme et cassis en commun). Armaf Club de Nuit Intense Man EDT et Nishane Hacivat partagent la même ambiance ; Hacivat par l’ananas, la bergamote, le jasmin et le patchouli.

• Quelle odeur a la bergamote, et avec quoi l’associer ?

  explain_note

  La bergamote est une note hespéridée : pétillante, légèrement florale, avec une amertume verte et un peu théinée. Elle s’associe à la lavande, au vétiver, au néroli, au poivre noir, au musc et au cèdre.

Limites et usage raisonnable

C’est gratuit, sans clé API, sans compte ni quota à gérer, et chaque point de terminaison est en lecture seule. Une limitation de débit pour usage raisonnable peut s’appliquer (voir les conditions) : gardez donc un rythme modéré pour les traitements en masse et mettez en cache ce que vous récupérez. Les réponses REST portent un en-tête de cache de cinq minutes. Les listes sont paginées avec limit et cursor. Pas de cookies, pas de suivi, pas d’historique des requêtes.

ConditionsConfidentialité

Citer la source

Vous affichez les données dans une application, un site ou un article ? Citez-les comme 10ML Fragrance Index avec un lien vers cette page, et citez le serveur comme 10ML Perfume Finder.

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

Comment il se compare

Dans notre benchmark de 40 questions (20 octobre 2026) des serveurs MCP parfum qui répondent sans clé, 10ML Perfume Finder a obtenu 39 sur 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 une fois sa limite de débit respectée et Parfica 7. Les index plus grands l’emportent sur l’étendue : ScentVerdict annonce 31 000+ parfums, Perfume Picks 13 000+ et ScentRev 126 000+, contre 5 406 dans le 10ML Fragrance Index. ScentRev, Noteboxd, Fragella et Fraganty exigent une clé ou une connexion et n’ont pas pu être notés.

Résultats complets et méthode

Guides

• Qu’est-ce qu’un serveur MCP parfum ?
• Connecteur parfum Claude
• Application parfum ChatGPT
• Alternative à l’API Fragrantica
• API de recommandation de parfums

Questions