10ML Perfume Finder · för utvecklare

API för parfymrekommendationer och liknande parfymer

10ML:s API för parfymrekommendationer består av kostnadsfria GET-rutter utan API-nyckel. /similar rangordnar parfymer efter gemensamma noter och ackord och kan styra urvalet mot friskare, sötare eller mörkare dofter. /alternatives hämtar alternativ från andra parfymhus. Rekommendationer utifrån en persons smak kommer från verktyget recommend_perfumes på MCP-endpointen.

API för liknande parfymer

https://mcp.10ml.com/api/v1/similar

JSON via GET, OpenAPI 3.1. Gratis, ingen API-nyckel.

Alla åtta endpoints

API för liknande parfymer

GET /api/v1/similar?perfume= tar namnet på en parfym i indexet och returnerar de parfymer som ligger närmast. Varje resultat visar vilka doftnoter och ackord den har gemensamt och hur nära likheten är: very close (mycket nära), similar vibe (liknande känsla) eller same spirit (samma anda). Två av fjorton resultat visas, i förkortad form, från 21 oktober 2026.

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

Ange house= när ett namn kan syfta på flera saker, gender= för att begränsa till herrparfymer, damparfymer eller unisexparfymer, other_houses_only=true för att utesluta parfymhuset bakom parfymen du utgår från, samt limit= och cursor= för sidindelning.

Styr resultatet

steer= styr resultatet bort från parfymen du utgår från i en riktning: fresher (friskare), sweeter (sötare), darker (mörkare), lighter (lättare), longer_lasting (längre varaktighet) eller more_projection (större projektion). De två sista kräver en parfym som finns i indexet. Varje resultat anger riktningen i sin motivering.

curl "https://mcp.10ml.com/api/v1/similar?perfume=Creed+Aventus&steer=fresher&limit=2"
{
  "target": {
    "name": "Aventus",
    "house": "Creed"
  },
  "results": [
    {
      "perfume": {
        "name": "Club de Nuit Intense Man EDT",
        "house": "Armaf",
        "gender": "men",
        "family": "Fruity woody",
        "accords": ["citrus", "fruity", "smoky"]
      },
      "closeness": "very close",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "why": "shares pineapple, bergamot, apple, black currant; fresher than the starting point"
    },
    {
      "perfume": {
        "name": "Club de Nuit Intense Man Parfum",
        "house": "Armaf",
        "gender": "men",
        "family": "Fruity woody",
        "accords": ["fruity", "smoky", "woody"]
      },
      "closeness": "very close",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "why": "shares pineapple, bergamot, apple, black currant; fresher than the starting point"
    }
  ],
  "total": 1989,
  "source": "10ML Fragrance Index"
}

Liknande parfymer utifrån enbart doftnoter

Om parfymen inte finns i indexet kan du ange notes= och accords= i stället för ett namn. Resultatet rangordnar parfymerna i indexet utifrån den listan.

curl "https://mcp.10ml.com/api/v1/similar?notes=vanilla,saffron&limit=2"
{
  "target": {
    "name": "your notes",
    "notes": ["vanilla", "saffron"]
  },
  "results": [
    {
      "perfume": {
        "name": "Vanille & Ambre",
        "house": "Berdoues",
        "gender": "unisex",
        "family": "Vanilla amber",
        "accords": ["vanilla", "amber", "sweet"]
      },
      "closeness": "very close",
      "shared_notes": ["vanilla", "saffron"],
      "why": "shares vanilla, saffron"
    },
    {
      "perfume": {
        "name": "Liquid Brun",
        "house": "French Avenue",
        "gender": "unisex",
        "family": "Gourmand spicy",
        "accords": ["warm spicy", "sweet", "vanilla"]
      },
      "closeness": "very close",
      "shared_notes": [],
      "why": "a similar overall profile"
    }
  ],
  "total": 2612,
  "source": "10ML Fragrance Index"
}

Alternativ från andra parfymhus

GET /api/v1/alternatives?perfume= ger redaktörernas alternativ till en välkänd parfym, alltid från andra parfymhus, med en förklaring till varför varje doft ligger nära. closeness= begränsar resultatet till very close (mycket nära), similar vibe (liknande känsla) eller same spirit (samma anda).

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

Rekommendationer utifrån någons smak

Smakbaserade tips är ingen REST-route: de kommer från verktyget recommend_perfumes i MCP-servern. Det tar hänsyn till parfymer personen gillar eller ogillar, doftnoter personen gillar eller vill undvika samt kön, säsong, tillfälle, stil och familj, och förklarar varje tips. MCP-endpointen https://mcp.10ml.com/mcp svarar också på vanliga JSON-RPC POST-anrop, så all kod kan anropa den. Svaret nedan visar structuredContent i svaret, i kortad form.

