Scento Perfume API

API de perfumes gratuita

Scento Perfume API es una API de fragancias gratuita y de solo lectura para desarrolladores y agentes de IA: pirámides olfativas, familias de aromas, perfumes similares, casas de perfumes y un glosario de más de 400 materias primas. Sin clave de API, sin registro, CORS abierto, JSON sobre HTTPS, descrita en OpenAPI 3.1. Cada pirámide olfativa procede de la lista publicada por la casa o por un minorista autorizado.

Precio: Gratis
Acceso: Sin clave de API, sin registro
Método: Solo lectura (GET), JSON
CORS: Abierto, se puede llamar desde el navegador
Especificación: OpenAPI 3.1, más un servidor MCP
Tamaño: 1.400+ perfumes, 140+ casas, 400+ materias primas
Enlaces: A scento.com en diez idiomas
Procedencia: Lista de la casa o de un minorista autorizado

Inicio rápido

Una petición, ninguna clave

Pega cualquiera de estos ejemplos. No hay nada que registrar: la API responde a peticiones anónimas y cada ruta acepta lang para que los enlaces lleven a scento.com en el idioma de tu lector.

curl

curl "https://www.scento.com/api/perfume/v1/perfumes/layton?lang=es"

Python

import requests

r = requests.get("https://www.scento.com/api/perfume/v1/perfumes/layton", params={"lang": "es"}, timeout=10)
r.raise_for_status()
folio = r.json()
print(folio["lede"])
print(folio["detail"]["pyramid"])

JavaScript

const res = await fetch("https://www.scento.com/api/perfume/v1/perfumes/layton?lang=es");
const { lede, detail, scento_page } = await res.json();
console.log(lede, detail.pyramid, scento_page.url);

Qué devuelve

La respuesta real de la primera petición, abreviada: las listas largas se cortan en sus primeras entradas. Todas las respuestas tienen la misma forma: una frase inicial citable (lede), un objeto de detalle, la página de scento.com para seguir leyendo, lecturas relacionadas y una línea de cita (cite). Las respuestas están en inglés.

GET /perfumes/layton

