API συστάσεων αρωμάτων και API παρόμοιων αρωμάτων

API παρόμοιων αρωμάτων

Το GET /api/v1/similar?perfume= παίρνει το όνομα ενός αρώματος του index και επιστρέφει τα αρώματα που του μοιάζουν περισσότερο. Κάθε αποτέλεσμα λέει ποιες νότες και συγχορδίες μοιράζεται και πόσο κοντά είναι: very close, similar vibe ή same spirit. Εδώ φαίνονται δύο αποτελέσματα από δεκατέσσερα, συντομευμένα, από τις 21 Οκτωβρίου 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"
}

Περάστε house= όταν ένα όνομα είναι διφορούμενο, gender= για να κρατήσετε αντρικά, γυναικεία ή unisex αρώματα, other_houses_only=true για να αποκλείσετε τον οίκο του αρχικού αρώματος, και limit= και cursor= για σελιδοποίηση.

Κατευθύνετε το αποτέλεσμα

Το steer= απομακρύνει το αποτέλεσμα από το αρχικό άρωμα προς μία κατεύθυνση: fresher, sweeter, darker, lighter, longer_lasting ή more_projection. Τα δύο τελευταία χρειάζονται άρωμα που υπάρχει στο index. Ο λόγος σε κάθε αποτέλεσμα ονομάζει την κατεύθυνση.

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

Παρόμοια αρώματα μόνο από νότες

Για ένα άρωμα που δεν υπάρχει στο index, περάστε τις notes= και accords= του αντί για όνομα. Το αποτέλεσμα ταξινομεί το index με βάση αυτή τη λίστα.

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

Εναλλακτικές από άλλους οίκους

Το GET /api/v1/alternatives?perfume= επιστρέφει τις εναλλακτικές των συντακτών για ένα γνωστό άρωμα, πάντα από άλλους οίκους, με τον λόγο που είναι κοντά. Το closeness= κρατά μόνο very close, similar vibe ή same spirit.

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

Συστάσεις από το γούστο ενός ανθρώπου

Οι επιλογές βάσει γούστου δεν είναι διαδρομή REST: προέρχονται από το εργαλείο recommend_perfumes του MCP server. Παίρνει τα αρώματα που κάποιος αγαπά ή αντιπαθεί, τις νότες που προτιμά ή αποφεύγει, και φύλο, εποχή, περίσταση, στυλ και οικογένεια, και εξηγεί τον λόγο για κάθε επιλογή. Το MCP endpoint https://mcp.10ml.com/mcp απαντά και σε ένα απλό JSON-RPC POST, άρα οποιοσδήποτε κώδικας μπορεί να το καλέσει. Η απάντηση παρακάτω είναι το structuredContent της απάντησης, συντομευμένο.

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

Ένας βοηθός κάνει την ίδια κλήση για εσάς: ρωτήστε το Claude ή το ChatGPT «το χαρακτηριστικό μου άρωμα είναι το Dior Sauvage, τι να δοκιμάσω μετά;» αφού προσθέσετε τον MCP server αρωμάτων.

Φιλτράρισμα ανά νότες, εποχή και περίσταση

Το GET /api/v1/perfumes απαριθμεί αρώματα με notes_include, notes_exclude, accords, family, gender, season, occasion και style, καθώς και ελεύθερο κείμενο. Το παράδειγμα παρακάτω κρατά αρώματα που έχουν και περγαμόντο και 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"
}

Ποια διαδρομή για ποια ερώτηση

Το index έχει 6.000+ αρώματα και 285 νότες. Η σελίδα του API αρωμάτων τεκμηριώνει κάθε endpoint, και ο οδηγός εναλλακτική του API Fragrantica χαρτογραφεί τα υπόλοιπα δεδομένα που ψάχνουν οι προγραμματιστές.

Συνεχίστε το διάβασμα

• API αρωμάτων
• Εναλλακτική του API Fragrantica
• MCP server αρωμάτων
• Τι είναι ένας MCP server αρωμάτων;
• Σύγκριση MCP server αρωμάτων

Ερωτήσεις