curl -X POST https://mcp.10ml.com/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"recommend_perfumes","arguments":{"likes":["Dior Sauvage"],"avoided_notes":["patchouli"],"season":"summer","limit":2}}}'
{
  "total": 3916,
  "picks": [
    {
      "perfume": {
        "name": "L'Immensité",
        "house": "Louis Vuitton",
        "gender": "men",
        "family": "Aromatic aquatic",
        "accords": ["fresh", "aquatic", "amber"],
        "key_notes": ["sage", "labdanum", "ambroxan", "amber", "ginger"]
      },
      "why": "shares bergamot, labdanum, ambroxan with Sauvage Eau de Parfum; suits summer"
    },
    {
      "perfume": {
        "name": "Jean Lowe Immortel",
        "house": "Maison Alhambra",
        "gender": "men",
        "family": "Fresh aromatic",
        "accords": ["fresh", "aromatic", "woody"],
        "key_notes": []
      },
      "why": "suits summer"
    }
  ],
  "taste": {
    "liked_perfumes": ["Sauvage Eau de Parfum"],
    "liked_notes": [],
    "avoided_notes": ["patchouli"]
  },
  "source": "10ML Fragrance Index"
}

En assistent gör samma anrop åt dig: fråga Claude eller ChatGPT ”min signaturdoft är Dior Sauvage, vad härnäst?” när du har lagt till MCP-servern för parfym.

Filtrera efter doftnoter, säsong och tillfälle

GET /api/v1/perfumes listar parfymer efter notes_include, notes_exclude, accords, family, gender, season, occasion och style, samt fritext. Exemplet nedan visar parfymer som innehåller både bergamott och ambroxan.

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

Vilken route passar vilken fråga

FråganAnropet
Vilka parfymer liknar den här?GET /api/v1/similar?perfume=
Som den här, men friskare, sötare eller mörkare?GET /api/v1/similar?perfume=&steer=
Jag känner bara till doftnoterna.GET /api/v1/similar?notes=
Vilka alternativ finns från andra parfymhus?GET /api/v1/alternatives?perfume=
Parfymer med de här doftnoterna för den här säsongen?GET /api/v1/perfumes?notes_include=&season=
Vad passar med det personen gillar och undviker?MCP-verktyget recommend_perfumes

Indexet innehåller 6 000+ parfymer och 285 noter. Sidan om parfym-API:t dokumenterar alla endpoints, och guiden om Fragrantica API-alternativet går igenom de övriga data som utvecklare letar efter.

Frågor

Finns det ett API för parfymrekommendationer?

Ja. 10ML Fragrance Index API ger rekommendationer via tre kostnadsfria rutter: /similar för parfymer som liknar en du känner till, /alternatives för alternativ från andra parfymhus och /perfumes för filtrering efter noter, säsong och tillfälle. Rekommendationer utifrån en persons omtyckta och undvikna parfymer och noter kommer från verktyget recommend_perfumes på https://mcp.10ml.com/mcp. Ingen API-nyckel behövs.

Finns det ett API för parfymers likheter?

Ja: GET https://mcp.10ml.com/api/v1/similar?perfume=Creed+Aventus returnerar de närmaste parfymerna, var och en med de doftnoter och doftackord den delar och hur nära den ligger (very close, similar vibe eller same spirit). steer= flyttar resultatet mot fresher (friskare), sweeter (sötare), darker (mörkare), lighter (lättare), longer_lasting (längre varaktighet) eller more_projection (större projektion).

Hur mäts likheten?

Utifrån gemensamma doftnoter, doftackord och stil. Varje resultat visar vad parfymerna har gemensamt och hur nära de ligger. Det är en jämförelse av parfymerna i sig, inte ett betyg baserat på recensioner.

Kan jag få förslag på liknande parfymer om en parfym inte finns i indexet?

Ja. Skicka dess doftnoter och doftackord till /similar i stället för ett namn, till exempel notes=vanilla,saffron. Sedan rangordnas parfymerna i indexet utifrån den listan.

Kan jag få rekommendationer utifrån en användares smak via REST?

Inte via en REST-rutt i nuläget. Verktyget recommend_perfumes finns på MCP-endpointen, som även kan svara på en vanlig JSON-RPC POST, vilket exemplet ovan visar. REST-rutterna täcker liknande parfymer, alternativ och filter.

Är det gratis?

Ja. Du behöver ingen API-nyckel, inget konto och ingen registrering. Det finns ingen fast hastighetsbegränsning (se villkoren), så cacha det du hämtar, håll ett måttligt tempo och kontakta oss innan du gör många förfrågningar: contact@10ml.com.