### Additional routes to try Source: https://github.com/scento-com/perfume-api/blob/main/docs/getting-started.html A set of example curl commands for various endpoints: similar perfumes, contrast, materials, material match, edits, and journal search. Comma-separated values are accepted wherever a route expects a list. ```bash # Similar perfumes curl "https://www.scento.com/api/perfume/v1/perfumes/layton/neighbours" # Two perfumes side by side curl "https://www.scento.com/api/perfume/v1/contrast?perfumes=mojave-ghost,gypsy-water" # What a raw material is curl "https://www.scento.com/api/perfume/v1/materials/ambroxan" # Perfumes built on tobacco and vanilla in the base curl "https://www.scento.com/api/perfume/v1/materials/match?materials=tobacco,vanilla&tier=base" # An edit for an occasion, with French links curl "https://www.scento.com/api/perfume/v1/edits/summer-days?lang=fr" # Search the journal curl "https://www.scento.com/api/perfume/v1/journal?q=vetiver" ``` -------------------------------- ### Example response for GET /materials/{material} Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response trimmed: lists are cut to first two entries and long text shortened. Shows the `note-portrait` folio with fields like `lede`, `detail`, `scento_page`, and `further_reading`. ```json { "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" ], "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" ], "showcased_in": [ { "name": "Aventus", "house": "Creed", "page": "https://www.scento.com/perfumes/aventus-creed", "tier": "base" }, { "name": "Green Irish Tweed", "house": "Creed", "page": "https://www.scento.com/perfumes/green-irish-tweed-creed", "tier": "base" } ] }, "scento_page": { "label": "Ambroxan, the note", "url": "https://www.scento.com/note/ambroxan" }, "further_reading": [ { "label": "Aventus on Scento", "url": "https://www.scento.com/perfumes/aventus-creed" }, { "label": "Green Irish Tweed on Scento", "url": "https://www.scento.com/perfumes/green-irish-tweed-creed" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### Example response for GET /journal Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response, trimmed: lists are cut to their first two entries and long text is shortened. Shows the `folio`, `lede`, `detail`, `scento_page`, `further_reading`, `cite`, and `continuation` fields. ```json { "folio": "journal-search", "lede": "2 Scento journal articles cover “vetiver”; the closest is “Vetiver in Perfume 2026: The Smoky Green Note Explained”.", "detail": { "query": "vetiver", "total": 2, "articles": [ { "title": "Vetiver in Perfume 2026: The Smoky Green Note Explained", "summary": "Origins, scent differences and 2026 trends for vetiver in perfume — from citrusy Haitian to smoky Indonesian and how to choose them.", "url": "https://www.scento.com/blog/vetiver-in-perfume-smoky-green-note-explained" }, { "title": "Attar Making in South Asia: Key Ingredients", "summary": "Attar scent hinges on base oil, botanicals, and place — from sandalwood and rose/jasmine to mitti, vetiver, and slow deg-bhapka distillation.", "url": "https://www.scento.com/blog/attar-making-south-asia-key-ingredients" } ] }, "scento_page": { "label": "Vetiver in Perfume 2026: The Smoky Green Note Explained", "url": "https://www.scento.com/blog/vetiver-in-perfume-smoky-green-note-explained" }, "further_reading": [ { "label": "Attar Making in South Asia: Key Ingredients", "url": "https://www.scento.com/blog/attar-making-south-asia-key-ingredients" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### GET /search example response (JSON) Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Trimmed live response for the /search request. Lists are cut to their first two entries and long text is shortened. The response includes a `continuation` value for fetching the next part of the list. ```json { "folio": "perfume-search", "lede": "148 entries in Scento's verified perfume database match “oud”; showing 1–10.", "detail": { "query": "oud", "kind": "perfume", "total": 148, "matches": [ { "kind": "perfume", "name": "Oud Wood", "house": "Tom Ford", "family": "Spice Route", "page": "https://www.scento.com/perfumes/oud-wood-tom-ford" }, { "kind": "perfume", "name": "Oud for Greatness", "house": "Initio Parfums Prives", "family": "Spice Route", "page": "https://www.scento.com/perfumes/initio-parfums-prives-oud-for-greatness" } ] }, "scento_page": { "label": "Oud Wood on Scento", "url": "https://www.scento.com/perfumes/oud-wood-tom-ford" }, "further_reading": [ { "label": "Oud for Greatness on Scento", "url": "https://www.scento.com/perfumes/initio-parfums-prives-oud-for-greatness" }, { "label": "Oud Satin Mood on Scento", "url": "https://www.scento.com/perfumes/oud-satin-mood-by-maison-francis-kurkdjian" } ], "cite": "Scento Perfume API, scento.com", "continuation": "cGVyZnVtZS1zZWFyY2h8MWhnb3J2M3wxMA" } ``` -------------------------------- ### Example JSON response for GET /contrast Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Shows the trimmed live response for the contrast request. Lists are cut to their first two entries and long text is shortened. The response includes perfume details, shared materials, comparison axes, verdicts, and a scento page link. ```json { "folio": "perfume-contrast", "lede": "Mojave Ghost and Gypsy Water share sandalwood, but part ways on family.", "detail": { "perfumes": [ { "name": "Mojave Ghost", "house": "Byredo", "page": "https://www.scento.com/perfumes/mojave-ghost-byredo" }, { "name": "Gypsy Water", "house": "Byredo", "page": "https://www.scento.com/perfumes/gypsy-water-byredo" } ], "shared_materials": [ "Sandalwood" ], "axes": [ { "axis": "house", "values": [ "Byredo", "Byredo" ] }, { "axis": "family", "values": [ "Wood & Root", "Green Leaf / Amber & Resin" ] } ], "verdict": [ { "name": "Mojave Ghost", "suits": "Someone after something woody and musky, worn in spring, summer and autumn by day or evening." }, { "name": "Gypsy Water", "suits": "Someone after something warm and fresh, worn in spring, summer and autumn by day or evening." } ], "missing": [] }, "scento_page": { "label": "Mojave Ghost on Scento", "url": "https://www.scento.com/perfumes/mojave-ghost-byredo" }, "further_reading": [ { "label": "Gypsy Water on Scento", "url": "https://www.scento.com/perfumes/gypsy-water-byredo" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### Example response for GET /perfumes Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response trimmed: lists are cut to their first two entries and long text is shortened. Shows the perfume-search folio, a lede, detail with matches, a scento_page link, and a null continuation. ```json { "folio": "perfume-search", "lede": "1 entry in Scento's verified perfume database match “layton”.", "detail": { "query": "layton", "kind": "perfume", "total": 1, "matches": [ { "kind": "perfume", "name": "Layton", "house": "Parfums de Marly", "family": "Wood & Root", "page": "https://www.scento.com/perfumes/layton-parfums-de-marly" } ] }, "scento_page": { "label": "Layton on Scento", "url": "https://www.scento.com/perfumes/layton-parfums-de-marly" }, "further_reading": [], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### GET /families Example Response (JSON) Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md This is a trimmed example response from the GET /families endpoint. Lists are cut to their first two entries and long text is shortened. The response includes the family tree, a link to the Scento page, further reading, and citation information. ```json { "folio": "family-map", "lede": "Scento sorts perfume into 14 families, from Sunlit Citrus to Oud Court, each defined by the materials that lead the composition.", "detail": { "tree": [ { "id": "sunlit-citrus", "name": "Sunlit Citrus", "definition": "Led by citrus peel and zest: bright, sparkling, cologne-clean openings that read as light and quick.", "subfamilies": [ "Citrus" ], "perfumes": 158 }, { "id": "orchard-fruit", "name": "Orchard Fruit", "definition": "Fruit takes the lead, whether juicy, jammy or sun-ripe, from pear and peach to berries and tropical flesh.", "subfamilies": [ "Fruit" ], "perfumes": 117 } ] }, "scento_page": { "label": "Fragrance Families Explained 2026: The Complete Floral Woody Oriental and Fresh Guide", "url": "https://www.scento.com/blog/fragrance-families-explained-complete-floral-woody-oriental-fresh-guide" }, "further_reading": [ { "label": "Fragrance notes on Scento", "url": "https://www.scento.com/notes" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### Example response for GET /families/{family} Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response, trimmed: lists are cut to their first two entries and long text is shortened. Shows the family-map tool output with detail, scento_page, further_reading, and cite fields. ```json { "folio": "family-map", "lede": "Amber & Resin: Glowing amber accords, labdanum, benzoin, incense and myrrh: warm, golden, enveloping.", "detail": { "family": "Amber & Resin", "id": "amber-resin", "definition": "Glowing amber accords, labdanum, benzoin, incense and myrrh: warm, golden, enveloping.", "subfamilies": [ "Resin & incense", "Amber" ], "exemplars": [ { "name": "Grand Soir", "house": "Maison Francis Kurkdjian", "page": "https://www.scento.com/perfumes/grand-soir-maison-francis-kurkdjian" }, { "name": "Herod", "house": "Parfums de Marly", "page": "https://www.scento.com/perfumes/herod-parfums-de-marly" } ], "neighbouring_families": [ "Wood & Root", "Spice Route" ], "perfumes": 76 }, "scento_page": { "label": "Fragrance Families Explained 2026: The Complete Floral Woody Oriental and Fresh Guide", "url": "https://www.scento.com/blog/fragrance-families-explained-complete-floral-woody-oriental-fresh-guide" }, "further_reading": [ { "label": "Grand Soir on Scento", "url": "https://www.scento.com/perfumes/grand-soir-maison-francis-kurkdjian" }, { "label": "Herod on Scento", "url": "https://www.scento.com/perfumes/herod-parfums-de-marly" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### Get material details with JavaScript script Source: https://github.com/scento-com/perfume-api/blob/main/README.md Runs the JavaScript material example for 'bergamot'. Output includes the material's description and citation. ```console $ node examples/javascript/material.mjs bergamot Bergamot is a natural material from the citrus family: sparkling peel of a green-gold citrus, juicy and slightly floral, with a bitter edge that keeps it elegant. Page: https://www.scento.com/note/bergamot Cite: Scento Perfume API, scento.com ``` -------------------------------- ### Example JSON response for GET /lexicon/{term} Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response, trimmed: lists are cut to their first two entries and long text is shortened. Shows the structure with folio, lede, detail, scento_page, further_reading, cite, and continuation fields. ```json { "folio": "perfumery-lexicon", "lede": "Sillage: The trail a perfume leaves in the air behind the wearer, from the French word for the wake of a boat.", "detail": { "term": "Sillage", "meaning": "The trail a perfume leaves in the air behind the wearer, from the French word for the wake of a boat. Strong sillage is noticed by people you pass; soft sillage stays within arm...", "example_perfumes": [ { "name": "Oud Wood", "house": "Tom Ford", "page": "https://www.scento.com/perfumes/oud-wood-tom-ford" }, { "name": "Aventus", "house": "Creed", "page": "https://www.scento.com/perfumes/aventus-creed" } ], "related_terms": [ "Projection", "Longevity" ] }, "scento_page": { "label": "Longevity vs Sillage: Measuring Perfume Quality", "url": "https://www.scento.com/blog/longevity-vs-sillage-measuring-perfume-quality" }, "further_reading": [ { "label": "How Fragrance Concentration Affects Sillage", "url": "https://www.scento.com/blog/fragrance-concentration-affects-sillage" }, { "label": "How to Identify Fragrances with Long-Lasting Sillage", "url": "https://www.scento.com/blog/how-to-identify-fragrances-with-long-lasting-sillage" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### GET /families Example Request (curl) Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Use this curl command to request the fragrance family tree from the Scento Perfume API. The response is in JSON format and includes the full tree of scent families with definitions and subfamilies. ```sh curl "https://www.scento.com/api/perfume/v1/families" ``` -------------------------------- ### Example response for GET /edits/{occasion} Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response trimmed for brevity: lists are cut to their first two entries and long text is shortened. Shows the structure with `folio`, `lede`, `detail`, `scento_page`, `further_reading`, `cite`, and `continuation` fields. ```json { "folio": "occasion-edit", "lede": "For summer days, Silver Mountain Water by Creed, Thé Noir 29 by Le Labo and Noir 29 by Le Labo lead an edit of 8: bright and airy in the heat.", "detail": { "occasion": "summer-days", "gender_lean": null, "edit": [ { "name": "Silver Mountain Water", "house": "Creed", "page": "https://www.scento.com/perfumes/silver-mountain-water-creed", "family": "Sunlit Citrus", "why": "Fresh and citrusy with sea notes and sandalwood; bright and airy in the heat." }, { "name": "Thé Noir 29", "house": "Le Labo", "page": "https://www.scento.com/perfumes/the-noir-29-by-le-labo", "family": "Green Leaf", "why": "Fresh and citrusy with tea and bergamot; bright and airy in the heat." } ] }, "scento_page": { "label": "Summer days on Scento", "url": "https://www.scento.com/collections/summer-days" }, "further_reading": [ { "label": "Silver Mountain Water on Scento", "url": "https://www.scento.com/perfumes/silver-mountain-water-creed" }, { "label": "Thé Noir 29 on Scento", "url": "https://www.scento.com/perfumes/the-noir-29-by-le-labo" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### GET /lexicon/{term} Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Explains a perfumery term in plain language, with example perfumes and related terms. The MCP server answers the same question with the perfumery-lexicon tool. ```APIDOC ## GET /lexicon/{term} ### Description Explains a perfumery term in plain language, with example perfumes and related terms. The MCP server answers the same question with the `perfumery-lexicon` tool. ### Method GET ### Endpoint `/lexicon/{term}` ### Parameters #### Path Parameters - **term** (string) - Required - A perfumery term, for example sillage, chypre or edp-vs-edt. #### Query Parameters - **lang** (string) - Optional - Language of the scento.com links and labels. Answers stay in English. One of `en`, `de`, `fr`, `es`, `it`, `ro`, `el`, `hu`, `cs`, `pl`. Default `en`. ### Example request ```sh curl "https://www.scento.com/api/perfume/v1/lexicon/sillage" ``` ### Example response Live response, trimmed: lists are cut to their first two entries and long text is shortened. ```json { "folio": "perfumery-lexicon", "lede": "Sillage: The trail a perfume leaves in the air behind the wearer, from the French word for the wake of a boat.", "detail": { "term": "Sillage", "meaning": "The trail a perfume leaves in the air behind the wearer, from the French word for the wake of a boat. Strong sillage is noticed by people you pass; soft sillage stays within arm...", "example_perfumes": [ { "name": "Oud Wood", "house": "Tom Ford", "page": "https://www.scento.com/perfumes/oud-wood-tom-ford" }, { "name": "Aventus", "house": "Creed", "page": "https://www.scento.com/perfumes/aventus-creed" } ], "related_terms": [ "Projection", "Longevity" ] }, "scento_page": { "label": "Longevity vs Sillage: Measuring Perfume Quality", "url": "https://www.scento.com/blog/longevity-vs-sillage-measuring-perfume-quality" }, "further_reading": [ { "label": "How Fragrance Concentration Affects Sillage", "url": "https://www.scento.com/blog/fragrance-concentration-affects-sillage" }, { "label": "How to Identify Fragrances with Long-Lasting Sillage", "url": "https://www.scento.com/blog/how-to-identify-fragrances-with-long-lasting-sillage" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` ``` -------------------------------- ### GET /search example request (curl) Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Curl request for the /search endpoint. Searches perfumes, houses and notes by name, note or mood word. The `kind` parameter limits the result to one kind; here it is set to `perfume`. ```sh curl "https://www.scento.com/api/perfume/v1/search?q=oud&kind=perfume" ``` -------------------------------- ### Get perfume portrait with Python script Source: https://github.com/scento-com/perfume-api/blob/main/README.md Runs the Python portrait example for 'aventus-creed'. Output includes the perfume's family, notes, and citation. ```console $ python examples/python/portrait.py aventus-creed Aventus by Creed (2010, Erwin Creed and Jean-Christophe Hérault) belongs to Scento’s Orchard Fruit family: bergamot, blackcurrant, apple and pineapple open onto juniper, birch, patchouli and jasmine, settling on musk, oakmoss, ambergris and vanilla. Page: https://www.scento.com/perfumes/aventus-creed Cite: Scento Perfume API, scento.com top Bergamot, Blackcurrant, Apple, Pineapple heart Juniper, Birch, Patchouli, Jasmine base Musk, Oakmoss, Ambergris, Vanilla ``` -------------------------------- ### Example JSON response for GET /materials/match Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response, trimmed: lists are cut to their first two entries and long text is shortened. Shows the `folio`, `lede`, `detail` with query and perfumes, `scento_page`, `further_reading`, `cite`, and `continuation` fields. The `continuation` value is opaque and can be used to fetch the next part of a list. ```json { "folio": "material-match", "lede": "17 perfumes in Scento's verified perfume database contain tobacco and vanilla in the base, Naxos first.", "detail": { "query": { "materials": [ "Tobacco", "Vanilla" ], "tier": "base", "family": null }, "total": 17, "perfumes": [ { "name": "Naxos", "house": "Xerjoff", "page": "https://www.scento.com/brand/xerjoff", "family": "Velvet Sweet", "tier_hits": { "Tobacco": "base", "Vanilla": "base" } }, { "name": "Red Tobacco", "house": "Mancera", "page": "https://www.scento.com/perfumes/red-tobacco-mancera", "family": "Wood & Root", "tier_hits": { "Tobacco": "base", "Vanilla": "base" } } ] }, "scento_page": { "label": "Tobacco, the note", "url": "https://www.scento.com/note/tobacco" }, "further_reading": [ { "label": "Vanilla, the note", "url": "https://www.scento.com/note/vanilla" }, { "label": "Xerjoff on Scento", "url": "https://www.scento.com/brand/xerjoff" } ], "cite": "Scento Perfume API, scento.com", "continuation": "bWF0ZXJpYWwtbWF0Y2h8MWttYzdpNHwxMA" } ``` -------------------------------- ### Example response: GET /perfumes/{perfume} JSON Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response trimmed: lists are cut to first two entries and long text shortened. Returns perfume details including pyramid, character, wears, and scento links. Unknown names still return 200 with `found: false` and suggestions. ```json { "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 w...", "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" ], "heart": [ "Lavender", "Violet" ], "base": [ "Patchouli", "Vanilla" ] }, "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" ], "wears": { "seasons": [ "spring", "summer" ], "hours": [ "day", "evening" ] }, "signature_materials": [ "Patchouli", "Guaiac Wood" ] }, "scento_page": { "label": "Layton on Scento", "url": "https://www.scento.com/perfumes/layton-parfums-de-marly" }, "further_reading": [ { "label": "Parfums de Marly on Scento", "url": "https://www.scento.com/brand/parfums-de-marly" }, { "label": "Patchouli, the note", "url": "https://www.scento.com/note/patchouli" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### Example request: curl GET /perfumes/{perfume} Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Fetches a perfume's portrait by slug or name. The `perfume` path parameter accepts a slug or name, e.g., `layton`. Optional `lang` query parameter controls scento.com link language, default `en`. ```sh curl "https://www.scento.com/api/perfume/v1/perfumes/layton" ``` -------------------------------- ### Example JSON response for GET /wardrobe Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Shows the trimmed live response from the wardrobe endpoint. Lists are cut to their first two entries and long text is shortened. The response includes the `folio` field set to `wardrobe-composer`, the `detail` object with the wardrobe items, and `scento_page` and `further_reading` links. ```json { "folio": "wardrobe-composer", "lede": "Built around Layton and Aventus: Detour Noir for daytime, Club de Nuit Intense Man for evening, Legend Night for warm weather.", "detail": { "loves": [ "Layton", "Aventus" ], "unknown": [], "avoid": [], "wardrobe": [ { "role": "daytime", "name": "Detour Noir", "house": "Al Haramain", "page": "https://www.scento.com/perfumes", "why": "Shares bergamot and lavender with what you love; for daylight hours." }, { "role": "evening", "name": "Club de Nuit Intense Man", "house": "Armaf", "page": "https://www.scento.com/perfumes/club-de-nuit-intense-man-armaf", "why": "Shares apple and bergamot with what you love; for evenings." } ] }, "scento_page": { "label": "Perfumes on Scento", "url": "https://www.scento.com/perfumes" }, "further_reading": [ { "label": "Club de Nuit Intense Man on Scento", "url": "https://www.scento.com/perfumes/club-de-nuit-intense-man-armaf" }, { "label": "Montblanc on Scento", "url": "https://www.scento.com/brand/montblanc" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### curl request for GET /materials/match Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Example request to match perfumes by materials. Uses the `materials` query parameter with comma-separated values and the optional `tier` parameter set to `base`. The `materials` parameter is required and accepts one to four materials. ```sh curl "https://www.scento.com/api/perfume/v1/materials/match?materials=tobacco,vanilla&tier=base" ``` -------------------------------- ### Example response for house profile Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Live response trimmed: lists cut to first two entries, long text shortened. Shows house details, signatures, families spread, and further reading. ```json { "folio": "house-portrait", "lede": "Creed is a heritage perfume house from the United Kingdom, founded in 1760; its signatures include Aventus, Silver Mountain Water and Green Irish Tweed.", "detail": { "name": "Creed", "country": "United Kingdom", "founded": 1760, "type": "heritage", "style": "Long-established house known for refined fragrances built on fine natural materials.", "signatures": [ { "name": "Aventus", "house": "Creed", "page": "https://www.scento.com/perfumes/aventus-creed", "family": "Orchard Fruit" }, { "name": "Silver Mountain Water", "house": "Creed", "page": "https://www.scento.com/perfumes/silver-mountain-water-creed", "family": "Sunlit Citrus" } ], "families_spread": { "Orchard Fruit": 2, "Sunlit Citrus": 8, "Green Leaf": 5, "Wood & Root": 5, "Spice Route": 4, "Petal Garden": 3, "Powder Veil": 2, "White Bloom": 3, "Amber & Resin": 1, "Velvet Sweet": 1 }, "perfumes_in_database": 34 }, "scento_page": { "label": "Creed on Scento", "url": "https://www.scento.com/brand/creed" }, "further_reading": [ { "label": "Aventus on Scento", "url": "https://www.scento.com/perfumes/aventus-creed" }, { "label": "Silver Mountain Water on Scento", "url": "https://www.scento.com/perfumes/silver-mountain-water-creed" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` -------------------------------- ### GET /families Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Retrieves the complete tree of Scento's fragrance families, including definitions and subfamilies. Use the optional lang parameter to control the language of links and labels. ```APIDOC ## GET /families ### Description Explore fragrance families. Returns the whole tree of Scento's own scent families, each with its definition and subfamilies. The MCP server answers the same question with the `family-map` tool. ### Method GET ### Endpoint https://www.scento.com/api/perfume/v1/families ### Parameters #### Query Parameters - **lang** (string) - Optional - Language of the scento.com links and labels. Answers stay in English. One of `en`, `de`, `fr`, `es`, `it`, `ro`, `el`, `hu`, `cs`, `pl`. Default `en`. ### Request Example ```sh curl "https://www.scento.com/api/perfume/v1/families" ``` ### Response #### Success Response (200) - **folio** (string) - Identifier for the response, e.g., "family-map". - **lede** (string) - Brief description of the families. - **detail** (object) - Contains the tree of families. - **tree** (array) - List of family objects. - **id** (string) - Unique identifier for the family. - **name** (string) - Name of the family. - **definition** (string) - Description of the family. - **subfamilies** (array of strings) - Subfamily names. - **perfumes** (integer) - Number of perfumes in the family. - **scento_page** (object) - Link to related blog page. - **label** (string) - Title of the page. - **url** (string) - URL of the page. - **further_reading** (array) - Additional links. - **label** (string) - Link text. - **url** (string) - URL. - **cite** (string) - Citation information. - **continuation** (null) - Pagination token, null if no more. #### Response Example ```json { "folio": "family-map", "lede": "Scento sorts perfume into 14 families, from Sunlit Citrus to Oud Court, each defined by the materials that lead the composition.", "detail": { "tree": [ { "id": "sunlit-citrus", "name": "Sunlit Citrus", "definition": "Led by citrus peel and zest: bright, sparkling, cologne-clean openings that read as light and quick.", "subfamilies": ["Citrus"], "perfumes": 158 }, { "id": "orchard-fruit", "name": "Orchard Fruit", "definition": "Fruit takes the lead, whether juicy, jammy or sun-ripe, from pear and peach to berries and tropical flesh.", "subfamilies": ["Fruit"], "perfumes": 117 } ] }, "scento_page": { "label": "Fragrance Families Explained 2026: The Complete Floral Woody Oriental and Fresh Guide", "url": "https://www.scento.com/blog/fragrance-families-explained-complete-floral-woody-oriental-fresh-guide" }, "further_reading": [ { "label": "Fragrance notes on Scento", "url": "https://www.scento.com/notes" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` ``` -------------------------------- ### GET /contrast Source: https://github.com/scento-com/perfume-api/blob/main/docs/endpoints.md Compares two to four perfumes side by side, showing house, family, pyramid, shared materials, character, seasons, hours, year, and concentration. The MCP server answers the same question with the perfume-contrast tool. ```APIDOC ## [GET] /contrast ### Description Compare perfumes side by side. Puts two to four perfumes side by side: house, family, pyramid, shared materials, character, seasons, hours, year and concentration. The MCP server answers the same question with the `perfume-contrast` tool. ### Method GET ### Endpoint /contrast ### Parameters #### Query Parameters - **perfumes** (list of string, 2-4) - Required - Two to four perfume slugs or names, comma-separated. - **lang** (string) - Optional - Language of the scento.com links and labels. Answers stay in English. One of `en`, `de`, `fr`, `es`, `it`, `ro`, `el`, `hu`, `cs`, `pl`. Default `en`. ### Request Example ```sh curl "https://www.scento.com/api/perfume/v1/contrast?perfumes=mojave-ghost,gypsy-water" ``` ### Response #### Success Response (200) - **folio** (string) - Identifier for the response type. - **lede** (string) - Summary of the comparison. - **detail** (object) - Detailed comparison data. - **perfumes** (array) - List of compared perfumes with name, house, and page URL. - **shared_materials** (array of string) - Shared materials between perfumes. - **axes** (array of objects) - Comparison axes with axis name and values. - **verdict** (array of objects) - Suitability verdicts for each perfume. - **missing** (array) - Missing data placeholders. - **scento_page** (object) - Link to the first perfume on Scento. - **further_reading** (array of objects) - Additional links to Scento pages. - **cite** (string) - Citation string. - **continuation** (null or string) - Continuation token or null. #### Response Example ```json { "folio": "perfume-contrast", "lede": "Mojave Ghost and Gypsy Water share sandalwood, but part ways on family.", "detail": { "perfumes": [ { "name": "Mojave Ghost", "house": "Byredo", "page": "https://www.scento.com/perfumes/mojave-ghost-byredo" }, { "name": "Gypsy Water", "house": "Byredo", "page": "https://www.scento.com/perfumes/gypsy-water-byredo" } ], "shared_materials": [ "Sandalwood" ], "axes": [ { "axis": "house", "values": [ "Byredo", "Byredo" ] }, { "axis": "family", "values": [ "Wood & Root", "Green Leaf / Amber & Resin" ] } ], "verdict": [ { "name": "Mojave Ghost", "suits": "Someone after something woody and musky, worn in spring, summer and autumn by day or evening." }, { "name": "Gypsy Water", "suits": "Someone after something warm and fresh, worn in spring, summer and autumn by day or evening." } ], "missing": [] }, "scento_page": { "label": "Mojave Ghost on Scento", "url": "https://www.scento.com/perfumes/mojave-ghost-byredo" }, "further_reading": [ { "label": "Gypsy Water on Scento", "url": "https://www.scento.com/perfumes/gypsy-water-byredo" } ], "cite": "Scento Perfume API, scento.com", "continuation": null } ``` ``` -------------------------------- ### Fetch a perfume by slug with JavaScript fetch Source: https://github.com/scento-com/perfume-api/blob/main/docs/getting-started.html Works in Node 18 or newer and in the browser because CORS is open. The response includes lede, detail.pyramid, and scento_page.url. ```javascript const res = await fetch("https://www.scento.com/api/perfume/v1/perfumes/layton"); if (!res.ok) throw new Error(`HTTP ${res.status}`); const { lede, detail, scento_page } = await res.json(); console.log(lede); // one sentence you can quote console.log(detail.pyramid); // { top: [...], heart: [...], base: [...] } console.log(scento_page.url); // the page to read on at scento.com ``` -------------------------------- ### Search perfumes with Python script Source: https://github.com/scento-com/perfume-api/blob/main/README.md Runs the Python search example against the Scento API. Output shows 132 matches for 'oud', displaying the first 10 entries with material and perfume links. ```console $ python examples/python/search.py oud 132 entries in Scento's verified perfume database match “oud”; showing 1–10. - material Oud (Oud) https://www.scento.com/note/oud - perfume Oud Wood (Tom Ford) https://www.scento.com/perfumes/oud-wood-tom-ford - perfume Oud for Greatness (Initio Parfums Prives) https://www.scento.com/perfumes/initio-parfums-prives-oud-for-greatness ``` -------------------------------- ### Base URL for anonymous GET requests Source: https://github.com/scento-com/perfume-api/blob/main/docs/getting-started.html The base URL for the Perfume API. Anonymous GET requests to this URL are answered directly without any sign-up. ```text https://www.scento.com/api/perfume/v1 ```