Darmowe API perfum i API zapachów

W skrócie

Cena

Za darmo

Rejestracja

Brak. Bez klucza API, bez konta

Protokoły

MCP (Streamable HTTP) i REST, opisane w OpenAPI 3.1

Zakres

ponad 5400 perfum, 249 domów, 285 opisanych nut

Profile

Piramida zapachowa (nuty głowy, serca i bazy), akordy, rodzina, pory roku i okazje; 481 pełnych profili redakcyjnych dodaje trwałość, projekcję i perfumiarzy

Interfejs

15 narzędzi tylko do odczytu ze schematami wyjścia, 6 promptów, zasoby i uzupełnienia

Języki

10: angielski, niemiecki, francuski, hiszpański, włoski, rumuński, grecki, węgierski, czeski i polski

Dostępny w

oficjalnym MCP Registry, bibliotece konektorów Claude, npm i PyPI

Prywatność

Bez plików cookie, bez śledzenia, bez historii zapytań

REST API: szybki start

Zwykłe żądania GET, odpowiedź w JSON, otwarty CORS, bez klucza. Te same odpowiedzi co w narzędziach MCP. Wyszukaj jedne perfumy:

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

Odpowiedź (linki pominięte):

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

Endpointy

Osiem tylko do odczytu tras GET pod https://mcp.10ml.com/api/v1. Listy są dzielone na strony za pomocą limit i cursor; locale przełącza linki 10ml.com na inny język. Prawdziwe odpowiedzi, skrócone, z 21 października 2026.

Przykładowe żądania i odpowiedzi

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

Pełny schemat: https://mcp.10ml.com/openapi.json

API nut zapachowych

API nut zapachowych ma dwie trasy. GET /api/v1/notes/{note} opisuje dowolną z 285 nut w indeksie, w wielu pisowniach i językach (Bergamotte znajdzie bergamot). GET /api/v1/perfumes?notes_include= wylicza perfumy zbudowane wokół jednej lub kilku nut, od najwyraźniejszych, a notes_exclude pomija wskazane nuty. Zapytanie o perfumy z format=detailed zwraca ich piramidę zapachową: nuty głowy, serca i bazy.

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 podobnych perfum

API podobnych perfum porządkuje perfumy według wspólnych nut, akordów i stylu oraz podaje, co każde z nich łączy i jak blisko jest: „very close” = bardzo blisko, „similar vibe” = podobny klimat, „same spirit” = ten sam duch. GET /api/v1/similar?perfume= wychodzi od perfum z indeksu albo od nut i akordów, które podasz dla dowolnego innego zapachu; steer przesuwa wynik w stronę fresher, sweeter, darker, lighter, longer_lasting lub more_projection. GET /api/v1/alternatives?perfume= zwraca zamienniki wybrane przez redakcję dla znanych perfum, zawsze z innych domów.

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

Porównanie z innymi API perfum

Co każda usługa podaje na własnej stronie, odczytane 21 października 2026.

Rozmiary to liczby, które każda usługa podaje o sobie, i nie zostały sprawdzone przez 10ML; rozmiar 10ML to rozmiar jego własnego indeksu. Plany i limity się zmieniają, więc sprawdź usługę, zanim zaczniesz budować.

Użyj go z klienta MCP

Ten sam indeks jest też zdalnym serwerem MCP dla asystentów. Adres jest taki sam w każdym kliencie: https://mcp.10ml.com/mcp

• Claude (claude.ai i Claude Desktop)

  Otwórz „Customize”, potem „Connectors” i dodaj 10ML Perfume Finder z biblioteki albo wybierz „+ Add”, potem „Add custom connector”, i wklej adres URL.

  Otwórz w bibliotece Claude

• Claude Code

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

• ChatGPT

  W przeglądarce otwórz w ChatGPT „Plugins”, kliknij przycisk plus i wybierz „Add custom MCP server”: nazwij go 10ML Perfume Finder, wklej adres URL i wybierz brak uwierzytelniania.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose i Zed używają tego samego adresu. Strona serwera MCP perfum ma instalacje jednym kliknięciem i wszystkich klientów.

Przykładowe pytania

Prawdziwe odpowiedzi z 10ML Fragrance Index, 20 i 21 października 2026.

• Jak pachnie Baccarat Rouge 540?

  get_perfume

  Baccarat Rouge 540 od Maison Francis Kurkdjian (2015, woda perfumowana, unisex) to bursztynowo-kwiatowy zapach: promienny, lekki bursztyn o cukrowej, niemal waty cukrowej słodyczy, rozciągnięty nad mineralnymi drewnami. Głowa: szafran i jaśmin. Serce: drewno bursztynowe i ambra szara. Baza: żywica jodły i cedr. Najlepszy jesienią, zimą i wiosną, na wieczór i randkę.

• Co pachnie jak Creed Aventus?

  find_similar_perfumes

  Najbliżej jest Armaf Club de Nuit Intense Man Parfum („very close” = bardzo blisko: łączy go ananas, bergamotka, jabłko i czarna porzeczka). Armaf Club de Nuit Intense Man EDT i Nishane Hacivat mają ten sam klimat; Hacivat przez ananas, bergamotkę, jaśmin i paczuli.

• Jak pachnie bergamotka i co do niej pasuje?

  explain_note

  Bergamotka to nuta cytrusowa: musująca, lekko kwiatowa, z zieloną, herbacianą goryczką. Łączy się z lawendą, wetywerią, neroli, czarnym pieprzem, piżmem i cedrem.

Limity i uczciwe użycie

Jest za darmo, bez klucza API, konta czy limitu do pilnowania, a każdy endpoint jest tylko do odczytu. Może obowiązywać limit zapytań wynikający z uczciwego użycia (zobacz warunki), więc zadania zbiorcze wykonuj w umiarkowanym tempie i zapisuj pobrane dane w pamięci podręcznej: odpowiedzi REST mają nagłówek cache na pięć minut. Listy są dzielone na strony za pomocą limit i cursor. Bez plików cookie, bez śledzenia, bez historii zapytań.

WarunkiPrywatność

Podanie źródła

Pokazujesz te dane w aplikacji, na stronie lub w artykule? Podaj jako źródło 10ML Fragrance Index z linkiem do tej strony, a serwer nazwij 10ML Perfume Finder.

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

Jak wypada na tle innych

W naszym porównaniu na 40 pytaniach (20 października 2026) serwerów MCP perfum, które odpowiadają bez klucza, 10ML Perfume Finder zdobył 39 z 40, ScentVerdict 36, Parfum Bible 33, Perfume Picks 32 po zastosowaniu się do jego limitu zapytań, a Parfica 7. Większe indeksy wygrywają pod względem zakresu: ScentVerdict deklaruje ponad 31 000 perfum, Perfume Picks ponad 13 000, a ScentRev ponad 126 000, wobec 5406 w 10ML Fragrance Index. ScentRev, Noteboxd, Fragella i Fraganty wymagają klucza lub logowania i nie dało się ich ocenić.

Pełne wyniki i metoda

Najczęstsze pytania