Gratis parfum API en geur API

In één oogopslag

Prijs

Gratis

Aanmelden

Niet nodig. Geen API-sleutel, geen account

Protocollen

MCP (Streamable HTTP) en REST, beschreven in OpenAPI 3.1

Dekking

5.400+ parfums, 249 huizen, 285 uitgelegde noten

Profielen

Geurpiramide (top-, hart- en basisnoten), accoorden, familie, seizoenen en gelegenheden; 481 volledige redactionele profielen voegen geurduur, projectie en parfumeurs toe

Interface

15 alleen-lezen tools met output schema’s, 6 prompts, resources en completions

Talen

10: Engels, Duits, Frans, Spaans, Italiaans, Roemeens, Grieks, Hongaars, Tsjechisch en Pools

Vermeld in

het officiële MCP Registry, de connectorgids van Claude, npm en PyPI

Privacy

Geen cookies, geen tracking, geen verzoekgeschiedenis

REST API: snel aan de slag

Gewone GET-verzoeken, JSON terug, open CORS, geen sleutel. Dezelfde antwoorden als de MCP-tools. Zoek één parfum op:

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

Antwoord (links weggelaten):

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

Acht alleen-lezen GET-routes onder https://mcp.10ml.com/api/v1. Lijsten worden gepagineerd met limit en cursor; locale zet de 10ml.com-links om naar een andere taal. Echte, ingekorte antwoorden van 21 oktober 2026.

Voorbeeldverzoeken en antwoorden

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

Volledig schema: https://mcp.10ml.com/openapi.json

Geurnoten API

De geurnoten API heeft twee routes. GET /api/v1/notes/{note} legt elk van de 285 noten in de index uit, in veel spellingen en talen (Bergamotte vindt bergamot). GET /api/v1/perfumes?notes_include= toont de parfums die rond een of meer noten zijn gebouwd, de meest nadrukkelijke eerst, en notes_exclude laat noten weg. Een parfum opzoeken met format=detailed geeft de geurpiramide terug: top-, hart- en basisnoten.

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 voor vergelijkbare parfums

De API voor vergelijkbare parfums rangschikt parfums op gedeelde noten, accoorden en stijl en zegt wat elk deelt en hoe dichtbij het is: „very close” = heel dichtbij, „similar vibe” = vergelijkbare sfeer, „same spirit” = dezelfde geest. GET /api/v1/similar?perfume= vertrekt vanuit een parfum in de index, of vanuit noten en accoorden die je meegeeft voor een andere geur; steer verschuift het resultaat naar fresher, sweeter, darker, lighter, longer_lasting of more_projection. GET /api/v1/alternatives?perfume= geeft de alternatieven van de redactie voor een bekend parfum, altijd van andere huizen.

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

Vergeleken met andere parfum-API’s

Wat elke dienst op de eigen site zegt, gelezen op 21 oktober 2026.

De omvang is het aantal dat elke dienst voor zichzelf claimt en is niet door 10ML gecontroleerd; die van 10ML is de omvang van de eigen index. Plannen en limieten veranderen, dus controleer de dienst voordat je bouwt.

Gebruik het vanuit een MCP-client

Dezelfde index is ook een externe MCP-server voor assistenten. Het adres is in elke client hetzelfde: https://mcp.10ml.com/mcp

• Claude (claude.ai en Claude Desktop)

  Open “Customize”, dan “Connectors”, en voeg 10ML Perfume Finder toe uit de gids, of kies “+ Add”, dan “Add custom connector”, en plak de URL.

  Openen in de gids van Claude

• Claude Code

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

• ChatGPT

  Open op het web in ChatGPT “Plugins”, kies de plusknop en dan “Add custom MCP server”: geef het de naam 10ML Perfume Finder, plak de URL en kies geen authenticatie.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose en Zed gebruiken hetzelfde adres. De pagina van de parfum MCP-server heeft de installaties met één klik en alle clients.

Voorbeeldvragen

Echte antwoorden uit de 10ML Fragrance Index, 20 en 21 oktober 2026.

• Hoe ruikt Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 van Maison Francis Kurkdjian (2015, eau de parfum, unisex) is een amberachtige bloemengeur: een stralende, luchtige amber met een gesuikerde, bijna suikerspinachtige zoetheid boven minerale houtsoorten. Topnoten: saffraan en jasmijn. Hartnoten: amberhout en grijze amber. Basisnoten: sparrenhars en ceder. Het beste in de herfst, winter en lente, voor de avond en een date.

• Wat ruikt zoals Creed Aventus?

  find_similar_perfumes

  Het dichtstbij komt Armaf Club de Nuit Intense Man Parfum („very close” = heel dichtbij: deelt ananas, bergamot, appel en zwarte bes). Armaf Club de Nuit Intense Man EDT en Nishane Hacivat hebben dezelfde sfeer; Hacivat via ananas, bergamot, jasmijn en patchoeli.

• Hoe ruikt bergamot en wat past erbij?

  explain_note

  Bergamot is een citrusnoot: sprankelend, licht bloemig, met een groene, theeachtige bitterheid. Het combineert met lavendel, vetiver, neroli, zwarte peper, musk en ceder.

Limieten en redelijk gebruik

Het is gratis, zonder API-sleutel, account of quotum om te beheren, en elk endpoint is alleen-lezen. Voor redelijk gebruik kan een limiet op het aantal verzoeken gelden (zie de voorwaarden): houd bulktaken dus op een beleefd tempo en cache wat je ophaalt, want REST-antwoorden hebben een cache-header van vijf minuten. Lijsten worden gepagineerd met limit en cursor. Geen cookies, geen tracking, geen verzoekgeschiedenis.

VoorwaardenPrivacy

Bronvermelding

Toon je de data in een app, op een site of in een artikel? Vermeld de 10ML Fragrance Index als bron met een link naar deze pagina en noem de server 10ML Perfume Finder.

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

Zo verhoudt het zich

In onze vergelijking met 40 vragen (20 oktober 2026) van de parfum MCP-servers die zonder sleutel antwoorden, scoorde 10ML Perfume Finder 39 van de 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 zodra de limiet werd gerespecteerd en Parfica 7. Grotere indexen winnen op omvang: ScentVerdict claimt 31.000+ parfums, Perfume Picks 13.000+ en ScentRev 126.000+, tegenover 5.406 in de 10ML Fragrance Index. ScentRev, Noteboxd, Fragella en Fraganty vragen een sleutel of inlog en konden niet worden gescoord.

Volledige resultaten en methode

Veelgestelde vragen