API de perfumes gratuita y API de fragancias

De un vistazo

Precio

Gratis

Registro

Ninguno. Sin clave API, sin cuenta

Protocolos

MCP (Streamable HTTP) y REST, descritos en OpenAPI 3.1

Cobertura

5400+ perfumes, 249 casas, 285 notas explicadas

Fichas

Pirámide olfativa (notas de salida, de corazón y de fondo), acordes, familia, estaciones y ocasiones; 481 fichas editoriales completas añaden duración, proyección y perfumistas

Interfaz

15 herramientas de solo lectura con esquemas de salida, 6 prompts, recursos y autocompletado

Idiomas

10: inglés, alemán, francés, español, italiano, rumano, griego, húngaro, checo y polaco

Disponible en

el MCP Registry oficial, el directorio de conectores de Claude, npm y PyPI

Privacidad

Sin cookies, sin seguimiento, sin historial de solicitudes

API REST: inicio rápido

Solicitudes GET sencillas, respuestas en JSON, CORS abierto, sin clave. Las mismas respuestas que las herramientas MCP. Consulta un perfume:

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

Respuesta (sin enlaces):

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

Endpoints

Ocho rutas GET de solo lectura en https://mcp.10ml.com/api/v1. Las listas se paginan con limit y cursor; locale cambia los enlaces de 10ml.com a otro idioma. Respuestas reales, abreviadas, del 21 de octubre de 2026.

Ejemplos de solicitudes y respuestas

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

Esquema completo: https://mcp.10ml.com/openapi.json

API de notas olfativas

La API de notas olfativas tiene dos rutas. GET /api/v1/notes/{note} explica cualquiera de las 285 notas del índice, con muchas grafías y en muchos idiomas (Bergamotte encuentra bergamot). GET /api/v1/perfumes?notes_include= lista los perfumes construidos alrededor de una o varias notas, de la más presente a la menos presente, y notes_exclude deja notas fuera. Consultar un perfume con format=detailed devuelve su pirámide olfativa: salida, corazón y 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 de similitud de perfumes

La API de similitud ordena los perfumes por notas, acordes y estilo compartidos, y dice qué comparte cada uno y lo cerca que está: «very close» = muy cercano, «similar vibe» = vibra similar, «same spirit» = mismo espíritu. GET /api/v1/similar?perfume= parte de un perfume del índice, o de las notas y acordes que pases para cualquier otra fragancia; steer orienta el resultado hacia fresher, sweeter, darker, lighter, longer_lasting o more_projection. GET /api/v1/alternatives?perfume= devuelve las alternativas de los editores a un perfume famoso, siempre de otras casas.

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

Comparada con otras API de perfumes

Lo que cada servicio dice en su propia web, leído el 21 de octubre de 2026.

Los tamaños son las cifras que cada servicio declara de sí mismo y 10ML no las ha comprobado; en el caso de 10ML es el tamaño de su propio índice. Los planes y los límites cambian: comprueba el servicio antes de construir sobre él.

Úsala desde un cliente MCP

El mismo índice es también un servidor MCP remoto para asistentes. La dirección es la misma en todos los clientes: https://mcp.10ml.com/mcp

• Claude (claude.ai y Claude Desktop)

  Abre «Customize», luego «Connectors», y añade 10ML Perfume Finder desde el directorio, o elige «+ Add», luego «Add custom connector», y pega la URL.

  Abrir en el directorio de Claude

• Claude Code

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

• ChatGPT

  En la web, abre «Plugins» en ChatGPT, pulsa el botón más y elige «Add custom MCP server»: llámalo 10ML Perfume Finder, pega la URL y elige sin autenticación.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose y Zed usan la misma dirección. La página del servidor MCP de perfumes tiene las instalaciones con un clic y todos los clientes.

Preguntas de ejemplo

Respuestas reales del 10ML Fragrance Index, 20 y 21 de octubre de 2026.

• ¿A qué huele Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 de Maison Francis Kurkdjian (2015, eau de parfum, unisex) es un ámbar floral: un ámbar luminoso y etéreo, con un dulzor azucarado, casi de algodón de azúcar, sobre maderas minerales. Salida: azafrán y jazmín. Corazón: amberwood y ámbar gris. Fondo: resina de abeto y cedro. Ideal en otoño, invierno y primavera, para noches y citas.

• ¿Qué huele como Creed Aventus?

  find_similar_perfumes

  El más cercano es Armaf Club de Nuit Intense Man Parfum («very close» = muy cercano: comparte piña, bergamota, manzana y grosella negra). Armaf Club de Nuit Intense Man EDT y Nishane Hacivat comparten la misma vibra; Hacivat a través de piña, bergamota, jazmín y pachulí.

• ¿A qué huele la bergamota y con qué combina?

  explain_note

  La bergamota es una nota cítrica: chispeante, ligeramente floral, con un amargor verde, casi de té. Combina con lavanda, vetiver, neroli, pimienta negra, almizcle y cedro.

Límites y uso razonable

Es gratis, sin clave API, cuenta ni cuota que gestionar, y todos los endpoints son de solo lectura. Puede aplicarse una limitación de frecuencia por uso razonable (consulta las condiciones), así que mantén los trabajos masivos a un ritmo moderado y guarda en caché lo que obtengas: las respuestas REST llevan una cabecera de caché de cinco minutos. Las listas se paginan con limit y cursor. Sin cookies, sin seguimiento, sin historial de solicitudes.

CondicionesPrivacidad

Cita la fuente

¿Muestras los datos en una app, una web o un artículo? Cítalos como 10ML Fragrance Index con un enlace a esta página, y cita el servidor como 10ML Perfume Finder.

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

Cómo se compara

En nuestro benchmark de 40 preguntas (20 de octubre de 2026) de los servidores MCP de perfumes que responden sin clave, 10ML Perfume Finder obtuvo 39 de 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 una vez respetado su límite de frecuencia y Parfica 7. Los índices más grandes ganan en amplitud: ScentVerdict declara 31 000+ perfumes, Perfume Picks 13 000+ y ScentRev 126 000+, frente a 5406 en el 10ML Fragrance Index. ScentRev, Noteboxd, Fragella y Fraganty exigen una clave o un inicio de sesión y no se pudieron puntuar.

Resultados completos y método

Guías

• ¿Qué es un servidor MCP de perfumes?
• Conector de perfumes para Claude
• App de perfumes para ChatGPT
• Alternativa a la API de Fragrantica
• API de recomendación de perfumes

Preguntas