{
  "folio": "perfume-portrait",
  "lede": "Layton by Parfums de Marly belongs to Scento’s Wood & Root family: apple, bergamot and cardamom open onto lavender, violet and geranium, settling on patchouli, vanilla, guaiac wood and praline.",
  "detail": {
    "name": "Layton",
    "house": "Parfums de Marly",
    "year": null,
    "perfumer": null,
    "concentration": "eau de parfum",
    "family": "Wood & Root",
    "subfamily": "Velvet Sweet",
    "pyramid": {
      "top": [
        "Apple",
        "Bergamot",
        "Cardamom"
      ],
      "heart": [
        "Lavender",
        "Violet",
        "Geranium"
      ],
      "base": [
        "Patchouli",
        "Vanilla",
        "Guaiac Wood",
        "Praline"
      ]
    },
    "notes": null,
    "character": "An apple-and-lavender blend: bergamot and cardamom up top, violet and geranium in the middle, patchouli, vanilla and praline below.",
    "character_words": [
      "sweet",
      "warm",
      "fresh",
      "herbal"
    ],
    "wears": {
      "seasons": [
        "spring",
        "summer",
        "autumn"
      ],
      "hours": [
        "day",
        "evening"
      ]
    },
    "signature_materials": [
      "Patchouli",
      "Guaiac Wood"
    ]
  },
  "scento_page": {
    "label": "Layton en Scento",
    "url": "https://www.scento.com/es/perfumes/layton-parfums-de-marly"
  },
  "further_reading": [
    {
      "label": "Parfums de Marly en Scento",
      "url": "https://www.scento.com/es/brand/parfums-de-marly"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": null
}

Por qué verificadas

Notas que puedes citar sin comprobar

Los asistentes y las apps inventan notas con frecuencia. En el estudio de Scento sobre motores de respuesta, entre el 24 % y el 49 % de las respuestas, según el motor, incluían notas que no figuran en la lista oficial del perfume. Scento Perfume API toma el otro camino: cada pirámide procede de la lista publicada por la casa o por un minorista autorizado, de modo que un producto, una app o un agente puede citarla en lugar de adivinar de memoria.

Leer el estudio

Referencia de endpoints

Todos los endpoints, del archivo OpenAPI en vivo

Generada a partir del documento OpenAPI que sirve la propia API, de modo que la tabla no puede desviarse de ella. Todas las rutas son GET; las descripciones están en inglés.

Endpoint	Devuelve	Parámetros
GET /search	Search perfumes, houses and notes	q, kind?
GET /perfumes	Search perfumes, houses and notes	q
GET /perfumes/{perfume}	Get a perfume's notes and profile	perfume
GET /perfumes/{perfume}/neighbours	Find similar perfumes	perfume, same_house?
GET /contrast	Compare perfumes side by side	perfumes
GET /materials/{material}	Explain a note or ingredient	material
GET /materials/match	Find perfumes by note	materials, tier?, family?
GET /houses/{house}	Profile a perfume house	house
GET /families	Explore fragrance families
GET /families/{family}	Explore fragrance families	family
GET /edits/{occasion}	Pick perfumes for an occasion	occasion, gender_lean?
GET /wardrobe	Build a fragrance wardrobe	loves, avoid?, size?
GET /lexicon/{term}	Explain a perfumery term	term
GET /journal	Search the Scento journal	q

Cada ruta acepta lang (en, de, fr, es, it, ro, el, hu, cs, pl); las respuestas siguen en inglés y los enlaces siguen el valor de lang. Las listas aceptan continuation.

OpenAPI 3.1 (JSON) · Ficha del servidor MCP

API de notas olfativas

API de notas olfativas: pirámides y materias primas

Consulta un perfume y obtén sus notas de salida, de corazón y de fondo tal como las publica la casa o un minorista autorizado, con su familia, concentración, carácter y las materias que lo definen. Consulta una nota y obtén una entrada del glosario de más de 400 materias primas.

GET /perfumes/{perfume}: la pirámide, la familia, el carácter y cómo se lleva
GET /materials/{material}: origen, natural o sintética, a qué huele, con qué combina, alias como ambroxide
GET /materials/match: perfumes construidos sobre las notas que nombras, por nivel de la pirámide

Una materia prima, en vivo: GET /materials/ambroxan?lang=es

/materials/ambroxan?lang=es

{
  "folio": "note-portrait",
  "lede": "Ambroxan is a synthetic material from the amber family: clean, woody-ambery and slightly salty, with a mineral glow.",
  "detail": {
    "name": "Ambroxan",
    "aliases": [
      "ambroxide",
      "ambroxe",
      "ambroxan",
      "Ambrox"
    ],
    "origin": null,
    "natural_or_synthetic": "synthetic",
    "smells_like": "Clean, woody-ambery and slightly salty, with a mineral glow.",
    "family": "Amber",
    "scento_family": "Amber & Resin",
    "pairs_well_with": [
      "Bergamot",
      "Musk",
      "Patchouli",
      "Vanilla"
    ],
    "showcased_in": [
      {
        "name": "Pegasus",
        "house": "Parfums de Marly",
        "page": "https://www.scento.com/es/perfumes/pegasus-by-parfums-de-marly",
        "tier": "base"
      },
      {
        "name": "Galloway",
        "house": "Parfums de Marly",
        "page": "https://www.scento.com/es/perfumes/galloway-parfums-de-marly",
        "tier": "base"
      },
      {
        "name": "Club de Nuit Milestone",
        "house": "Armaf",
        "page": "https://www.scento.com/es/perfumes/club-de-nuit-milestone-armaf",
        "tier": "base"
      }
    ]
  },
  "scento_page": {
    "label": "Notas olfativas en Scento",
    "url": "https://www.scento.com/es/notes"
  },
  "further_reading": [
    {
      "label": "Pegasus en Scento",
      "url": "https://www.scento.com/es/perfumes/pegasus-by-parfums-de-marly"
    },
    {
      "label": "Galloway en Scento",
      "url": "https://www.scento.com/es/perfumes/galloway-parfums-de-marly"
    },
    {
      "label": "Club de Nuit Milestone en Scento",
      "url": "https://www.scento.com/es/perfumes/club-de-nuit-milestone-armaf"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": null
}

API de base de datos de perfumes

API de base de datos de perfumes: perfumes, casas, familias

Busca entre más de 1.400 perfumes y 140 casas, recorre el mapa de 14 familias propio de Scento, lee el retrato de una casa o busca en el diario de Scento. Es una base de datos de perfumes verificada, no un scraping: las entradas proceden de listas publicadas y cada respuesta enlaza la página correspondiente de scento.com.

GET /search y /perfumes: encontrar perfumes, casas y notas por nombre
GET /houses/{house} y /families: retratos de casas y el mapa de familias
GET /journal: buscar artículos, con la página para seguir leyendo

Una búsqueda, en vivo: GET /search?q=oud&kind=perfume&lang=es

/search?q=oud&kind=perfume&lang=es

{
  "folio": "perfume-search",
  "lede": "130 entries in Scento's verified perfume database match “oud”; showing 1–10.",
  "detail": {
    "query": "oud",
    "kind": "perfume",
    "total": 130,
    "matches": [
      {
        "kind": "perfume",
        "name": "Oud Wood",
        "house": "Tom Ford",
        "family": "Spice Route",
        "page": "https://www.scento.com/es/perfumes/oud-wood-tom-ford"
      },
      {
        "kind": "perfume",
        "name": "Oud for Greatness",
        "house": "Initio Parfums Prives",
        "family": "Spice Route",
        "page": "https://www.scento.com/es/perfumes/initio-parfums-prives-oud-for-greatness"
      },
      {
        "kind": "perfume",
        "name": "Oud Satin Mood",
        "house": "Maison Francis Kurkdjian",
        "family": "Petal Garden",
        "page": "https://www.scento.com/es/perfumes/oud-satin-mood-by-maison-francis-kurkdjian"
      }
    ]
  },
  "scento_page": {
    "label": "Oud Wood en Scento",
    "url": "https://www.scento.com/es/perfumes/oud-wood-tom-ford"
  },
  "further_reading": [
    {
      "label": "Oud for Greatness en Scento",
      "url": "https://www.scento.com/es/perfumes/initio-parfums-prives-oud-for-greatness"
    },
    {
      "label": "Oud Satin Mood en Scento",
      "url": "https://www.scento.com/es/perfumes/oud-satin-mood-by-maison-francis-kurkdjian"
    },
    {
      "label": "Lattafa en Scento",
      "url": "https://www.scento.com/es/brand/lattafa"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": "cGVyZnVtZS1zZWFyY2h8MWhnb3J2M3wxMA"
}

API de perfumes similares

API de perfumes similares: aromas con la misma estructura

Encuentra los perfumes que comparten notas y estructura con el que nombres, con las notas en común y una línea sobre la diferencia. Compara de dos a cuatro perfumes lado a lado o arma un pequeño armario olfativo a partir de lo que alguien ama y quiere evitar. Similitud significa aquí notas y estructura compartidas, no que un perfume sea otro.

GET /perfumes/{perfume}/neighbours: las estructuras más cercanas, notas compartidas y la diferencia
GET /contrast: de dos a cuatro perfumes lado a lado
GET /wardrobe: un pequeño armario olfativo según favoritos y descartes

Perfumes vecinos, en vivo: GET /perfumes/layton/neighbours?lang=es

/perfumes/layton/neighbours?lang=es

{
  "folio": "scent-neighbours",
  "lede": "668 perfumes share structure with Layton by Parfums de Marly; the closest is Detour Noir, sharing bergamot, lavender and apple.",
  "detail": {
    "anchor": {
      "name": "Layton",
      "house": "Parfums de Marly",
      "page": "https://www.scento.com/es/perfumes/layton-parfums-de-marly",
      "family": "Wood & Root"
    },
    "total": 668,
    "neighbours": [
      {
        "name": "Detour Noir",
        "house": "Al Haramain",
        "page": "https://www.scento.com/es/perfumes",
        "family": "Wood & Root",
        "shared": [
          "Bergamot",
          "Lavender",
          "Apple",
          "Violet"
        ],
        "difference": "Leans more floral and spicy, with mandarin and pepper added."
      },
      {
        "name": "Sunday Cologne",
        "house": "Byredo",
        "page": "https://www.scento.com/es/brand/byredo",
        "family": "Wood & Root",
        "shared": [
          "Bergamot",
          "Cardamom",
          "Geranium",
          "Lavender"
        ],
        "difference": "Leans more earthy and spicy, with anise and incense added."
      },
      {
        "name": "Wild Rush",
        "house": "Initio Parfums Prives",
        "page": "https://www.scento.com/es/perfumes/wild-rush-initio-parfums-prives",
        "family": "Wood & Root",
        "shared": [
          "Bergamot",
          "Lavender",
          "Vanilla",
          "Patchouli"
        ],
        "difference": "Leans more citrusy, with caramel and red berries added."
      }
    ]
  },
  "scento_page": {
    "label": "Layton en Scento",
    "url": "https://www.scento.com/es/perfumes/layton-parfums-de-marly"
  },
  "further_reading": [
    {
      "label": "Perfumes en Scento",
      "url": "https://www.scento.com/es/perfumes"
    },
    {
      "label": "Byredo en Scento",
      "url": "https://www.scento.com/es/brand/byredo"
    },
    {
      "label": "Wild Rush en Scento",
      "url": "https://www.scento.com/es/perfumes/wild-rush-initio-parfums-prives"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": "c2NlbnQtbmVpZ2hib3Vyc3wxdmM4bzU0fDg"
}

Encaje

Para qué sirve y para qué no

Existen catálogos de perfumes más grandes: servicios que declaran de 100.000 a 240.000 fichas, con claves de API, cuotas o tarifas. Scento Perfume API es más pequeña a propósito. Cambia amplitud por exactitud verificada y ausencia de fricción: 1.400+ perfumes, 140+ casas y 400+ materias primas, cada dato con su fuente publicada, tras una API sin clave ni cuenta.

No incluye precios, existencias, valoraciones ni reseñas de la comunidad. Si necesitas una lista muy grande o datos de la comunidad, elige un servicio pensado para eso; si necesitas notas que puedas respaldar, o un agente que no deba inventar notas, empieza aquí.

Ver la comparativa con fecha

En otros sitios

También disponible en

La misma API, listada donde los desarrolladores la buscan.

FAQ

Preguntas de los desarrolladores

¿Existe una API de perfumes gratuita?

Sí. Scento Perfume API es gratuita, sin un plan de pago al que pasar. Es una API REST de solo lectura con descripción OpenAPI 3.1 y un servidor MCP, con 1.400+ perfumes, 140+ casas y 400+ materias primas. Empieza por https://www.scento.com/api/perfume/v1/perfumes/layton.

¿Existe una API de perfumes sin clave de API?

Sí. Scento Perfume API no pide clave, registro ni cuenta: las peticiones GET anónimas se responden directamente y el CORS está abierto, así que puedes llamarla desde el navegador o desde un servidor. Varios servicios del sector, algunos de los mayores, piden clave o cuenta; la comparativa con fecha indica cuáles.

¿Cuál es la mejor API de perfumes para desarrolladores?

Depende de lo que construyas. Juzga con estos criterios: tamaño del catálogo; qué campos necesitas (notas, acordes, duración, precios, valoraciones de la comunidad); de dónde salen los datos; cuánta fricción hay (clave, registro, cuota, tarifas); la interfaz (REST, OpenAPI, MCP) y las condiciones de uso. Existen catálogos más grandes, con claves y límites. La Perfume API de Scento encaja cuando las notas verificadas y la ausencia de fricción importan más que la amplitud, por ejemplo en una app o un agente de IA que no debe inventar notas. La página de comparativa pone las opciones lado a lado.

¿Existe una API de notas olfativas?

Sí. GET /perfumes/{perfume} devuelve las notas de salida, de corazón y de fondo de un perfume, y GET /materials/{material} explica una materia prima: de dónde viene, si es natural o sintética, a qué huele y qué perfumes la muestran mejor. El glosario cubre más de 400 materias.

¿De dónde salen las notas?

Cada pirámide procede de la lista publicada por la casa o por un minorista autorizado. Nada se predice ni se rellena con votos de la comunidad. Importa porque los motores de respuesta suelen añadir notas que un perfume no declara: en el estudio de Scento, entre el 24 % y el 49 % de las respuestas lo hacían, según el motor.

¿Existe una API de perfumes similares?

Sí. GET /perfumes/{perfume}/neighbours devuelve perfumes que comparten la estructura del que nombras, con las notas en común y en qué se distinguen, y GET /contrast pone de dos a cuatro perfumes lado a lado. Similitud significa notas y estructura compartidas.

¿Hay límites de uso o licencia?

No hay clave ni cuota publicada. Guarda las respuestas en caché y mantén un ritmo de peticiones razonable; las condiciones prohíben sobrecargar el servicio o copiarlo en bloque para reconstruir una base de datos competidora. Las condiciones están en https://www.scento.com/terms-of-service#perfume-api.

¿Funciona con asistentes de IA?

Sí, las mismas respuestas están disponibles como servidor MCP en https://www.scento.com/mcp, con doce herramientas de solo lectura para Claude, ChatGPT, Cursor, VS Code y cualquier cliente MCP. Consulta la página del Perfume MCP Server.