Scento Perfume API

API parfum gratuite

Scento Perfume API est une API de parfum gratuite, en lecture seule, pour les développeurs et les agents IA : pyramides olfactives, familles de parfums, parfums similaires, maisons de parfum et un glossaire de plus de 400 matières premières. Pas de clé API, pas d’inscription, CORS ouvert, JSON en HTTPS, décrite en OpenAPI 3.1. Chaque pyramide olfactive remonte à la liste publiée par la maison ou par un revendeur agréé.

Prix: Gratuit
Accès: Sans clé API, sans inscription
Méthode: Lecture seule (GET), JSON
CORS: Ouvert, utilisable depuis un navigateur
Spécification: OpenAPI 3.1, plus un serveur MCP
Taille: 1 400+ parfums, 140+ maisons, 400+ matières premières
Liens: Vers scento.com en dix langues
Provenance: Liste de la maison ou d’un revendeur agréé

Démarrage rapide

Une requête, aucune clé

Collez l’un de ces exemples. Rien à créer : l’API répond aux requêtes anonymes, et chaque route accepte lang pour que les liens pointent vers scento.com dans la langue de votre lecteur.

curl

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

Python

import requests

r = requests.get("https://www.scento.com/api/perfume/v1/perfumes/layton", params={"lang": "fr"}, 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=fr");
const { lede, detail, scento_page } = await res.json();
console.log(lede, detail.pyramid, scento_page.url);

Ce que l’API renvoie

La réponse réelle de la première requête, abrégée : les longues listes sont coupées à leurs premières entrées. Toutes les réponses ont la même forme : une phrase d’accroche à citer (lede), un objet de détail, la page scento.com à lire ensuite, des lectures liées et une ligne de citation (cite). Les réponses sont en anglais.

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 sur Scento",
    "url": "https://www.scento.com/fr/perfumes/layton-parfums-de-marly"
  },
  "further_reading": [
    {
      "label": "Parfums de Marly sur Scento",
      "url": "https://www.scento.com/fr/brand/parfums-de-marly"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": null
}

Pourquoi vérifié

Des notes que vous pouvez citer sans vérifier

Les assistants et les applications inventent souvent des notes. Dans l’étude de Scento sur les moteurs de réponse, des notes absentes de la liste officielle d’un parfum figuraient dans 24 à 49 % des réponses, selon le moteur. Scento Perfume API prend l’autre voie : chaque pyramide remonte à la liste publiée par la maison ou par un revendeur agréé, de sorte qu’un produit, une appli ou un agent peut la citer plutôt que de deviner de mémoire.

Lire l’étude

Référence des endpoints

Tous les endpoints, depuis le fichier OpenAPI en ligne

Tableau généré à partir du document OpenAPI que l’API sert elle-même : il ne peut donc pas s’en écarter. Toutes les routes sont en GET ; les descriptions sont en anglais.

Endpoint	Renvoie	Paramètres
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

Chaque route accepte lang (en, de, fr, es, it, ro, el, hu, cs, pl) ; les réponses restent en anglais, les liens suivent lang. Les listes acceptent continuation.

OpenAPI 3.1 (JSON) · Carte du serveur MCP

API de notes olfactives

API de notes olfactives : pyramides et matières premières

Interrogez un parfum et obtenez ses notes de tête, de cœur et de fond telles que la maison ou un revendeur agréé les publie, avec sa famille, sa concentration, son caractère et les matières qui le définissent. Interrogez une note et obtenez une fiche du glossaire de plus de 400 matières premières.

GET /perfumes/{perfume} : la pyramide, la famille, le caractère et le port
GET /materials/{material} : origine, naturel ou synthétique, odeur, accords, alias comme l’ambroxide
GET /materials/match : les parfums construits sur les notes citées, par étage de la pyramide

Une matière première, en direct: GET /materials/ambroxan?lang=fr

/materials/ambroxan?lang=fr

{
  "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/fr/perfumes/pegasus-by-parfums-de-marly",
        "tier": "base"
      },
      {
        "name": "Galloway",
        "house": "Parfums de Marly",
        "page": "https://www.scento.com/fr/perfumes/galloway-parfums-de-marly",
        "tier": "base"
      },
      {
        "name": "Club de Nuit Milestone",
        "house": "Armaf",
        "page": "https://www.scento.com/fr/perfumes/club-de-nuit-milestone-armaf",
        "tier": "base"
      }
    ]
  },
  "scento_page": {
    "label": "Notes olfactives sur Scento",
    "url": "https://www.scento.com/fr/notes"
  },
  "further_reading": [
    {
      "label": "Pegasus sur Scento",
      "url": "https://www.scento.com/fr/perfumes/pegasus-by-parfums-de-marly"
    },
    {
      "label": "Galloway sur Scento",
      "url": "https://www.scento.com/fr/perfumes/galloway-parfums-de-marly"
    },
    {
      "label": "Club de Nuit Milestone sur Scento",
      "url": "https://www.scento.com/fr/perfumes/club-de-nuit-milestone-armaf"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": null
}

API de base de données de parfums

API de base de données de parfums : parfums, maisons, familles

Cherchez parmi plus de 1 400 parfums et 140 maisons, parcourez la carte des 14 familles propre à Scento, lisez le portrait d’une maison ou fouillez le journal Scento. C’est une base de données de parfums vérifiée, pas un scraping : les entrées viennent de listes publiées, et chaque réponse renvoie à la page correspondante de scento.com.

GET /search et /perfumes : trouver parfums, maisons et notes par leur nom
GET /houses/{house} et /families : portraits de maisons et carte des familles
GET /journal : chercher dans les articles, avec la page à lire ensuite

Une recherche, en direct: GET /search?q=oud&kind=perfume&lang=fr

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

{
  "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/fr/perfumes/oud-wood-tom-ford"
      },
      {
        "kind": "perfume",
        "name": "Oud for Greatness",
        "house": "Initio Parfums Prives",
        "family": "Spice Route",
        "page": "https://www.scento.com/fr/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/fr/perfumes/oud-satin-mood-by-maison-francis-kurkdjian"
      }
    ]
  },
  "scento_page": {
    "label": "Oud Wood sur Scento",
    "url": "https://www.scento.com/fr/perfumes/oud-wood-tom-ford"
  },
  "further_reading": [
    {
      "label": "Oud for Greatness sur Scento",
      "url": "https://www.scento.com/fr/perfumes/initio-parfums-prives-oud-for-greatness"
    },
    {
      "label": "Oud Satin Mood sur Scento",
      "url": "https://www.scento.com/fr/perfumes/oud-satin-mood-by-maison-francis-kurkdjian"
    },
    {
      "label": "Lattafa sur Scento",
      "url": "https://www.scento.com/fr/brand/lattafa"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": "cGVyZnVtZS1zZWFyY2h8MWhnb3J2M3wxMA"
}

API de parfums similaires

API de parfums similaires : des senteurs de même structure

Trouvez les parfums qui partagent les notes et la structure de celui que vous nommez, avec les notes communes et une ligne sur la différence. Comparez deux à quatre parfums côte à côte, ou composez une petite garde-robe à partir de ce que l’on aime et veut éviter. La similarité désigne ici des notes et une structure communes, pas l’affirmation qu’un parfum en est un autre.

GET /perfumes/{perfume}/neighbours : les structures les plus proches, notes communes et différence
GET /contrast : deux à quatre parfums côte à côte
GET /wardrobe : une petite garde-robe selon les coups de cœur et les rejets

Parfums voisins, en direct: GET /perfumes/layton/neighbours?lang=fr

/perfumes/layton/neighbours?lang=fr

{
  "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/fr/perfumes/layton-parfums-de-marly",
      "family": "Wood & Root"
    },
    "total": 668,
    "neighbours": [
      {
        "name": "Detour Noir",
        "house": "Al Haramain",
        "page": "https://www.scento.com/fr/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/fr/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/fr/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 sur Scento",
    "url": "https://www.scento.com/fr/perfumes/layton-parfums-de-marly"
  },
  "further_reading": [
    {
      "label": "Parfums sur Scento",
      "url": "https://www.scento.com/fr/perfumes"
    },
    {
      "label": "Byredo sur Scento",
      "url": "https://www.scento.com/fr/brand/byredo"
    },
    {
      "label": "Wild Rush sur Scento",
      "url": "https://www.scento.com/fr/perfumes/wild-rush-initio-parfums-prives"
    }
  ],
  "cite": "Scento Perfume API, scento.com",
  "continuation": "c2NlbnQtbmVpZ2hib3Vyc3wxdmM4bzU0fDg"
}

Pour qui

Où elle convient, et où elle ne convient pas

Il existe des catalogues de parfums plus vastes : des services qui annoncent de 100 000 à 240 000 fiches, avec clés API, quotas ou tarifs. Scento Perfume API est plus petite, volontairement. Elle échange l’étendue contre l’exactitude vérifiée et zéro friction : 1 400+ parfums, 140+ maisons et 400+ matières premières, chacun relié à une source publiée, derrière une API sans clé ni compte.

Elle ne contient ni prix, ni stocks, ni évaluations, ni avis de la communauté. Si vous avez besoin d’une très grande liste ou de données communautaires, choisissez un service conçu pour cela ; si vous avez besoin de notes dont vous pouvez répondre, ou d’un agent qui ne doit pas inventer de notes, commencez ici.

Voir la comparaison datée

Ailleurs

Aussi disponible sur

La même API, listée là où les développeurs la cherchent.

FAQ

Les questions des développeurs

Existe-t-il une API parfum gratuite ?

Oui. Scento Perfume API est gratuite, sans offre payante vers laquelle passer. C’est une API REST en lecture seule, décrite en OpenAPI 3.1 et dotée d’un serveur MCP, avec 1 400+ parfums, 140+ maisons et 400+ matières premières. Commencez par https://www.scento.com/api/perfume/v1/perfumes/layton.

Existe-t-il une API parfum sans clé API ?

Oui. Scento Perfume API n’exige ni clé, ni inscription, ni compte : les requêtes GET anonymes sont servies directement et le CORS est ouvert, on peut donc l’appeler depuis un navigateur comme depuis un serveur. Plusieurs services du secteur, dont certains des plus grands, demandent une clé ou un compte ; la comparaison datée indique lesquels.

Quelle est la meilleure API parfum pour les développeurs ?

Cela dépend de ce que vous construisez. Jugez selon ces critères : taille du catalogue ; champs dont vous avez besoin (notes, accords, tenue, prix, avis de la communauté) ; origine des données ; niveau de friction (clé, inscription, quota, tarifs) ; interface (REST, OpenAPI, MCP) ; conditions d’utilisation. Des catalogues plus vastes existent, avec clés et limites. La Perfume API de Scento convient quand des notes vérifiées et zéro friction comptent plus que l’étendue, par exemple pour une appli ou un agent IA qui ne doit pas inventer de notes. La page de comparaison met les options côte à côte.

Existe-t-il une API de notes olfactives ?

Oui. GET /perfumes/{perfume} renvoie les notes de tête, de cœur et de fond d’un parfum, et GET /materials/{material} explique une matière première : son origine, si elle est naturelle ou synthétique, son odeur et les parfums qui la montrent le mieux. Le glossaire couvre plus de 400 matières.

D’où viennent les notes ?

Chaque pyramide remonte à la liste publiée par la maison ou par un revendeur agréé. Rien n’est prédit ni complété à partir de votes de la communauté. C’est important, car les moteurs de réponse ajoutent souvent des notes qu’un parfum ne déclare pas : dans l’étude de Scento, ils l’ont fait dans 24 à 49 % des réponses, selon le moteur.

Existe-t-il une API de parfums similaires ?

Oui. GET /perfumes/{perfume}/neighbours renvoie les parfums qui partagent la structure de celui que vous nommez, avec les notes communes et ce qui les distingue, et GET /contrast met deux à quatre parfums côte à côte. La similarité désigne des notes et une structure communes.

Y a-t-il des limites de débit ou une licence ?

Il n’y a ni clé ni quota publié. Merci de mettre les réponses en cache et de garder un débit raisonnable ; les conditions interdisent de surcharger le service ou de le copier en bloc pour reconstituer une base concurrente. Les conditions sont sur https://www.scento.com/terms-of-service#perfume-api.

Fonctionne-t-elle avec les assistants IA ?

Oui, les mêmes réponses sont disponibles via un serveur MCP à l’adresse https://www.scento.com/mcp, avec douze outils en lecture seule pour Claude, ChatGPT, Cursor, VS Code et tout client MCP. Voir la page du Perfume MCP Server.